diff --git a/3.25.0/404.html b/3.25.0/404.html new file mode 100644 index 0000000000..41b6fb0c77 --- /dev/null +++ b/3.25.0/404.html @@ -0,0 +1,1451 @@ + + + + + + + + + + + + + + + + SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+ +

404 - Not found

+ +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/amqp/index.html b/3.25.0/amqp/amqp/index.html new file mode 100644 index 0000000000..961580118d --- /dev/null +++ b/3.25.0/amqp/amqp/index.html @@ -0,0 +1,1569 @@ + + + + + + + + + + + + + + + + + + AMQP 1.0 Connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

AMQP 1.0 Connector

+

The AMQP Connector adds support for AMQP 1.0 to Reactive Messaging.

+

Advanced Message Queuing Protocol 1.0 (AMQP 1.0) is an open standard for +passing business messages between applications or organizations.

+

With this connector, your application can:

+
    +
  • receive messages from an AMQP Broker or Router.
    • +
  • send Message to an AMQP address
    • +
+

The AMQP connector is based on the Vert.x AMQP Client.

+

Using the AMQP connector

+

To use the AMQP Connector, add the following dependency to your project:

+
1
+2
+3
+4
+5
<dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-amqp</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
+
+

The connector name is: smallrye-amqp.

+

So, to indicate that a channel is managed by this connector you need:

+
1
+2
+3
+4
+5
# Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-amqp
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-amqp
+
+
+
+

RabbitMQ

+

To use RabbitMQ, refer to Using RabbitMQ.

+
+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/client-customization/index.html b/3.25.0/amqp/client-customization/index.html new file mode 100644 index 0000000000..84e5823ec7 --- /dev/null +++ b/3.25.0/amqp/client-customization/index.html @@ -0,0 +1,1636 @@ + + + + + + + + + + + + + + + + + + Client Customization - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

Customizing the underlying AMQP client

+

You can customize the underlying AMQP Client configuration by +producing an instance of +AmqpClientOptions:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
@Produces
+@Identifier("my-options")
+public AmqpClientOptions getNamedOptions() {
+    // You can use the produced options to configure the TLS connection
+    PemKeyCertOptions keycert = new PemKeyCertOptions()
+            .addCertPath("./tls/tls.crt")
+            .addKeyPath("./tls/tls.key");
+    PemTrustOptions trust = new PemTrustOptions().addCertPath("./tlc/ca.crt");
+
+    return new AmqpClientOptions()
+            .setSsl(true)
+            .setPemKeyCertOptions(keycert)
+            .setPemTrustOptions(trust)
+            .addEnabledSaslMechanism("EXTERNAL")
+            .setHostnameVerificationAlgorithm("")
+            .setConnectTimeout(30000)
+            .setReconnectInterval(5000)
+            .setContainerId("my-container");
+}
+
+
+

This instance is retrieved and used to configure the client used by the +connector. You need to indicate the name of the client using the +client-options-name attribute:

+
1
mp.messaging.incoming.prices.client-options-name=my-named-options
+
+
+

Client capabilities

+

Both incoming and outgoing AMQP channels can be configured with a list +of capabilities to declare during sender and receiver connections with +the AMQP broker. Note that supported capability names are broker +specific.

+
1
+2
+3
mp.messaging.incoming.sink.capabilities=temporary-topic
+...
+mp.messaging.outgoing.source.capabilities=shared
+
+
+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/health/index.html b/3.25.0/amqp/health/index.html new file mode 100644 index 0000000000..dd136ac7ae --- /dev/null +++ b/3.25.0/amqp/health/index.html @@ -0,0 +1,1563 @@ + + + + + + + + + + + + + + + + + + Health Checks - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

Health reporting

+

The AMQP connector reports the startup, liveness, and readiness of each +inbound (Receiving messages) and outbound (sending messages) channel +managed by the connector:

+
    +
  • +

    Startup :: For both inbound and outbound, the startup probe reports OK when the +connection with the broker is established, and the AMQP senders and +receivers are opened (the links are attached to the broker).

    +
    • +
  • +

    Liveness :: For both inbound and outbound, the liveness check verifies that the +connection is established. The check still returns OK if the +connection got cut, but we are attempting a reconnection.

    +
    • +
  • +

    Readiness :: For the inbound, it checks that the connection is established and the +receiver is opened. Unlike the liveness check, this probe reports KO +until the connection is re-established. For the outbound, it checks that +the connection is established and the sender is opened. Unlike the +liveness check, this probe reports KO until the connection is +re-established.

    +
    • +
+
+

Note

+

To disable health reporting, set the health-enabled attribute for the +channel to false.

+
+

Note that a message processing failures nacks the message, which is +then handled by the failure-strategy. It is the responsibility of the +failure-strategy to report the failure and influence the outcome of +the checks. The fail failure strategy reports the failure, and so the +check will report the fault.

+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/rabbitmq/index.html b/3.25.0/amqp/rabbitmq/index.html new file mode 100644 index 0000000000..f47849b39d --- /dev/null +++ b/3.25.0/amqp/rabbitmq/index.html @@ -0,0 +1,1559 @@ + + + + + + + + + + + + + + + + + + Using RabbitMQ - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

Using RabbitMQ

+

This connector is for AMQP 1.0. RabbitMQ implements AMQP 0.9.1. RabbitMQ +does not provide AMQP 1.0 by default, but there is a plugin for it. To +use RabbitMQ with this connector, enable and configure the AMQP 1.0 +plugin.

+

Despite the plugin, a few features won’t work with RabbitMQ. Thus, we +recommend the following configurations.

+

To receive messages from RabbitMQ:

+
    +
  • Set durable to false
    • +
+
1
+2
mp.messaging.incoming.prices.connector=smallrye-amqp
+mp.messaging.incoming.prices.durable=false
+
+
+

To send messages to RabbitMQ:

+
    +
  • set the destination address (anonymous sender are not supported)
    • +
+
1
+2
mp.messaging.outgoing.generated-price.connector=smallrye-amqp
+mp.messaging.outgoing.generated-price.address=prices
+
+
+

It’s not possible to change the destination dynamically (using message +metadata) when using RabbitMQ. The connector automatically detects that +the broker does not support anonymous sender (See +http://docs.oasis-open.org/amqp/anonterm/v1.0/anonterm-v1.0.html).

+

Alternatively, you can use the RabbitMQ connector.

+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/receiving-amqp-messages/index.html b/3.25.0/amqp/receiving-amqp-messages/index.html new file mode 100644 index 0000000000..0e2d9840e2 --- /dev/null +++ b/3.25.0/amqp/receiving-amqp-messages/index.html @@ -0,0 +1,2255 @@ + + + + + + + + + + + + + + + + + + Receiving messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

Receiving messages from AMQP

+

The AMQP connector lets you retrieve messages from an AMQP broker or +router. The AMQP connector +retrieves AMQP Messages and maps each of them into Reactive Messaging +Messages.

+

Example

+

Let’s imagine you have an AMQP broker (such as Apache ActiveMQ +Artemis) running, and +accessible using the amqp:5672 address (by default it would use +localhost:5672). Configure your application to receive AMQP Messages +on the prices channel as follows:

+
1
+2
+3
+4
+5
+6
amqp-host=amqp # <1>
+amqp-port=5672 # <2>
+amqp-username=my-username # <3>
+amqp-password=my-password # <4>
+
+mp.messaging.incoming.prices.connector=smallrye-amqp # <5>
+
+
+
    +
  1. +

    Configures the broker/router host name. You can do it per channel + (using the host attribute) or globally using amqp-host

    +
    2. +
  2. +

    Configures the broker/router port. You can do it per channel (using + the port attribute) or globally using amqp-port. The default is + 5672.

    +
    3. +
  3. +

    Configures the broker/router username if required. You can do it per + channel (using the username attribute) or globally using + amqp-username.

    +
    4. +
  4. +

    Configures the broker/router password if required. You can do it per + channel (using the password attribute) or globally using + amqp-password.

    +
    5. +
  5. +

    Instructs the prices channel to be managed by the AMQP connector

    +
    6. +
+
+

Note

+

You don’t need to set the AMQP address. By default, it uses the +channel name (prices). You can configure the address attribute to +override it.

+
+

Then, your application receives Message<Double>. You can consume the +payload directly:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
package amqp.inbound;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class AmqpPriceConsumer {
+
+    @Incoming("prices")
+    public void consume(double price) {
+        // process your price.
+    }
+
+}
+
+
+

Or, you can retrieve the Message<Double>:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
package amqp.inbound;
+
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class AmqpPriceMessageConsumer {
+
+    @Incoming("prices")
+    public CompletionStage<Void> consume(Message<Double> price) {
+        // process your price.
+
+        // Acknowledge the incoming message, marking the AMQP message as `accepted`.
+        return price.ack();
+    }
+
+}
+
+
+

Deserialization

+

The connector converts incoming AMQP Messages into Reactive Messaging +Message<T> instances. T depends on the body of the received AMQP +Message.

+

The AMQP Type +System +defines the supported types.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
AMQP Body Type<T>
AMQP Value containing a AMQP Primitive Typethe corresponding Java type
AMQP Value using the Binary typebyte[]
AMQP SequenceList
AMQP Data (with binary content) and the content-type is set to application/jsonJsonObject
AMQP Data with a different content-typebyte[]
+

If you send objects with this AMQP connector (outbound connector), it +gets encoded as JSON and sent as binary. The content-type is set to +application/json. You can receive this payload using (Vert.x) JSON +Objects, and then map it to the object class you want:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
@ApplicationScoped
+public static class Generator {
+
+    @Outgoing("to-amqp")
+    public Multi<Price> prices() {                      // <1>
+        AtomicInteger count = new AtomicInteger();
+        return Multi.createFrom().ticks().every(Duration.ofMillis(1000))
+                .map(l -> new Price().setPrice(count.incrementAndGet()))
+                .onOverflow().drop();
+    }
+
+}
+
+@ApplicationScoped
+public static class Consumer {
+
+    List<Price> prices = new CopyOnWriteArrayList<>();
+
+    @Incoming("from-amqp")
+    public void consume(JsonObject p) {             // <2>
+        Price price = p.mapTo(Price.class);         // <3>
+        prices.add(price);
+    }
+
+    public List<Price> list() {
+        return prices;
+    }
+}
+
+
+
    +
  1. +

    The Price instances are automatically encoded to JSON by the + connector

    +
    2. +
  2. +

    You can receive it using a JsonObject

    +
    3. +
  3. +

    Then, you can reconstruct the instance using the mapTo method

    +
    4. +
+

Inbound Metadata

+

Messages coming from AMQP contains an instance of IncomingAmqpMetadata

+
1
+2
+3
+4
+5
+6
+7
+8
+9
Optional<IncomingAmqpMetadata> metadata = incoming.getMetadata(IncomingAmqpMetadata.class);
+metadata.ifPresent(meta -> {
+    String address = meta.getAddress();
+    String subject = meta.getSubject();
+    boolean durable = meta.isDurable();
+    // Use io.vertx.core.json.JsonObject
+    JsonObject properties = meta.getProperties();
+    // ...
+});
+
+
+

Acknowledgement

+

When a Reactive Messaging Message associated with an AMQP Message is +acknowledged, it informs the broker that the message has been +accepted.

+

Failure Management

+

If a message produced from an AMQP message is nacked, a failure +strategy is applied. The AMQP connector supports six strategies:

+
    +
  • +

    fail - fail the application; no more AMQP messages will be + processed (default). The AMQP message is marked as rejected.

    +
    • +
  • +

    accept - this strategy marks the AMQP message as accepted. The + processing continues ignoring the failure. Refer to the accepted + delivery state + documentation.

    +
    • +
  • +

    release - this strategy marks the AMQP message as released. The + processing continues with the next message. The broker can redeliver + the message. Refer to the released delivery state + documentation.

    +
    • +
  • +

    reject - this strategy marks the AMQP message as rejected. The + processing continues with the next message. Refer to the rejected + delivery state + documentation.

    +
    • +
  • +

    modified-failed - this strategy marks the AMQP message as + modified and indicates that it failed (with the delivery-failed + attribute). The processing continues with the next message, but the + broker may attempt to redeliver the message. Refer to the modified + delivery state + documentation

    +
    • +
  • +

    modified-failed-undeliverable-here - this strategy marks the AMQP + message as modified and indicates that it failed (with the + delivery-failed attribute). It also indicates that the application + cannot process the message, meaning that the broker will not attempt + to redeliver the message to this node. The processing continues with + the next message. Refer to the modified delivery state + documentation

    +
    • +
+

Configuration Reference

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Attribute (alias)DescriptionTypeMandatoryDefault
addressThe AMQP address. If not set, the channel name is usedstringfalse
auto-acknowledgementWhether the received AMQP messages must be acknowledged when receivedbooleanfalsefalse
broadcastWhether the received AMQP messages must be dispatched to multiple subscribersbooleanfalsefalse
capabilitiesA comma-separated list of capabilities proposed by the sender or receiver client.stringfalse
client-options-name (amqp-client-options-name)The name of the AMQP Client Option bean used to customize the AMQP client configurationstringfalse
cloud-eventsEnables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing, the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata.booleanfalsetrue
connect-timeout (amqp-connect-timeout)The connection timeout in millisecondsintfalse1000
container-idThe AMQP container idstringfalse
durableWhether AMQP subscription is durablebooleanfalsefalse
failure-strategySpecify the failure strategy to apply when a message produced from an AMQP message is nacked. Accepted values are fail (default), accept, release, reject, modified-failed, modified-failed-undeliverable-herestringfalsefail
health-timeoutThe max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed.intfalse3
host (amqp-host)The broker hostnamestringfalselocalhost
link-nameThe name of the link. If not set, the channel name is used.stringfalse
password (amqp-password)The password used to authenticate to the brokerstringfalse
port (amqp-port)The broker portintfalse5672
reconnect-attempts (amqp-reconnect-attempts)The number of reconnection attemptsintfalse100
reconnect-interval (amqp-reconnect-interval)The interval in second between two reconnection attemptsintfalse10
selectorSets a message selector. This attribute is used to define an apache.org:selector-filter:string filter on the source terminus, using SQL-based syntax to request the server filters which messages are delivered to the receiver (if supported by the server in question). Precise functionality supported and syntax needed can vary depending on the server.stringfalse
sni-server-name (amqp-sni-server-name)If set, explicitly override the hostname to use for the TLS SNI server namestringfalse
tracing-enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
use-ssl (amqp-use-ssl)Whether the AMQP connection uses SSL/TLSbooleanfalsefalse
username (amqp-username)The username used to authenticate to the brokerstringfalse
virtual-host (amqp-virtual-host)If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use)stringfalse
+

You can also pass any property supported by the Vert.x AMQP +client as attribute.

+

To use an existing address or queue, you need to configure the +address, container-id and, optionally, the link-name attributes. +For example, if you have an Apache Artemis broker configured with:

+
1
+2
+3
+4
+5
+6
+7
<queues>
+    <queue name="people">
+        <address>people</address>
+        <durable>true</durable>
+        <user>artemis</user>
+    </queue>
+</queues>
+
+
+

You need the following configuration:

+
1
+2
+3
+4
mp.messaging.incoming.people.connector=smallrye-amqp
+mp.messaging.incoming.people.durable=true
+mp.messaging.incoming.people.address=people
+mp.messaging.incoming.people.container-id=people
+
+
+

You may need to configure the link-name attribute, if the queue name +is not the channel name:

+
1
+2
+3
+4
+5
mp.messaging.incoming.people-in.connector=smallrye-amqp
+mp.messaging.incoming.people-in.durable=true
+mp.messaging.incoming.people-in.address=people
+mp.messaging.incoming.people-in.container-id=people
+mp.messaging.incoming.people-in.link-name=people
+
+
+

Receiving Cloud Events

+

The AMQP connector supports Cloud Events. +When the connector detects a structured or binary Cloud Events, it +adds a IncomingCloudEventMetadata +into the metadata of the Message. IncomingCloudEventMetadata +contains accessors to the mandatory and optional Cloud Event attributes.

+

If the connector cannot extract the Cloud Event metadata, it sends the +Message without the metadata.

+

Binary Cloud Events

+

For binary Cloud Events, all mandatory Cloud Event attributes must +be set in the AMQP application properties, prefixed by cloudEvents: +(as mandated by the protocol +binding). +The connector considers headers starting with the cloudEvents: prefix +but not listed in the specification as extensions. You can access them +using the getExtension method from IncomingCloudEventMetadata.

+

The datacontenttype attribute is mapped to the content-type header +of the record.

+

Structured Cloud Events

+

For structured Cloud Events, the event is encoded in the record’s +value. Only JSON is supported, so your event must be encoded as JSON in +the record’s value.

+

Structured Cloud Event must set the content-type header of the record +to application/cloudevents+json; charset=UTF-8. The message body must +be a valid JSON object containing at least all the mandatory Cloud +Events attributes.

+

If the record is a structured Cloud Event, the created Message’s payload +is the Cloud Event data.

+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/amqp/sending-amqp-messages/index.html b/3.25.0/amqp/sending-amqp-messages/index.html new file mode 100644 index 0000000000..855265ecfc --- /dev/null +++ b/3.25.0/amqp/sending-amqp-messages/index.html @@ -0,0 +1,2403 @@ + + + + + + + + + + + + + + + + + + Sending messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + Skip to content + + +
+
+ +
+ + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + +
+
+ + + + + + + +

Sending messages to AMQP

+

The AMQP connector can write Reactive Messaging Messages as AMQP +Messages.

+

Example

+

Let’s imagine you have an AMQP broker (such as Apache ActiveMQ +Artemis) running, and +accessible using the amqp:5672 address (by default it would use +localhost:5672). Configure your application to send the messages from +the prices channel as AMQP Message as follows:

+

1
+2
+3
+4
+5
+6
amqp-host=amqp  # <1>
+amqp-port=5672  # <2>
+amqp-username=my-username # <3>
+amqp-password=my-password # <4>
+
+mp.messaging.outgoing.prices.connector=smallrye-amqp # <5>
+
+
+1. Configures the broker/router host name. You can do it per channel + (using the host attribute) or globally using amqp-host

+
    +
  1. +

    Configures the broker/router port. You can do it per channel (using + the port attribute) or globally using amqp-port. The default is + 5672.

    +
    2. +
  2. +

    Configures the broker/router username if required. You can do it per + channel (using the username attribute) or globally using + amqp-username.

    +
    3. +
  3. +

    Configures the broker/router password if required. You can do it per + channel (using the password attribute) or globally using + amqp-password.

    +
    4. +
  4. +

    Instructs the prices channel to be managed by the AMQP connector

    +
    5. +
+
+

Note

+

You don’t need to set the address. By default, it uses the channel +name (prices). You can configure the address attribute to override +it.

+
+

Then, your application must send Message<Double> to the prices +channel. It can use double payloads as in the following snippet:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
package amqp.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class AmqpPriceProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Double> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble());
+    }
+
+}
+
+
+

Or, you can send Message<Double>:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
package amqp.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class AmqpPriceMessageProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Message<Double>> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> Message.of(random.nextDouble()));
+    }
+
+}
+
+
+

Serialization

+

When receiving a Message<T>, the connector convert the message into an +AMQP Message. The payload is converted to the AMQP Message body.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TAMQP Message Body
primitive types or StringAMQP Value with the payload
Instant or UUIDAMQP Value using the corresponding AMQP Type
JsonObject or JsonArrayAMQP Data using a binary content. The content-type is set to application/json
io.vertx.mutiny.core.buffer.BufferAMQP Data using a binary content. No content-type set
Any other classThe payload is converted to JSON (using a Json Mapper). The result is wrapped into AMQP Data using a binary content. The content-type is set to application/json
+

If the message payload cannot be serialized to JSON, the message is +nacked.

+

Outbound Metadata

+

When sending Messages, you can add an instance of +OutgoingAmqpMetadata +to influence how the message is going to be sent to AMQP. For example, you +can configure the subjects, properties:

+
1
+2
+3
+4
+5
+6
+7
+8
OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata.builder()
+        .withDurable(true)
+        .withSubject("my-subject")
+        .build();
+
+// Create a new message from the `incoming` message
+// Add `metadata` to the metadata from the `incoming` message.
+return incoming.addMetadata(metadata);
+
+
+

Dynamic address names

+

Sometimes it is desirable to select the destination of a message +dynamically. In this case, you should not configure the address inside +your application configuration file, but instead, use the outbound +metadata to set the address.

+

For example, you can send to a dynamic address based on the incoming +message:

+
1
+2
+3
+4
+5
+6
+7
+8
+9
String addressName = selectAddressFromIncommingMessage(incoming);
+OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata.builder()
+        .withAddress(addressName)
+        .withDurable(true)
+        .build();
+
+// Create a new message from the `incoming` message
+// Add `metadata` to the metadata from the `incoming` message.
+return incoming.addMetadata(metadata);
+
+
+
+

Note

+

To be able to set the address per message, the connector is using an +anonymous sender.

+
+

Acknowledgement

+

By default, the Reactive Messaging Message is acknowledged when the +broker acknowledged the message. When using routers, this +acknowledgement may not be enabled. In this case, configure the +auto-acknowledgement attribute to acknowledge the message as soon as +it has been sent to the router.

+

If an AMQP message is rejected/released/modified by the broker (or +cannot be sent successfully), the message is nacked.

+

Back Pressure and Credits

+

The back-pressure is handled by AMQP credits. The outbound connector +only requests the amount of allowed credits. When the amount of credits +reaches 0, it waits (in a non-blocking fashion) until the broker grants +more credits to the AMQP sender.

+

Configuration Reference

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Attribute (alias)DescriptionTypeMandatoryDefault
addressThe AMQP address. If not set, the channel name is usedstringfalse
capabilitiesA comma-separated list of capabilities proposed by the sender or receiver client.stringfalse
client-options-name (amqp-client-options-name)The name of the AMQP Client Option bean used to customize the AMQP client configurationstringfalse
cloud-eventsEnables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing, the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata.booleanfalsetrue
cloud-events-data-content-type (cloud-events-default-data-content-type)Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the datacontenttype attribute itselfstringfalse
cloud-events-data-schema (cloud-events-default-data-schema)Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the dataschema attribute itselfstringfalse
cloud-events-insert-timestamp (cloud-events-default-timestamp)Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the time attribute itselfbooleanfalsetrue
cloud-events-modeThe Cloud Event mode (structured or binary (default)). Indicates how are written the cloud events in the outgoing recordstringfalsebinary
cloud-events-source (cloud-events-default-source)Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the source attribute itselfstringfalse
cloud-events-subject (cloud-events-default-subject)Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the subject attribute itselfstringfalse
cloud-events-type (cloud-events-default-type)Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the type attribute itselfstringfalse
connect-timeout (amqp-connect-timeout)The connection timeout in millisecondsintfalse1000
container-idThe AMQP container idstringfalse
credit-retrieval-periodThe period (in milliseconds) between two attempts to retrieve the credits granted by the broker. This time is used when the sender run out of credits.intfalse2000
durableWhether sent AMQP messages are marked durablebooleanfalsefalse
health-timeoutThe max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed.intfalse3
host (amqp-host)The broker hostnamestringfalselocalhost
link-nameThe name of the link. If not set, the channel name is used.stringfalse
mergeWhether the connector should allow multiple upstreamsbooleanfalsefalse
password (amqp-password)The password used to authenticate to the brokerstringfalse
port (amqp-port)The broker portintfalse5672
reconnect-attempts (amqp-reconnect-attempts)The number of reconnection attemptsintfalse100
reconnect-interval (amqp-reconnect-interval)The interval in second between two reconnection attemptsintfalse10
sni-server-name (amqp-sni-server-name)If set, explicitly override the hostname to use for the TLS SNI server namestringfalse
tracing-enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
ttlThe time-to-live of the send AMQP messages. 0 to disable the TTLlongfalse0
use-anonymous-senderWhether or not the connector should use an anonymous sender. Default value is true if the broker supports it, false otherwise. If not supported, it is not possible to dynamically change the destination address.booleanfalse
use-ssl (amqp-use-ssl)Whether the AMQP connection uses SSL/TLSbooleanfalsefalse
username (amqp-username)The username used to authenticate to the brokerstringfalse
virtual-host (amqp-virtual-host)If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use)stringfalse
+

You can also pass any property supported by the Vert.x AMQP +client as attribute.

+

Using existing destinations

+

To use an existing address or queue, you need to configure the +address, container-id and, optionally, the link-name attributes. +For example, if you have an Apache Artemis broker configured with:

+
1
+2
+3
+4
+5
+6
+7
<queues>
+    <queue name="people">
+        <address>people</address>
+        <durable>true</durable>
+        <user>artemis</user>
+    </queue>
+</queues>
+
+
+

You need the following configuration:

+
1
+2
+3
+4
mp.messaging.outgoing.people.connector=smallrye-amqp
+mp.messaging.outgoing.people.durable=true
+mp.messaging.outgoing.people.address=people
+mp.messaging.outgoing.people.container-id=people
+
+
+

You may need to configure the link-name attribute, if the queue name +is not the channel name:

+
1
+2
+3
+4
+5
mp.messaging.outgoing.people-out.connector=smallrye-amqp
+mp.messaging.outgoing.people-out.durable=true
+mp.messaging.outgoing.people-out.address=people
+mp.messaging.outgoing.people-out.container-id=people
+mp.messaging.outgoing.people-out.link-name=people
+
+
+

To use a MULTICAST queue, you need to provide the FQQN +(Fully-qualified queue name) instead of just the name of the queue:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
mp.messaging.outgoing.people-out.connector=smallrye-amqp
+mp.messaging.outgoing.people-out.durable=true
+mp.messaging.outgoing.people-out.address=foo
+mp.messaging.outgoing.people-out.container-id=foo
+
+mp.messaging.incoming.people-out.connector=smallrye-amqp
+mp.messaging.incoming.people-out.durable=true
+mp.messaging.incoming.people-out.address=foo::bar # Note the syntax: address-name::queue-name
+mp.messaging.incoming.people-out.container-id=bar
+mp.messaging.incoming.people-out.link-name=people
+
+
+

More details about the AMQP Address model can be found on the Artemis +documentation.

+

Sending Cloud Events

+

The AMQP connector supports Cloud Events. The +connector sends the outbound record as Cloud Events if:

+
    +
  • +

    the message metadata contains an + io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata + instance,

    +
    • +
  • +

    the channel configuration defines the cloud-events-type and + cloud-events-source attributes.

    +
    • +
+

You can create +io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances +using:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
package amqp.outbound;
+
+import java.net.URI;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata;
+
+@ApplicationScoped
+public class AmqpCloudEventProcessor {
+
+    @Outgoing("cloud-events")
+    public Message<String> toCloudEvents(Message<String> in) {
+        return in.addMetadata(OutgoingCloudEventMetadata.builder()
+                .withId("id-" + in.getPayload())
+                .withType("greetings")
+                .withSource(URI.create("http://example.com"))
+                .withSubject("greeting-message")
+                .build());
+    }
+
+}
+
+
+

If the metadata does not contain an id, the connector generates one +(random UUID). The type and source can be configured per message or +at the channel level using the cloud-events-type and +cloud-events-source attributes. Other attributes are also +configurable.

+

The metadata can be contributed by multiple methods, however, you must +always retrieve the already existing metadata to avoid overriding the +values:

+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
package amqp.outbound;
+
+import java.net.URI;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata;
+
+@ApplicationScoped
+public class AmqpCloudEventMultipleProcessors {
+
+    @Incoming("source")
+    @Outgoing("processed")
+    public Message<String> process(Message<String> in) {
+        return in.addMetadata(OutgoingCloudEventMetadata.builder()
+                .withId("id-" + in.getPayload())
+                .withType("greeting")
+                .build());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Incoming("processed")
+    @Outgoing("cloud-events")
+    public Message<String> process2(Message<String> in) {
+        OutgoingCloudEventMetadata<String> metadata = in
+                .getMetadata(OutgoingCloudEventMetadata.class)
+                .orElseGet(() -> OutgoingCloudEventMetadata.builder().build());
+
+        return in.addMetadata(OutgoingCloudEventMetadata.from(metadata)
+                .withSource(URI.create("source://me"))
+                .withSubject("test")
+                .build());
+    }
+
+}
+
+
+

By default, the connector sends the Cloud Events using the binary +format. You can write structured Cloud Events by setting the +cloud-events-mode to structured. Only JSON is supported, so the +created records had its content-type header set to +application/cloudevents+json; charset=UTF-8

+
+

Note

+

you can disable the Cloud Event support by setting the cloud-events +attribute to false

+
+ + +
+
+
+ +
+ + + +
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/3.25.0/assets/images/favicon.png b/3.25.0/assets/images/favicon.png new file mode 100644 index 0000000000..1cf13b9f9d Binary files /dev/null and b/3.25.0/assets/images/favicon.png differ diff --git a/3.25.0/assets/javascripts/bundle.289a2a4b.min.js b/3.25.0/assets/javascripts/bundle.289a2a4b.min.js new file mode 100644 index 0000000000..9cb6f09e0e --- /dev/null +++ b/3.25.0/assets/javascripts/bundle.289a2a4b.min.js @@ -0,0 +1,29 @@ +(()=>{var Ai=Object.create;var Et=Object.defineProperty;var Ci=Object.getOwnPropertyDescriptor;var ki=Object.getOwnPropertyNames,Tt=Object.getOwnPropertySymbols,Hi=Object.getPrototypeOf,pr=Object.prototype.hasOwnProperty,zr=Object.prototype.propertyIsEnumerable;var Qr=(e,t,n)=>t in e?Et(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,$=(e,t)=>{for(var n in t||(t={}))pr.call(t,n)&&Qr(e,n,t[n]);if(Tt)for(var n of Tt(t))zr.call(t,n)&&Qr(e,n,t[n]);return e};var Ri=e=>Et(e,"__esModule",{value:!0});var qr=(e,t)=>{var n={};for(var r in e)pr.call(e,r)&&t.indexOf(r)<0&&(n[r]=e[r]);if(e!=null&&Tt)for(var r of Tt(e))t.indexOf(r)<0&&zr.call(e,r)&&(n[r]=e[r]);return n};var Ot=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Ii=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of ki(t))!pr.call(e,o)&&(n||o!=="default")&&Et(e,o,{get:()=>t[o],enumerable:!(r=Ci(t,o))||r.enumerable});return e},Be=(e,t)=>Ii(Ri(Et(e!=null?Ai(Hi(e)):{},"default",!t&&e&&e.__esModule?{get:()=>e.default,enumerable:!0}:{value:e,enumerable:!0})),e);var Yr=Ot((fr,Kr)=>{(function(e,t){typeof fr=="object"&&typeof Kr!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(fr,function(){"use strict";function e(n){var r=!0,o=!1,i=null,a={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function s(_){return!!(_&&_!==document&&_.nodeName!=="HTML"&&_.nodeName!=="BODY"&&"classList"in _&&"contains"in _.classList)}function c(_){var Ve=_.type,Ce=_.tagName;return!!(Ce==="INPUT"&&a[Ve]&&!_.readOnly||Ce==="TEXTAREA"&&!_.readOnly||_.isContentEditable)}function u(_){_.classList.contains("focus-visible")||(_.classList.add("focus-visible"),_.setAttribute("data-focus-visible-added",""))}function p(_){!_.hasAttribute("data-focus-visible-added")||(_.classList.remove("focus-visible"),_.removeAttribute("data-focus-visible-added"))}function m(_){_.metaKey||_.altKey||_.ctrlKey||(s(n.activeElement)&&u(n.activeElement),r=!0)}function l(_){r=!1}function h(_){!s(_.target)||(r||c(_.target))&&u(_.target)}function d(_){!s(_.target)||(_.target.classList.contains("focus-visible")||_.target.hasAttribute("data-focus-visible-added"))&&(o=!0,window.clearTimeout(i),i=window.setTimeout(function(){o=!1},100),p(_.target))}function v(_){document.visibilityState==="hidden"&&(o&&(r=!0),N())}function N(){document.addEventListener("mousemove",W),document.addEventListener("mousedown",W),document.addEventListener("mouseup",W),document.addEventListener("pointermove",W),document.addEventListener("pointerdown",W),document.addEventListener("pointerup",W),document.addEventListener("touchmove",W),document.addEventListener("touchstart",W),document.addEventListener("touchend",W)}function J(){document.removeEventListener("mousemove",W),document.removeEventListener("mousedown",W),document.removeEventListener("mouseup",W),document.removeEventListener("pointermove",W),document.removeEventListener("pointerdown",W),document.removeEventListener("pointerup",W),document.removeEventListener("touchmove",W),document.removeEventListener("touchstart",W),document.removeEventListener("touchend",W)}function W(_){_.target.nodeName&&_.target.nodeName.toLowerCase()==="html"||(r=!1,J())}document.addEventListener("keydown",m,!0),document.addEventListener("mousedown",l,!0),document.addEventListener("pointerdown",l,!0),document.addEventListener("touchstart",l,!0),document.addEventListener("visibilitychange",v,!0),N(),n.addEventListener("focus",h,!0),n.addEventListener("blur",d,!0),n.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&n.host?n.host.setAttribute("data-js-focus-visible",""):n.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(n){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var bn=Ot((Va,Lt)=>{/*! ***************************************************************************** +Copyright (c) Microsoft Corporation. + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, +INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR +OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +PERFORMANCE OF THIS SOFTWARE. +***************************************************************************** */var Br,Jr,Gr,Xr,Zr,en,tn,rn,nn,_t,lr,on,an,sn,Je,cn,un,pn,fn,ln,mn,dn,hn,Mt;(function(e){var t=typeof global=="object"?global:typeof self=="object"?self:typeof this=="object"?this:{};typeof define=="function"&&define.amd?define("tslib",["exports"],function(r){e(n(t,n(r)))}):typeof Lt=="object"&&typeof Lt.exports=="object"?e(n(t,n(Lt.exports))):e(n(t));function n(r,o){return r!==t&&(typeof Object.create=="function"?Object.defineProperty(r,"__esModule",{value:!0}):r.__esModule=!0),function(i,a){return r[i]=o?o(i,a):a}}})(function(e){var t=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var i in o)Object.prototype.hasOwnProperty.call(o,i)&&(r[i]=o[i])};Br=function(r,o){if(typeof o!="function"&&o!==null)throw new TypeError("Class extends value "+String(o)+" is not a constructor or null");t(r,o);function i(){this.constructor=r}r.prototype=o===null?Object.create(o):(i.prototype=o.prototype,new i)},Jr=Object.assign||function(r){for(var o,i=1,a=arguments.length;i=0;p--)(u=r[p])&&(c=(s<3?u(c):s>3?u(o,i,c):u(o,i))||c);return s>3&&c&&Object.defineProperty(o,i,c),c},Zr=function(r,o){return function(i,a){o(i,a,r)}},en=function(r,o){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(r,o)},tn=function(r,o,i,a){function s(c){return c instanceof i?c:new i(function(u){u(c)})}return new(i||(i=Promise))(function(c,u){function p(h){try{l(a.next(h))}catch(d){u(d)}}function m(h){try{l(a.throw(h))}catch(d){u(d)}}function l(h){h.done?c(h.value):s(h.value).then(p,m)}l((a=a.apply(r,o||[])).next())})},rn=function(r,o){var i={label:0,sent:function(){if(c[0]&1)throw c[1];return c[1]},trys:[],ops:[]},a,s,c,u;return u={next:p(0),throw:p(1),return:p(2)},typeof Symbol=="function"&&(u[Symbol.iterator]=function(){return this}),u;function p(l){return function(h){return m([l,h])}}function m(l){if(a)throw new TypeError("Generator is already executing.");for(;i;)try{if(a=1,s&&(c=l[0]&2?s.return:l[0]?s.throw||((c=s.return)&&c.call(s),0):s.next)&&!(c=c.call(s,l[1])).done)return c;switch(s=0,c&&(l=[l[0]&2,c.value]),l[0]){case 0:case 1:c=l;break;case 4:return i.label++,{value:l[1],done:!1};case 5:i.label++,s=l[1],l=[0];continue;case 7:l=i.ops.pop(),i.trys.pop();continue;default:if(c=i.trys,!(c=c.length>0&&c[c.length-1])&&(l[0]===6||l[0]===2)){i=0;continue}if(l[0]===3&&(!c||l[1]>c[0]&&l[1]=r.length&&(r=void 0),{value:r&&r[a++],done:!r}}};throw new TypeError(o?"Object is not iterable.":"Symbol.iterator is not defined.")},lr=function(r,o){var i=typeof Symbol=="function"&&r[Symbol.iterator];if(!i)return r;var a=i.call(r),s,c=[],u;try{for(;(o===void 0||o-- >0)&&!(s=a.next()).done;)c.push(s.value)}catch(p){u={error:p}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(u)throw u.error}}return c},on=function(){for(var r=[],o=0;o1||p(v,N)})})}function p(v,N){try{m(a[v](N))}catch(J){d(c[0][3],J)}}function m(v){v.value instanceof Je?Promise.resolve(v.value.v).then(l,h):d(c[0][2],v)}function l(v){p("next",v)}function h(v){p("throw",v)}function d(v,N){v(N),c.shift(),c.length&&p(c[0][0],c[0][1])}},un=function(r){var o,i;return o={},a("next"),a("throw",function(s){throw s}),a("return"),o[Symbol.iterator]=function(){return this},o;function a(s,c){o[s]=r[s]?function(u){return(i=!i)?{value:Je(r[s](u)),done:s==="return"}:c?c(u):u}:c}},pn=function(r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r[Symbol.asyncIterator],i;return o?o.call(r):(r=typeof _t=="function"?_t(r):r[Symbol.iterator](),i={},a("next"),a("throw"),a("return"),i[Symbol.asyncIterator]=function(){return this},i);function a(c){i[c]=r[c]&&function(u){return new Promise(function(p,m){u=r[c](u),s(p,m,u.done,u.value)})}}function s(c,u,p,m){Promise.resolve(m).then(function(l){c({value:l,done:p})},u)}},fn=function(r,o){return Object.defineProperty?Object.defineProperty(r,"raw",{value:o}):r.raw=o,r};var n=Object.create?function(r,o){Object.defineProperty(r,"default",{enumerable:!0,value:o})}:function(r,o){r.default=o};ln=function(r){if(r&&r.__esModule)return r;var o={};if(r!=null)for(var i in r)i!=="default"&&Object.prototype.hasOwnProperty.call(r,i)&&Mt(o,r,i);return n(o,r),o},mn=function(r){return r&&r.__esModule?r:{default:r}},dn=function(r,o,i,a){if(i==="a"&&!a)throw new TypeError("Private accessor was defined without a getter");if(typeof o=="function"?r!==o||!a:!o.has(r))throw new TypeError("Cannot read private member from an object whose class did not declare it");return i==="m"?a:i==="a"?a.call(r):a?a.value:o.get(r)},hn=function(r,o,i,a,s){if(a==="m")throw new TypeError("Private method is not writable");if(a==="a"&&!s)throw new TypeError("Private accessor was defined without a setter");if(typeof o=="function"?r!==o||!s:!o.has(r))throw new TypeError("Cannot write private member to an object whose class did not declare it");return a==="a"?s.call(r,i):s?s.value=i:o.set(r,i),i},e("__extends",Br),e("__assign",Jr),e("__rest",Gr),e("__decorate",Xr),e("__param",Zr),e("__metadata",en),e("__awaiter",tn),e("__generator",rn),e("__exportStar",nn),e("__createBinding",Mt),e("__values",_t),e("__read",lr),e("__spread",on),e("__spreadArrays",an),e("__spreadArray",sn),e("__await",Je),e("__asyncGenerator",cn),e("__asyncDelegator",un),e("__asyncValues",pn),e("__makeTemplateObject",fn),e("__importStar",ln),e("__importDefault",mn),e("__classPrivateFieldGet",dn),e("__classPrivateFieldSet",hn)})});var $r=Ot((St,Ir)=>{/*! + * clipboard.js v2.0.8 + * https://clipboardjs.com/ + * + * Licensed MIT © Zeno Rocha + */(function(t,n){typeof St=="object"&&typeof Ir=="object"?Ir.exports=n():typeof define=="function"&&define.amd?define([],n):typeof St=="object"?St.ClipboardJS=n():t.ClipboardJS=n()})(St,function(){return function(){var e={134:function(r,o,i){"use strict";i.d(o,{default:function(){return Mi}});var a=i(279),s=i.n(a),c=i(370),u=i.n(c),p=i(817),m=i.n(p);function l(L){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?l=function(b){return typeof b}:l=function(b){return b&&typeof Symbol=="function"&&b.constructor===Symbol&&b!==Symbol.prototype?"symbol":typeof b},l(L)}function h(L,x){if(!(L instanceof x))throw new TypeError("Cannot call a class as a function")}function d(L,x){for(var b=0;b0&&arguments[0]!==void 0?arguments[0]:{};this.action=b.action,this.container=b.container,this.emitter=b.emitter,this.target=b.target,this.text=b.text,this.trigger=b.trigger,this.selectedText=""}},{key:"initSelection",value:function(){this.text?this.selectFake():this.target&&this.selectTarget()}},{key:"createFakeElement",value:function(){var b=document.documentElement.getAttribute("dir")==="rtl";this.fakeElem=document.createElement("textarea"),this.fakeElem.style.fontSize="12pt",this.fakeElem.style.border="0",this.fakeElem.style.padding="0",this.fakeElem.style.margin="0",this.fakeElem.style.position="absolute",this.fakeElem.style[b?"right":"left"]="-9999px";var I=window.pageYOffset||document.documentElement.scrollTop;return this.fakeElem.style.top="".concat(I,"px"),this.fakeElem.setAttribute("readonly",""),this.fakeElem.value=this.text,this.fakeElem}},{key:"selectFake",value:function(){var b=this,I=this.createFakeElement();this.fakeHandlerCallback=function(){return b.removeFake()},this.fakeHandler=this.container.addEventListener("click",this.fakeHandlerCallback)||!0,this.container.appendChild(I),this.selectedText=m()(I),this.copyText(),this.removeFake()}},{key:"removeFake",value:function(){this.fakeHandler&&(this.container.removeEventListener("click",this.fakeHandlerCallback),this.fakeHandler=null,this.fakeHandlerCallback=null),this.fakeElem&&(this.container.removeChild(this.fakeElem),this.fakeElem=null)}},{key:"selectTarget",value:function(){this.selectedText=m()(this.target),this.copyText()}},{key:"copyText",value:function(){var b;try{b=document.execCommand(this.action)}catch(I){b=!1}this.handleResult(b)}},{key:"handleResult",value:function(b){this.emitter.emit(b?"success":"error",{action:this.action,text:this.selectedText,trigger:this.trigger,clearSelection:this.clearSelection.bind(this)})}},{key:"clearSelection",value:function(){this.trigger&&this.trigger.focus(),document.activeElement.blur(),window.getSelection().removeAllRanges()}},{key:"destroy",value:function(){this.removeFake()}},{key:"action",set:function(){var b=arguments.length>0&&arguments[0]!==void 0?arguments[0]:"copy";if(this._action=b,this._action!=="copy"&&this._action!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"')},get:function(){return this._action}},{key:"target",set:function(b){if(b!==void 0)if(b&&l(b)==="object"&&b.nodeType===1){if(this.action==="copy"&&b.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(this.action==="cut"&&(b.hasAttribute("readonly")||b.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`);this._target=b}else throw new Error('Invalid "target" value, use a valid Element')},get:function(){return this._target}}]),L}(),J=N;function W(L){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?W=function(b){return typeof b}:W=function(b){return b&&typeof Symbol=="function"&&b.constructor===Symbol&&b!==Symbol.prototype?"symbol":typeof b},W(L)}function _(L,x){if(!(L instanceof x))throw new TypeError("Cannot call a class as a function")}function Ve(L,x){for(var b=0;b0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof D.action=="function"?D.action:this.defaultAction,this.target=typeof D.target=="function"?D.target:this.defaultTarget,this.text=typeof D.text=="function"?D.text:this.defaultText,this.container=W(D.container)==="object"?D.container:document.body}},{key:"listenClick",value:function(D){var ee=this;this.listener=u()(D,"click",function(lt){return ee.onClick(lt)})}},{key:"onClick",value:function(D){var ee=D.delegateTarget||D.currentTarget;this.clipboardAction&&(this.clipboardAction=null),this.clipboardAction=new J({action:this.action(ee),target:this.target(ee),text:this.text(ee),container:this.container,trigger:ee,emitter:this})}},{key:"defaultAction",value:function(D){return ur("action",D)}},{key:"defaultTarget",value:function(D){var ee=ur("target",D);if(ee)return document.querySelector(ee)}},{key:"defaultText",value:function(D){return ur("text",D)}},{key:"destroy",value:function(){this.listener.destroy(),this.clipboardAction&&(this.clipboardAction.destroy(),this.clipboardAction=null)}}],[{key:"isSupported",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],ee=typeof D=="string"?[D]:D,lt=!!document.queryCommandSupported;return ee.forEach(function(Li){lt=lt&&!!document.queryCommandSupported(Li)}),lt}}]),b}(s()),Mi=_i},828:function(r){var o=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,c){for(;s&&s.nodeType!==o;){if(typeof s.matches=="function"&&s.matches(c))return s;s=s.parentNode}}r.exports=a},438:function(r,o,i){var a=i(828);function s(p,m,l,h,d){var v=u.apply(this,arguments);return p.addEventListener(l,v,d),{destroy:function(){p.removeEventListener(l,v,d)}}}function c(p,m,l,h,d){return typeof p.addEventListener=="function"?s.apply(null,arguments):typeof l=="function"?s.bind(null,document).apply(null,arguments):(typeof p=="string"&&(p=document.querySelectorAll(p)),Array.prototype.map.call(p,function(v){return s(v,m,l,h,d)}))}function u(p,m,l,h){return function(d){d.delegateTarget=a(d.target,m),d.delegateTarget&&h.call(p,d)}}r.exports=c},879:function(r,o){o.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},o.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||o.node(i[0]))},o.string=function(i){return typeof i=="string"||i instanceof String},o.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(r,o,i){var a=i(879),s=i(438);function c(l,h,d){if(!l&&!h&&!d)throw new Error("Missing required arguments");if(!a.string(h))throw new TypeError("Second argument must be a String");if(!a.fn(d))throw new TypeError("Third argument must be a Function");if(a.node(l))return u(l,h,d);if(a.nodeList(l))return p(l,h,d);if(a.string(l))return m(l,h,d);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function u(l,h,d){return l.addEventListener(h,d),{destroy:function(){l.removeEventListener(h,d)}}}function p(l,h,d){return Array.prototype.forEach.call(l,function(v){v.addEventListener(h,d)}),{destroy:function(){Array.prototype.forEach.call(l,function(v){v.removeEventListener(h,d)})}}}function m(l,h,d){return s(document.body,l,h,d)}r.exports=c},817:function(r){function o(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),u=document.createRange();u.selectNodeContents(i),c.removeAllRanges(),c.addRange(u),a=c.toString()}return a}r.exports=o},279:function(r){function o(){}o.prototype={on:function(i,a,s){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var c=this;function u(){c.off(i,u),a.apply(s,arguments)}return u._=a,this.on(i,u,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),c=0,u=s.length;for(c;c{"use strict";/*! + * escape-html + * Copyright(c) 2012-2013 TJ Holowaychuk + * Copyright(c) 2015 Andreas Lubbe + * Copyright(c) 2015 Tiancheng "Timothy" Gu + * MIT Licensed + */var Ta=/["'&<>]/;Yo.exports=Oa;function Oa(e){var t=""+e,n=Ta.exec(t);if(!n)return t;var r,o="",i=0,a=0;for(i=n.index;i0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(n){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,n)},t.prototype._subscribe=function(n){return this._throwIfClosed(),this._checkFinalizedStatuses(n),this._innerSubscribe(n)},t.prototype._innerSubscribe=function(n){var r=this,o=r.hasError,i=r.isStopped,a=r.observers;return o||i?mr:(a.push(n),new Te(function(){return ke(a,n)}))},t.prototype._checkFinalizedStatuses=function(n){var r=this,o=r.hasError,i=r.thrownError,a=r.isStopped;o?n.error(i):a&&n.complete()},t.prototype.asObservable=function(){var n=new P;return n.source=this,n},t.create=function(n,r){return new Cn(n,r)},t}(P);var Cn=function(e){Z(t,e);function t(n,r){var o=e.call(this)||this;return o.destination=n,o.source=r,o}return t.prototype.next=function(n){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.next)===null||o===void 0||o.call(r,n)},t.prototype.error=function(n){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.error)===null||o===void 0||o.call(r,n)},t.prototype.complete=function(){var n,r;(r=(n=this.destination)===null||n===void 0?void 0:n.complete)===null||r===void 0||r.call(n)},t.prototype._subscribe=function(n){var r,o;return(o=(r=this.source)===null||r===void 0?void 0:r.subscribe(n))!==null&&o!==void 0?o:mr},t}(w);var dt={now:function(){return(dt.delegate||Date).now()},delegate:void 0};var ht=function(e){Z(t,e);function t(n,r,o){n===void 0&&(n=1/0),r===void 0&&(r=1/0),o===void 0&&(o=dt);var i=e.call(this)||this;return i._bufferSize=n,i._windowTime=r,i._timestampProvider=o,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=r===1/0,i._bufferSize=Math.max(1,n),i._windowTime=Math.max(1,r),i}return t.prototype.next=function(n){var r=this,o=r.isStopped,i=r._buffer,a=r._infiniteTimeWindow,s=r._timestampProvider,c=r._windowTime;o||(i.push(n),!a&&i.push(s.now()+c)),this._trimBuffer(),e.prototype.next.call(this,n)},t.prototype._subscribe=function(n){this._throwIfClosed(),this._trimBuffer();for(var r=this._innerSubscribe(n),o=this,i=o._infiniteTimeWindow,a=o._buffer,s=a.slice(),c=0;c0?e.prototype.requestAsyncId.call(this,n,r,o):(n.actions.push(this),n._scheduled||(n._scheduled=tt.requestAnimationFrame(function(){return n.flush(void 0)})))},t.prototype.recycleAsyncId=function(n,r,o){if(o===void 0&&(o=0),o!=null&&o>0||o==null&&this.delay>0)return e.prototype.recycleAsyncId.call(this,n,r,o);n.actions.some(function(i){return i.id===r})||(tt.cancelAnimationFrame(r),n._scheduled=void 0)},t}($t);var Rn=function(e){Z(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(n){this._active=!0;var r=this._scheduled;this._scheduled=void 0;var o=this.actions,i;n=n||o.shift();do if(i=n.execute(n.state,n.delay))break;while((n=o[0])&&n.id===r&&o.shift());if(this._active=!1,i){for(;(n=o[0])&&n.id===r&&o.shift();)n.unsubscribe();throw i}},t}(Pt);var Se=new Rn(Hn);var z=new P(function(e){return e.complete()});function Ft(e){return e&&E(e.schedule)}function xr(e){return e[e.length-1]}function Ie(e){return E(xr(e))?e.pop():void 0}function ve(e){return Ft(xr(e))?e.pop():void 0}function jt(e,t){return typeof xr(e)=="number"?e.pop():t}var rt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Wt(e){return E(e==null?void 0:e.then)}function Ut(e){return E(e[et])}function Vt(e){return Symbol.asyncIterator&&E(e==null?void 0:e[Symbol.asyncIterator])}function Dt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Wi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var Nt=Wi();function zt(e){return E(e==null?void 0:e[Nt])}function Qt(e){return xn(this,arguments,function(){var n,r,o,i;return At(this,function(a){switch(a.label){case 0:n=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,Ct(n.read())];case 3:return r=a.sent(),o=r.value,i=r.done,i?[4,Ct(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,Ct(o)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return n.releaseLock(),[7];case 10:return[2]}})})}function qt(e){return E(e==null?void 0:e.getReader)}function U(e){if(e instanceof P)return e;if(e!=null){if(Ut(e))return Ui(e);if(rt(e))return Vi(e);if(Wt(e))return Di(e);if(Vt(e))return In(e);if(zt(e))return Ni(e);if(qt(e))return zi(e)}throw Dt(e)}function Ui(e){return new P(function(t){var n=e[et]();if(E(n.subscribe))return n.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Vi(e){return new P(function(t){for(var n=0;n=2,!0))}function ce(e){e===void 0&&(e={});var t=e.connector,n=t===void 0?function(){return new w}:t,r=e.resetOnError,o=r===void 0?!0:r,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,c=s===void 0?!0:s;return function(u){var p=null,m=null,l=null,h=0,d=!1,v=!1,N=function(){m==null||m.unsubscribe(),m=null},J=function(){N(),p=l=null,d=v=!1},W=function(){var _=p;J(),_==null||_.unsubscribe()};return g(function(_,Ve){h++,!v&&!d&&N();var Ce=l=l!=null?l:n();Ve.add(function(){h--,h===0&&!v&&!d&&(m=_r(W,c))}),Ce.subscribe(Ve),p||(p=new Ze({next:function(Ye){return Ce.next(Ye)},error:function(Ye){v=!0,N(),m=_r(J,o,Ye),Ce.error(Ye)},complete:function(){d=!0,N(),m=_r(J,a),Ce.complete()}}),te(_).subscribe(p))})(u)}}function _r(e,t){for(var n=[],r=2;re.next(document)),e}function B(e,t=document){return Array.from(t.querySelectorAll(e))}function K(e,t=document){let n=le(e,t);if(typeof n=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return n}function le(e,t=document){return t.querySelector(e)||void 0}function Fe(){return document.activeElement instanceof HTMLElement&&document.activeElement||void 0}function Gt(e){return A(S(document.body,"focusin"),S(document.body,"focusout")).pipe(Qe(1),f(()=>{let t=Fe();return typeof t!="undefined"?e.contains(t):!1}),V(e===Fe()),q())}function je(e){return{x:e.offsetLeft,y:e.offsetTop}}function eo(e){return A(S(window,"load"),S(window,"resize")).pipe(He(0,Se),f(()=>je(e)),V(je(e)))}function to(e){return{x:e.scrollLeft,y:e.scrollTop}}function Xt(e){return A(S(e,"scroll"),S(window,"resize")).pipe(He(0,Se),f(()=>to(e)),V(to(e)))}var ro=new w,sa=F(()=>k(new ResizeObserver(e=>{for(let t of e)ro.next(t)}))).pipe(O(e=>A(ge,k(e)).pipe(C(()=>e.disconnect()))),G(1));function _e(e){return{width:e.offsetWidth,height:e.offsetHeight}}function he(e){return sa.pipe(T(t=>t.observe(e)),O(t=>ro.pipe(M(({target:n})=>n===e),C(()=>t.unobserve(e)),f(()=>_e(e)))),V(_e(e)))}function Zt(e){return{width:e.scrollWidth,height:e.scrollHeight}}var ca=new w,mb=F(()=>k(new IntersectionObserver(e=>{for(let t of e)ca.next(t)},{threshold:1}))).pipe(O(e=>A(ge,k(e)).pipe(C(()=>e.disconnect()))),G(1));function no(e,t=16){return Xt(e).pipe(f(({y:n})=>{let r=_e(e),o=Zt(e);return n>=o.height-r.height-t}),q())}var er={drawer:K("[data-md-toggle=drawer]"),search:K("[data-md-toggle=search]")};function oo(e){return er[e].checked}function We(e,t){er[e].checked!==t&&er[e].click()}function tr(e){let t=er[e];return S(t,"change").pipe(f(()=>t.checked),V(t.checked))}function ua(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function io(){return S(window,"keydown").pipe(M(e=>!(e.metaKey||e.ctrlKey)),f(e=>({mode:oo("search")?"search":"global",type:e.key,claim(){e.preventDefault(),e.stopPropagation()}})),M(({mode:e,type:t})=>{if(e==="global"){let n=Fe();if(typeof n!="undefined")return!ua(n,t)}return!0}),ce())}function Me(){return new URL(location.href)}function ao(e){location.href=e.href}function so(){return new w}function co(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let n of t)co(e,n)}function H(e,t,...n){let r=document.createElement(e);if(t)for(let o of Object.keys(t))typeof t[o]!="boolean"?r.setAttribute(o,t[o]):t[o]&&r.setAttribute(o,"");for(let o of n)co(r,o);return r}function uo(e,t){let n=t;if(e.length>n){for(;e[n]!==" "&&--n>0;);return`${e.substring(0,n)}...`}return e}function rr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function po(){return location.hash.substring(1)}function fo(e){let t=H("a",{href:e});t.addEventListener("click",n=>n.stopPropagation()),t.click()}function pa(){return S(window,"hashchange").pipe(f(po),V(po()),M(e=>e.length>0),G(1))}function lo(){return pa().pipe(f(e=>le(`[id="${e}"]`)),M(e=>typeof e!="undefined"))}function Hr(e){let t=matchMedia(e);return Bt(n=>t.addListener(()=>n(t.matches))).pipe(V(t.matches))}function mo(){let e=matchMedia("print");return A(S(window,"beforeprint").pipe(re(!0)),S(window,"afterprint").pipe(re(!1))).pipe(V(e.matches))}function Rr(e,t){return e.pipe(O(n=>n?t():z))}function nr(e,t={credentials:"same-origin"}){return te(fetch(`${e}`,t)).pipe(M(n=>n.status===200),Pe(()=>z))}function Le(e,t){return nr(e,t).pipe(O(n=>n.json()),G(1))}function ho(e,t){let n=new DOMParser;return nr(e,t).pipe(O(r=>r.text()),f(r=>n.parseFromString(r,"text/xml")),G(1))}function bo(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function vo(){return A(S(window,"scroll",{passive:!0}),S(window,"resize",{passive:!0})).pipe(f(bo),V(bo()))}function go(){return{width:innerWidth,height:innerHeight}}function xo(){return S(window,"resize",{passive:!0}).pipe(f(go),V(go()))}function yo(){return Q([vo(),xo()]).pipe(f(([e,t])=>({offset:e,size:t})),G(1))}function or(e,{viewport$:t,header$:n}){let r=t.pipe(Y("size")),o=Q([r,n]).pipe(f(()=>je(e)));return Q([n,t,o]).pipe(f(([{height:i},{offset:a,size:s},{x:c,y:u}])=>({offset:{x:a.x-c,y:a.y-u+i},size:s})))}function So(e,{tx$:t}){let n=S(e,"message").pipe(f(({data:r})=>r));return t.pipe(yt(()=>n,{leading:!0,trailing:!0}),T(r=>e.postMessage(r)),Mr(n),ce())}var fa=K("#__config"),ct=JSON.parse(fa.textContent);ct.base=`${new URL(ct.base,Me())}`;function be(){return ct}function ae(e){return ct.features.includes(e)}function X(e,t){return typeof t!="undefined"?ct.translations[e].replace("#",t.toString()):ct.translations[e]}function Ae(e,t=document){return K(`[data-md-component=${e}]`,t)}function ne(e,t=document){return B(`[data-md-component=${e}]`,t)}var ko=Be($r());function wo(e){return H("aside",{class:"md-annotation",tabIndex:0},H("div",{class:"md-annotation__inner md-tooltip"},H("div",{class:"md-tooltip__inner md-typeset"})),H("span",{class:"md-annotation__index"},H("span",{"data-md-annotation-id":e})))}function Eo(e){return H("button",{class:"md-clipboard md-icon",title:X("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function Pr(e,t){let n=t&2,r=t&1,o=Object.keys(e.terms).filter(a=>!e.terms[a]).map(a=>[H("del",null,a)," "]).flat().slice(0,-1),i=new URL(e.location);return ae("search.highlight")&&i.searchParams.set("h",Object.entries(e.terms).filter(([,a])=>a).reduce((a,[s])=>`${a} ${s}`.trim(),"")),H("a",{href:`${i}`,class:"md-search-result__link",tabIndex:-1},H("article",{class:["md-search-result__article",...n?["md-search-result__article--document"]:[]].join(" "),"data-md-score":e.score.toFixed(2)},n>0&&H("div",{class:"md-search-result__icon md-icon"}),H("h1",{class:"md-search-result__title"},e.title),r>0&&e.text.length>0&&H("p",{class:"md-search-result__teaser"},uo(e.text,320)),r>0&&o.length>0&&H("p",{class:"md-search-result__terms"},X("search.result.term.missing"),": ",o)))}function To(e){let t=e[0].score,n=[...e],r=n.findIndex(u=>!u.location.includes("#")),[o]=n.splice(r,1),i=n.findIndex(u=>u.scorePr(u,1)),...s.length?[H("details",{class:"md-search-result__more"},H("summary",{tabIndex:-1},s.length>0&&s.length===1?X("search.result.more.one"):X("search.result.more.other",s.length)),s.map(u=>Pr(u,1)))]:[]];return H("li",{class:"md-search-result__item"},c)}function Oo(e){return H("ul",{class:"md-source__facts"},Object.entries(e).map(([t,n])=>H("li",{class:`md-source__fact md-source__fact--${t}`},typeof n=="number"?rr(n):n)))}function _o(e){return H("div",{class:"md-typeset__scrollwrap"},H("div",{class:"md-typeset__table"},e))}function la(e){let t=be(),n=new URL(`../${e.version}/`,t.base);return H("li",{class:"md-version__item"},H("a",{href:n.toString(),class:"md-version__link"},e.title))}function Mo(e,t){return H("div",{class:"md-version"},H("button",{class:"md-version__current","aria-label":X("select.version.title")},t.title),H("ul",{class:"md-version__list"},e.map(la)))}function ma(e,t){let n=F(()=>Q([eo(e),Xt(t)])).pipe(f(([{x:r,y:o},i])=>{let{width:a}=_e(e);return{x:r-i.x+a/2,y:o-i.y}}));return Gt(e).pipe(O(r=>n.pipe(f(o=>({active:r,offset:o})),fe(+!r||1/0))))}function Lo(e,t){return F(()=>{let n=new w;n.subscribe({next({offset:i}){e.style.setProperty("--md-tooltip-x",`${i.x}px`),e.style.setProperty("--md-tooltip-y",`${i.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),n.pipe(Cr(500,Se),f(()=>t.getBoundingClientRect()),f(({x:i})=>i)).subscribe({next(i){i?e.style.setProperty("--md-tooltip-0",`${-i}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}});let r=K(":scope > :last-child",e),o=S(r,"mousedown",{once:!0});return n.pipe(O(({active:i})=>i?o:z),T(i=>i.preventDefault())).subscribe(()=>e.blur()),ma(e,t).pipe(T(i=>n.next(i)),C(()=>n.complete()),f(i=>$({ref:e},i)))})}function da(e){let t=[];for(let n of B(".c, .c1, .cm",e)){let r,o=n.firstChild;for(;r=/\((\d+)\)/.exec(o.textContent);){let i=o.splitText(r.index);o=i.splitText(r[0].length),t.push(i)}}return t}function Ao(e,t){t.append(...Array.from(e.childNodes))}function Co(e,t,{print$:n}){let r=new Map;for(let o of da(t)){let[,i]=o.textContent.match(/\((\d+)\)/);r.set(+i,wo(+i)),o.replaceWith(r.get(+i))}return r.size===0?z:F(()=>{let o=new w;return n.pipe(ue(o.pipe(se(1)))).subscribe(i=>{e.hidden=!i;for(let[a,s]of r){let c=K(".md-typeset",s),u=K(`li:nth-child(${a})`,e);i?Ao(c,u):Ao(u,c)}}),A(...[...r].map(([,i])=>Lo(i,t))).pipe(C(()=>o.complete()),ce())})}var ha=0;function Ho(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Ho(t)}}function Ro(e){return he(e).pipe(f(({width:t})=>({scrollable:Zt(e).width>t})),Y("scrollable"))}function Io(e,t){let{matches:n}=matchMedia("(hover)");return F(()=>{let r=new w;if(r.subscribe(({scrollable:i})=>{i&&n?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")}),ko.default.isSupported()){let i=e.closest("pre");i.id=`__code_${++ha}`,i.insertBefore(Eo(i.id),e)}let o=e.closest([":not(td):not(.code) > .highlight",".highlighttable"].join(", "));if(o instanceof HTMLElement){let i=Ho(o);if(typeof i!="undefined"&&(o.classList.contains("annotate")||ae("content.code.annotate"))){let a=Co(i,e,t);return Ro(e).pipe(T(s=>r.next(s)),C(()=>r.complete()),f(s=>$({ref:e},s)),Ke(he(o).pipe(ue(r.pipe(se(1))),f(({width:s,height:c})=>s&&c),q(),O(s=>s?a:z))))}}return Ro(e).pipe(T(i=>r.next(i)),C(()=>r.complete()),f(i=>$({ref:e},i)))})}function ba(e,{target$:t,print$:n}){let r=!0;return A(t.pipe(f(o=>o.closest("details:not([open])")),M(o=>e===o),re({action:"open",reveal:!0})),n.pipe(M(o=>o||!r),T(()=>r=e.open),f(o=>({action:o?"open":"close"}))))}function $o(e,t){return F(()=>{let n=new w;return n.subscribe(({action:r,reveal:o})=>{r==="open"?e.setAttribute("open",""):e.removeAttribute("open"),o&&e.scrollIntoView()}),ba(e,t).pipe(T(r=>n.next(r)),C(()=>n.complete()),f(r=>$({ref:e},r)))})}var Po=H("table");function Fo(e){return e.replaceWith(Po),Po.replaceWith(_o(e)),k({ref:e})}function va(e){let t=B(":scope > input",e);return A(...t.map(n=>S(n,"change").pipe(re({active:K(`label[for=${n.id}]`)})))).pipe(V({active:K(`label[for=${t[0].id}]`)}))}function jo(e){let t=K(".tabbed-labels",e);return F(()=>{let n=new w;return Q([n,he(e)]).pipe(He(1,Se),ue(n.pipe(se(1)))).subscribe({next([{active:r}]){let o=je(r),{width:i}=_e(r);e.style.setProperty("--md-indicator-x",`${o.x}px`),e.style.setProperty("--md-indicator-width",`${i}px`),t.scrollTo({behavior:"smooth",left:o.x})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),va(e).pipe(T(r=>n.next(r)),C(()=>n.complete()),f(r=>$({ref:e},r)))})}function Wo(e,{target$:t,print$:n}){return A(...B("pre > code",e).map(r=>Io(r,{print$:n})),...B("table:not([class])",e).map(r=>Fo(r)),...B("details",e).map(r=>$o(r,{target$:t,print$:n})),...B("[data-tabs]",e).map(r=>jo(r)))}function ga(e,{alert$:t}){return t.pipe(O(n=>A(k(!0),k(!1).pipe(Re(2e3))).pipe(f(r=>({message:n,active:r})))))}function Uo(e,t){let n=K(".md-typeset",e);return F(()=>{let r=new w;return r.subscribe(({message:o,active:i})=>{n.textContent=o,i?e.setAttribute("data-md-state","open"):e.removeAttribute("data-md-state")}),ga(e,t).pipe(T(o=>r.next(o)),C(()=>r.complete()),f(o=>$({ref:e},o)))})}function xa({viewport$:e}){if(!ae("header.autohide"))return k(!1);let t=e.pipe(f(({offset:{y:o}})=>o),we(2,1),f(([o,i])=>[oMath.abs(i-o.y)>100),f(([,[o]])=>o),q()),r=tr("search");return Q([e,r]).pipe(f(([{offset:o},i])=>o.y>400&&!i),q(),O(o=>o?n:k(!1)),V(!1))}function Vo(e,t){return F(()=>{let n=getComputedStyle(e);return k(n.position==="sticky"||n.position==="-webkit-sticky")}).pipe(at(he(e),xa(t)),f(([n,{height:r},o])=>({height:n?r:0,sticky:n,hidden:o})),q((n,r)=>n.sticky===r.sticky&&n.height===r.height&&n.hidden===r.hidden),G(1))}function Do(e,{header$:t,main$:n}){return F(()=>{let r=new w;return r.pipe(Y("active"),at(t)).subscribe(([{active:o},{hidden:i}])=>{o?e.setAttribute("data-md-state",i?"hidden":"shadow"):e.removeAttribute("data-md-state")}),n.subscribe(r),t.pipe(ue(r.pipe(se(1))),f(o=>$({ref:e},o)))})}function ya(e,{viewport$:t,header$:n}){return or(e,{viewport$:t,header$:n}).pipe(f(({offset:{y:r}})=>{let{height:o}=_e(e);return{active:r>=o}}),Y("active"))}function No(e,t){return F(()=>{let n=new w;n.subscribe(({active:o})=>{o?e.setAttribute("data-md-state","active"):e.removeAttribute("data-md-state")});let r=le("article h1");return typeof r=="undefined"?z:ya(r,t).pipe(T(o=>n.next(o)),C(()=>n.complete()),f(o=>$({ref:e},o)))})}function zo(e,{viewport$:t,header$:n}){let r=n.pipe(f(({height:i})=>i),q()),o=r.pipe(O(()=>he(e).pipe(f(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),Y("bottom"))));return Q([r,o,t]).pipe(f(([i,{top:a,bottom:s},{offset:{y:c},size:{height:u}}])=>(u=Math.max(0,u-Math.max(0,a-c,i)-Math.max(0,u+c-s)),{offset:a-i,height:u,active:a-i<=c})),q((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function Sa(e){let t=__md_get("__palette")||{index:e.findIndex(n=>matchMedia(n.getAttribute("data-md-color-media")).matches)};return k(...e).pipe(ie(n=>S(n,"change").pipe(re(n))),V(e[Math.max(0,t.index)]),f(n=>({index:e.indexOf(n),color:{scheme:n.getAttribute("data-md-color-scheme"),primary:n.getAttribute("data-md-color-primary"),accent:n.getAttribute("data-md-color-accent")}})),G(1))}function Qo(e){return F(()=>{let t=new w;t.subscribe(r=>{for(let[o,i]of Object.entries(r.color))typeof i=="string"&&document.body.setAttribute(`data-md-color-${o}`,i);for(let o=0;ot.next(r)),C(()=>t.complete()),f(r=>$({ref:e},r)))})}var Fr=Be($r());function wa(e){e.setAttribute("data-md-copying","");let t=e.innerText;return e.removeAttribute("data-md-copying"),t}function qo({alert$:e}){Fr.default.isSupported()&&new P(t=>{new Fr.default("[data-clipboard-target], [data-clipboard-text]",{text:n=>n.getAttribute("data-clipboard-text")||wa(K(n.getAttribute("data-clipboard-target")))}).on("success",n=>t.next(n))}).pipe(T(t=>{t.trigger.focus()}),re(X("clipboard.copied"))).subscribe(e)}function Ea(e){if(e.length<2)return e;let[t,n]=e.sort((i,a)=>i.length-a.length).map(i=>i.replace(/[^/]+$/,"")),r=0;if(t===n)r=t.length;else for(;t.charCodeAt(r)===n.charCodeAt(r);)r++;let o=be();return e.map(i=>i.replace(t.slice(0,r),o.base))}function Ko({document$:e,location$:t,viewport$:n}){let r=be();if(location.protocol==="file:")return;"scrollRestoration"in history&&(history.scrollRestoration="manual",S(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}));let o=le("link[rel=icon]");typeof o!="undefined"&&(o.href=o.href);let i=ho(new URL("sitemap.xml",r.base)).pipe(f(u=>Ea(B("loc",u).map(p=>p.textContent))),O(u=>S(document.body,"click").pipe(M(p=>!p.metaKey&&!p.ctrlKey),O(p=>{if(p.target instanceof Element){let m=p.target.closest("a");if(m&&!m.target){let l=new URL(m.href);if(l.search="",l.hash="",l.pathname!==location.pathname&&u.includes(l.toString()))return p.preventDefault(),k({url:new URL(m.href)})}}return ge}))),ce()),a=S(window,"popstate").pipe(M(u=>u.state!==null),f(u=>({url:new URL(location.href),offset:u.state})),ce());A(i,a).pipe(q((u,p)=>u.url.href===p.url.href),f(({url:u})=>u)).subscribe(t);let s=t.pipe(Y("pathname"),O(u=>nr(u.href).pipe(Pe(()=>(ao(u),ge)))),ce());i.pipe(st(s)).subscribe(({url:u})=>{history.pushState({},"",`${u}`)});let c=new DOMParser;s.pipe(O(u=>u.text()),f(u=>c.parseFromString(u,"text/html"))).subscribe(e),e.pipe(Jt(1)).subscribe(u=>{for(let p of["title","link[rel=canonical]","meta[name=author]","meta[name=description]","[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=logo]","[data-md-component=skip]",...ae("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let m=le(p),l=le(p,u);typeof m!="undefined"&&typeof l!="undefined"&&m.replaceWith(l)}}),e.pipe(Jt(1),f(()=>Ae("container")),O(u=>k(...B("script",u))),wr(u=>{let p=H("script");if(u.src){for(let m of u.getAttributeNames())p.setAttribute(m,u.getAttribute(m));return u.replaceWith(p),new P(m=>{p.onload=()=>m.complete()})}else return p.textContent=u.textContent,u.replaceWith(p),z})).subscribe(),A(i,a).pipe(st(e)).subscribe(({url:u,offset:p})=>{u.hash&&!p?fo(u.hash):window.scrollTo(0,(p==null?void 0:p.y)||0)}),n.pipe(xt(i),Qe(250),Y("offset")).subscribe(({offset:u})=>{history.replaceState(u,"")}),A(i,a).pipe(we(2,1),M(([u,p])=>u.url.pathname===p.url.pathname),f(([,u])=>u)).subscribe(({offset:u})=>{window.scrollTo(0,(u==null?void 0:u.y)||0)})}var _a=Be(jr());var Bo=Be(jr());function Wr(e,t){let n=new RegExp(e.separator,"img"),r=(o,i,a)=>`${i}${a}`;return o=>{o=o.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator})(${o.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(n,"|")})`,"img");return a=>(t?(0,Bo.default)(a):a).replace(i,r).replace(/<\/mark>(\s+)]*>/img,"$1")}}function Jo(e){return e.split(/"([^"]+)"/g).map((t,n)=>n&1?t.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g," +"):t).join("").replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g,"").trim()}function ut(e){return e.type===1}function Go(e){return e.type===2}function pt(e){return e.type===3}function La({config:e,docs:t}){e.lang.length===1&&e.lang[0]==="en"&&(e.lang=[X("search.config.lang")]),e.separator==="[\\s\\-]+"&&(e.separator=X("search.config.separator"));let r={pipeline:X("search.config.pipeline").split(/\s*,\s*/).filter(Boolean),suggestions:ae("search.suggest")};return{config:e,docs:t,options:r}}function Xo(e,t){let n=be(),r=new Worker(e),o=new w,i=So(r,{tx$:o}).pipe(f(a=>{if(pt(a))for(let s of a.data.items)for(let c of s)c.location=`${new URL(c.location,n.base)}`;return a}),ce());return te(t).pipe(f(a=>({type:0,data:La(a)}))).subscribe(o.next.bind(o)),{tx$:o,rx$:i}}function Zo(){let e=be(),t=Le(new URL("../versions.json",e.base)),n=t.pipe(f(r=>{let[,o]=e.base.match(/([^/]+)\/?$/);return r.find(({version:i,aliases:a})=>i===o||a.includes(o))||r[0]}));Q([t,n]).subscribe(([r,o])=>{var a;if(K(".md-header__topic").appendChild(Mo(r,o)),__md_get("__outdated",sessionStorage)===null){let s=((a=e.version)==null?void 0:a.default)||"latest",c=!o.aliases.includes(s);if(__md_set("__outdated",c,sessionStorage),c)for(let u of ne("outdated"))u.hidden=!1}})}function Aa(e,{rx$:t}){let n=(__search==null?void 0:__search.transform)||Jo,{searchParams:r}=Me();r.has("q")&&We("search",!0);let o=t.pipe(M(ut),fe(1),f(()=>r.get("q")||""));o.subscribe(s=>{s&&(e.value=s)});let i=Gt(e),a=A(S(e,"keyup"),S(e,"focus").pipe(Re(1)),o).pipe(f(()=>n(e.value)),V(""),q());return Q([a,i]).pipe(f(([s,c])=>({value:s,focus:c})),G(1))}function ei(e,{tx$:t,rx$:n}){let r=new w;return r.pipe(Y("value"),f(({value:o})=>({type:2,data:o}))).subscribe(t.next.bind(t)),r.pipe(Y("focus")).subscribe(({focus:o})=>{o?(We("search",o),e.placeholder=""):e.placeholder=X("search.placeholder")}),S(e.form,"reset").pipe(ue(r.pipe(se(1)))).subscribe(()=>e.focus()),Aa(e,{tx$:t,rx$:n}).pipe(T(o=>r.next(o)),C(()=>r.complete()),f(o=>$({ref:e},o)))}function ti(e,{rx$:t},{query$:n}){let r=new w,o=no(e.parentElement).pipe(M(Boolean)),i=K(":scope > :first-child",e),a=K(":scope > :last-child",e),s=t.pipe(M(ut),fe(1));return r.pipe(Ee(n),xt(s)).subscribe(([{items:u},{value:p}])=>{if(p)switch(u.length){case 0:i.textContent=X("search.result.none");break;case 1:i.textContent=X("search.result.one");break;default:i.textContent=X("search.result.other",rr(u.length))}else i.textContent=X("search.result.placeholder")}),r.pipe(T(()=>a.innerHTML=""),O(({items:u})=>A(k(...u.slice(0,10)),k(...u.slice(10)).pipe(we(4),kr(o),O(([p])=>k(...p)))))).subscribe(u=>a.appendChild(To(u))),t.pipe(M(pt),f(({data:u})=>u)).pipe(T(u=>r.next(u)),C(()=>r.complete()),f(u=>$({ref:e},u)))}function Ca(e,{query$:t}){return t.pipe(f(({value:n})=>{let r=Me();return r.hash="",r.searchParams.delete("h"),r.searchParams.set("q",n),{url:r}}))}function ri(e,t){let n=new w;return n.subscribe(({url:r})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${r}`}),S(e,"click").subscribe(r=>r.preventDefault()),Ca(e,t).pipe(T(r=>n.next(r)),C(()=>n.complete()),f(r=>$({ref:e},r)))}function ni(e,{rx$:t},{keyboard$:n}){let r=new w,o=Ae("search-query"),i=A(S(o,"keydown"),S(o,"focus")).pipe(Ne(Oe),f(()=>o.value),q());return r.pipe(at(i),f(([{suggestions:s},c])=>{let u=c.split(/([\s-]+)/);if((s==null?void 0:s.length)&&u[u.length-1]){let p=s[s.length-1];p.startsWith(u[u.length-1])&&(u[u.length-1]=p)}else u.length=0;return u})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g," ")),n.pipe(M(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&o.selectionStart===o.value.length&&(o.value=e.innerText);break}}),t.pipe(M(pt),f(({data:s})=>s)).pipe(T(s=>r.next(s)),C(()=>r.complete()),f(()=>({ref:e})))}function oi(e,{index$:t,keyboard$:n}){let r=be();try{let o=(__search==null?void 0:__search.worker)||r.search,i=Xo(o,t),a=Ae("search-query",e),s=Ae("search-result",e),{tx$:c,rx$:u}=i;c.pipe(M(Go),st(u.pipe(M(ut))),fe(1)).subscribe(c.next.bind(c)),n.pipe(M(({mode:l})=>l==="search")).subscribe(l=>{let h=Fe();switch(l.type){case"Enter":if(h===a){let d=new Map;for(let v of B(":first-child [href]",s)){let N=v.firstElementChild;d.set(v,parseFloat(N.getAttribute("data-md-score")))}if(d.size){let[[v]]=[...d].sort(([,N],[,J])=>J-N);v.click()}l.claim()}break;case"Escape":case"Tab":We("search",!1),a.blur();break;case"ArrowUp":case"ArrowDown":if(typeof h=="undefined")a.focus();else{let d=[a,...B(":not(details) > [href], summary, details[open] [href]",s)],v=Math.max(0,(Math.max(0,d.indexOf(h))+d.length+(l.type==="ArrowUp"?-1:1))%d.length);d[v].focus()}l.claim();break;default:a!==Fe()&&a.focus()}}),n.pipe(M(({mode:l})=>l==="global")).subscribe(l=>{switch(l.type){case"f":case"s":case"/":a.focus(),a.select(),l.claim();break}});let p=ei(a,i),m=ti(s,i,{query$:p});return A(p,m).pipe(Ke(...ne("search-share",e).map(l=>ri(l,{query$:p})),...ne("search-suggest",e).map(l=>ni(l,i,{keyboard$:n}))))}catch(o){return e.hidden=!0,ge}}function ii(e,{index$:t,location$:n}){return Q([t,n.pipe(V(Me()),M(r=>!!r.searchParams.get("h")))]).pipe(f(([r,o])=>Wr(r.config,!0)(o.searchParams.get("h"))),f(r=>{var a;let o=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)==null?void 0:a.offsetHeight){let c=s.textContent,u=r(c);u.length>c.length&&o.set(s,u)}for(let[s,c]of o){let{childNodes:u}=H("span",null,c);s.replaceWith(...Array.from(u))}return{ref:e,nodes:o}}))}function ka(e,{viewport$:t,main$:n}){let r=e.parentElement,o=r.offsetTop-r.parentElement.offsetTop;return Q([n,t]).pipe(f(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(o,Math.max(0,s-i))-o,{height:a,locked:s>=i+o})),q((i,a)=>i.height===a.height&&i.locked===a.locked))}function Ur(e,r){var o=r,{header$:t}=o,n=qr(o,["header$"]);let i=K(".md-sidebar__scrollwrap",e),{y:a}=je(i);return F(()=>{let s=new w;return s.pipe(He(0,Se),Ee(t)).subscribe({next([{height:c},{height:u}]){i.style.height=`${c-2*a}px`,e.style.top=`${u}px`},complete(){i.style.height="",e.style.top=""}}),ka(e,n).pipe(T(c=>s.next(c)),C(()=>s.complete()),f(c=>$({ref:e},c)))})}function ai(e,t){if(typeof t!="undefined"){let n=`https://api.github.com/repos/${e}/${t}`;return gt(Le(`${n}/releases/latest`).pipe(f(r=>({version:r.tag_name})),qe({})),Le(n).pipe(f(r=>({stars:r.stargazers_count,forks:r.forks_count})),qe({}))).pipe(f(([r,o])=>$($({},r),o)))}else{let n=`https://api.github.com/users/${e}`;return Le(n).pipe(f(r=>({repositories:r.public_repos})),qe({}))}}function si(e,t){let n=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Le(n).pipe(f(({star_count:r,forks_count:o})=>({stars:r,forks:o})),qe({}))}function ci(e){let[t]=e.match(/(git(?:hub|lab))/i)||[];switch(t.toLowerCase()){case"github":let[,n,r]=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);return ai(n,r);case"gitlab":let[,o,i]=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i);return si(o,i);default:return z}}var Ha;function Ra(e){return Ha||(Ha=F(()=>{let t=__md_get("__source",sessionStorage);return t?k(t):ci(e.href).pipe(T(n=>__md_set("__source",n,sessionStorage)))}).pipe(Pe(()=>z),M(t=>Object.keys(t).length>0),f(t=>({facts:t})),G(1)))}function ui(e){let t=K(":scope > :last-child",e);return F(()=>{let n=new w;return n.subscribe(({facts:r})=>{t.appendChild(Oo(r)),t.setAttribute("data-md-state","done")}),Ra(e).pipe(T(r=>n.next(r)),C(()=>n.complete()),f(r=>$({ref:e},r)))})}function Ia(e,{viewport$:t,header$:n}){return he(document.body).pipe(O(()=>or(e,{header$:n,viewport$:t})),f(({offset:{y:r}})=>({hidden:r>=10})),Y("hidden"))}function pi(e,t){return F(()=>{let n=new w;return n.subscribe({next({hidden:r}){r?e.setAttribute("data-md-state","hidden"):e.removeAttribute("data-md-state")},complete(){e.removeAttribute("data-md-state")}}),(ae("navigation.tabs.sticky")?k({hidden:!1}):Ia(e,t)).pipe(T(r=>n.next(r)),C(()=>n.complete()),f(r=>$({ref:e},r)))})}function $a(e,{viewport$:t,header$:n}){let r=new Map,o=B("[href^=\\#]",e);for(let s of o){let c=decodeURIComponent(s.hash.substring(1)),u=le(`[id="${c}"]`);typeof u!="undefined"&&r.set(s,u)}let i=n.pipe(f(s=>24+s.height));return he(document.body).pipe(Y("height"),O(s=>F(()=>{let c=[];return k([...r].reduce((u,[p,m])=>{for(;c.length&&r.get(c[c.length-1]).tagName>=m.tagName;)c.pop();let l=m.offsetTop;for(;!l&&m.parentElement;)m=m.parentElement,l=m.offsetTop;return u.set([...c=[...c,p]].reverse(),l)},new Map))}).pipe(f(c=>new Map([...c].sort(([,u],[,p])=>u-p))),O(c=>Q([t,i]).pipe(Or(([u,p],[{offset:{y:m},size:l},h])=>{let d=m+l.height>=Math.floor(s.height);for(;p.length;){let[,v]=p[0];if(v-h=m&&!d)p=[u.pop(),...p];else break}return[u,p]},[[],[...c]]),q((u,p)=>u[0]===p[0]&&u[1]===p[1])))))).pipe(f(([s,c])=>({prev:s.map(([u])=>u),next:c.map(([u])=>u)})),V({prev:[],next:[]}),we(2,1),f(([s,c])=>s.prev.length{let r=new w;return r.subscribe(({prev:o,next:i})=>{for(let[a]of i)a.removeAttribute("data-md-state"),a.classList.remove("md-nav__link--active");for(let[a,[s]]of o.entries())s.setAttribute("data-md-state","blur"),s.classList.toggle("md-nav__link--active",a===o.length-1)}),ae("navigation.tracking")&&t.pipe(ue(r.pipe(se(1))),Y("offset"),Qe(250),Ee(r)).subscribe(([,{prev:o}])=>{let i=Me(),a=o[o.length-1];if(a&&a.length){let[s]=a,{hash:c}=new URL(s.href);i.hash!==c&&(i.hash=c,history.replaceState({},"",`${i}`))}else i.hash="",history.replaceState({},"",`${i}`)}),$a(e,{viewport$:t,header$:n}).pipe(T(o=>r.next(o)),C(()=>r.complete()),f(o=>$({ref:e},o)))})}function Pa(e,{viewport$:t,main$:n}){let r=t.pipe(f(({offset:{y:i}})=>i),we(2,1),f(([i,a])=>i>a&&a),q()),o=n.pipe(Y("active"));return Q([o,r]).pipe(f(([{active:i},a])=>({hidden:!(i&&a)})),q((i,a)=>i.hidden===a.hidden))}function li(e,{viewport$:t,header$:n,main$:r}){let o=new w;return o.subscribe({next({hidden:i}){i?(e.setAttribute("data-md-state","hidden"),e.setAttribute("tabindex","-1"),e.blur()):(e.removeAttribute("data-md-state"),e.removeAttribute("tabindex"))},complete(){e.style.top="",e.setAttribute("data-md-state","hidden"),e.removeAttribute("tabindex")}}),n.pipe(ue(o.pipe(Tr(0),se(1))),Y("height")).subscribe(({height:i})=>{e.style.top=`${i+16}px`}),Pa(e,{viewport$:t,header$:n,main$:r}).pipe(T(i=>o.next(i)),C(()=>o.complete()),f(i=>$({ref:e},i)))}function mi({document$:e,tablet$:t}){e.pipe(O(()=>k(...B("[data-md-state=indeterminate]"))),T(n=>{n.indeterminate=!0,n.checked=!1}),ie(n=>S(n,"change").pipe(Lr(()=>n.hasAttribute("data-md-state")),re(n))),Ee(t)).subscribe(([n,r])=>{n.removeAttribute("data-md-state"),r&&(n.checked=!1)})}function Fa(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function di({document$:e}){e.pipe(O(()=>k(...B("[data-md-scrollfix]"))),T(t=>t.removeAttribute("data-md-scrollfix")),M(Fa),ie(t=>S(t,"touchstart").pipe(re(t)))).subscribe(t=>{let n=t.scrollTop;n===0?t.scrollTop=1:n+t.offsetHeight===t.scrollHeight&&(t.scrollTop=n-1)})}function hi({viewport$:e,tablet$:t}){Q([tr("search"),t]).pipe(f(([n,r])=>n&&!r),O(n=>k(n).pipe(Re(n?400:100))),Ee(e)).subscribe(([n,{offset:{y:r}}])=>{if(n)document.body.setAttribute("data-md-state","lock"),document.body.style.top=`-${r}px`;else{let o=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-state"),document.body.style.top="",o&&window.scrollTo(0,o)}})}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ft=Zn(),ir=so(),Vr=lo(),Dr=io(),xe=yo(),ar=Hr("(min-width: 960px)"),bi=Hr("(min-width: 1220px)"),vi=mo(),gi=be(),xi=document.forms.namedItem("search")?(__search==null?void 0:__search.index)||Le(new URL("search/search_index.json",gi.base)):ge,Nr=new w;qo({alert$:Nr});ae("navigation.instant")&&Ko({document$:ft,location$:ir,viewport$:xe});var Si;((Si=gi.version)==null?void 0:Si.provider)==="mike"&&Zo();A(ir,Vr).pipe(Re(125)).subscribe(()=>{We("drawer",!1),We("search",!1)});Dr.pipe(M(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=le("[href][rel=prev]");typeof t!="undefined"&&t.click();break;case"n":case".":let n=le("[href][rel=next]");typeof n!="undefined"&&n.click();break}});mi({document$:ft,tablet$:ar});di({document$:ft});hi({viewport$:xe,tablet$:ar});var Ue=Vo(Ae("header"),{viewport$:xe}),sr=ft.pipe(f(()=>Ae("main")),O(e=>zo(e,{viewport$:xe,header$:Ue})),G(1)),ja=A(...ne("dialog").map(e=>Uo(e,{alert$:Nr})),...ne("header").map(e=>Do(e,{viewport$:xe,header$:Ue,main$:sr})),...ne("palette").map(e=>Qo(e)),...ne("search").map(e=>oi(e,{index$:xi,keyboard$:Dr})),...ne("source").map(e=>ui(e))),Wa=F(()=>A(...ne("content").map(e=>Wo(e,{target$:Vr,print$:vi})),...ne("content").map(e=>ae("search.highlight")?ii(e,{index$:xi,location$:ir}):z),...ne("header-title").map(e=>No(e,{viewport$:xe,header$:Ue})),...ne("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Rr(bi,()=>Ur(e,{viewport$:xe,header$:Ue,main$:sr})):Rr(ar,()=>Ur(e,{viewport$:xe,header$:Ue,main$:sr}))),...ne("tabs").map(e=>pi(e,{viewport$:xe,header$:Ue})),...ne("toc").map(e=>fi(e,{viewport$:xe,header$:Ue})),...ne("top").map(e=>li(e,{viewport$:xe,header$:Ue,main$:sr})))),yi=ft.pipe(O(()=>Wa),Ke(ja),G(1));yi.subscribe();window.document$=ft;window.location$=ir;window.target$=Vr;window.keyboard$=Dr;window.viewport$=xe;window.tablet$=ar;window.screen$=bi;window.print$=vi;window.alert$=Nr;window.component$=yi;})(); +//# sourceMappingURL=bundle.289a2a4b.min.js.map + diff --git a/3.25.0/assets/javascripts/bundle.289a2a4b.min.js.map b/3.25.0/assets/javascripts/bundle.289a2a4b.min.js.map new file mode 100644 index 0000000000..bcc55bb135 --- /dev/null +++ b/3.25.0/assets/javascripts/bundle.289a2a4b.min.js.map @@ -0,0 +1,8 @@ +{ + "version": 3, + "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/rxjs/node_modules/tslib/tslib.js", "node_modules/clipboard/dist/clipboard.js", "node_modules/escape-html/index.js", "src/assets/javascripts/bundle.ts", "node_modules/rxjs/node_modules/tslib/modules/index.js", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/concatMap.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/sample.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/switchMapTo.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/assets/javascripts/browser/document/index.ts", "src/assets/javascripts/browser/element/_/index.ts", "src/assets/javascripts/browser/element/focus/index.ts", "src/assets/javascripts/browser/element/offset/_/index.ts", "src/assets/javascripts/browser/element/offset/content/index.ts", "src/assets/javascripts/browser/element/size/_/index.ts", "src/assets/javascripts/browser/element/size/content/index.ts", "src/assets/javascripts/browser/element/visibility/index.ts", "src/assets/javascripts/browser/toggle/index.ts", "src/assets/javascripts/browser/keyboard/index.ts", "src/assets/javascripts/browser/location/_/index.ts", "src/assets/javascripts/utilities/h/index.ts", "src/assets/javascripts/utilities/string/index.ts", "src/assets/javascripts/browser/location/hash/index.ts", "src/assets/javascripts/browser/media/index.ts", "src/assets/javascripts/browser/request/index.ts", "src/assets/javascripts/browser/viewport/offset/index.ts", "src/assets/javascripts/browser/viewport/size/index.ts", "src/assets/javascripts/browser/viewport/_/index.ts", "src/assets/javascripts/browser/viewport/at/index.ts", "src/assets/javascripts/browser/worker/index.ts", "src/assets/javascripts/_/index.ts", "src/assets/javascripts/components/_/index.ts", "src/assets/javascripts/components/content/code/index.ts", "src/assets/javascripts/templates/annotation/index.tsx", "src/assets/javascripts/templates/clipboard/index.tsx", "src/assets/javascripts/templates/search/index.tsx", "src/assets/javascripts/templates/source/index.tsx", "src/assets/javascripts/templates/table/index.tsx", "src/assets/javascripts/templates/version/index.tsx", "src/assets/javascripts/components/content/annotation/_/index.ts", "src/assets/javascripts/components/content/annotation/list/index.ts", "src/assets/javascripts/components/content/details/index.ts", "src/assets/javascripts/components/content/table/index.ts", "src/assets/javascripts/components/content/tabs/index.ts", "src/assets/javascripts/components/content/_/index.ts", "src/assets/javascripts/components/dialog/index.ts", "src/assets/javascripts/components/header/_/index.ts", "src/assets/javascripts/components/header/title/index.ts", "src/assets/javascripts/components/main/index.ts", "src/assets/javascripts/components/palette/index.ts", "src/assets/javascripts/integrations/clipboard/index.ts", "src/assets/javascripts/integrations/instant/index.ts", "src/assets/javascripts/integrations/search/document/index.ts", "src/assets/javascripts/integrations/search/highlighter/index.ts", "src/assets/javascripts/integrations/search/query/transform/index.ts", "src/assets/javascripts/integrations/search/worker/message/index.ts", "src/assets/javascripts/integrations/search/worker/_/index.ts", "src/assets/javascripts/integrations/version/index.ts", "src/assets/javascripts/components/search/query/index.ts", "src/assets/javascripts/components/search/result/index.ts", "src/assets/javascripts/components/search/share/index.ts", "src/assets/javascripts/components/search/suggest/index.ts", "src/assets/javascripts/components/search/_/index.ts", "src/assets/javascripts/components/search/highlight/index.ts", "src/assets/javascripts/components/sidebar/index.ts", "src/assets/javascripts/components/source/facts/github/index.ts", "src/assets/javascripts/components/source/facts/gitlab/index.ts", "src/assets/javascripts/components/source/facts/_/index.ts", "src/assets/javascripts/components/source/_/index.ts", "src/assets/javascripts/components/tabs/index.ts", "src/assets/javascripts/components/toc/index.ts", "src/assets/javascripts/components/top/index.ts", "src/assets/javascripts/patches/indeterminate/index.ts", "src/assets/javascripts/patches/scrollfix/index.ts", "src/assets/javascripts/patches/scrolllock/index.ts"], + "sourceRoot": "../../../..", + "sourcesContent": ["(function (global, factory) {\n typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n typeof define === 'function' && define.amd ? define(factory) :\n (factory());\n}(this, (function () { 'use strict';\n\n /**\n * Applies the :focus-visible polyfill at the given scope.\n * A scope in this case is either the top-level Document or a Shadow Root.\n *\n * @param {(Document|ShadowRoot)} scope\n * @see https://github.com/WICG/focus-visible\n */\n function applyFocusVisiblePolyfill(scope) {\n var hadKeyboardEvent = true;\n var hadFocusVisibleRecently = false;\n var hadFocusVisibleRecentlyTimeout = null;\n\n var inputTypesAllowlist = {\n text: true,\n search: true,\n url: true,\n tel: true,\n email: true,\n password: true,\n number: true,\n date: true,\n month: true,\n week: true,\n time: true,\n datetime: true,\n 'datetime-local': true\n };\n\n /**\n * Helper function for legacy browsers and iframes which sometimes focus\n * elements like document, body, and non-interactive SVG.\n * @param {Element} el\n */\n function isValidFocusTarget(el) {\n if (\n el &&\n el !== document &&\n el.nodeName !== 'HTML' &&\n el.nodeName !== 'BODY' &&\n 'classList' in el &&\n 'contains' in el.classList\n ) {\n return true;\n }\n return false;\n }\n\n /**\n * Computes whether the given element should automatically trigger the\n * `focus-visible` class being added, i.e. whether it should always match\n * `:focus-visible` when focused.\n * @param {Element} el\n * @return {boolean}\n */\n function focusTriggersKeyboardModality(el) {\n var type = el.type;\n var tagName = el.tagName;\n\n if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n return true;\n }\n\n if (tagName === 'TEXTAREA' && !el.readOnly) {\n return true;\n }\n\n if (el.isContentEditable) {\n return true;\n }\n\n return false;\n }\n\n /**\n * Add the `focus-visible` class to the given element if it was not added by\n * the author.\n * @param {Element} el\n */\n function addFocusVisibleClass(el) {\n if (el.classList.contains('focus-visible')) {\n return;\n }\n el.classList.add('focus-visible');\n el.setAttribute('data-focus-visible-added', '');\n }\n\n /**\n * Remove the `focus-visible` class from the given element if it was not\n * originally added by the author.\n * @param {Element} el\n */\n function removeFocusVisibleClass(el) {\n if (!el.hasAttribute('data-focus-visible-added')) {\n return;\n }\n el.classList.remove('focus-visible');\n el.removeAttribute('data-focus-visible-added');\n }\n\n /**\n * If the most recent user interaction was via the keyboard;\n * and the key press did not include a meta, alt/option, or control key;\n * then the modality is keyboard. Otherwise, the modality is not keyboard.\n * Apply `focus-visible` to any current active element and keep track\n * of our keyboard modality state with `hadKeyboardEvent`.\n * @param {KeyboardEvent} e\n */\n function onKeyDown(e) {\n if (e.metaKey || e.altKey || e.ctrlKey) {\n return;\n }\n\n if (isValidFocusTarget(scope.activeElement)) {\n addFocusVisibleClass(scope.activeElement);\n }\n\n hadKeyboardEvent = true;\n }\n\n /**\n * If at any point a user clicks with a pointing device, ensure that we change\n * the modality away from keyboard.\n * This avoids the situation where a user presses a key on an already focused\n * element, and then clicks on a different element, focusing it with a\n * pointing device, while we still think we're in keyboard modality.\n * @param {Event} e\n */\n function onPointerDown(e) {\n hadKeyboardEvent = false;\n }\n\n /**\n * On `focus`, add the `focus-visible` class to the target if:\n * - the target received focus as a result of keyboard navigation, or\n * - the event target is an element that will likely require interaction\n * via the keyboard (e.g. a text box)\n * @param {Event} e\n */\n function onFocus(e) {\n // Prevent IE from focusing the document or HTML element.\n if (!isValidFocusTarget(e.target)) {\n return;\n }\n\n if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n addFocusVisibleClass(e.target);\n }\n }\n\n /**\n * On `blur`, remove the `focus-visible` class from the target.\n * @param {Event} e\n */\n function onBlur(e) {\n if (!isValidFocusTarget(e.target)) {\n return;\n }\n\n if (\n e.target.classList.contains('focus-visible') ||\n e.target.hasAttribute('data-focus-visible-added')\n ) {\n // To detect a tab/window switch, we look for a blur event followed\n // rapidly by a visibility change.\n // If we don't see a visibility change within 100ms, it's probably a\n // regular focus change.\n hadFocusVisibleRecently = true;\n window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n hadFocusVisibleRecently = false;\n }, 100);\n removeFocusVisibleClass(e.target);\n }\n }\n\n /**\n * If the user changes tabs, keep track of whether or not the previously\n * focused element had .focus-visible.\n * @param {Event} e\n */\n function onVisibilityChange(e) {\n if (document.visibilityState === 'hidden') {\n // If the tab becomes active again, the browser will handle calling focus\n // on the element (Safari actually calls it twice).\n // If this tab change caused a blur on an element with focus-visible,\n // re-apply the class when the user switches back to the tab.\n if (hadFocusVisibleRecently) {\n hadKeyboardEvent = true;\n }\n addInitialPointerMoveListeners();\n }\n }\n\n /**\n * Add a group of listeners to detect usage of any pointing devices.\n * These listeners will be added when the polyfill first loads, and anytime\n * the window is blurred, so that they are active when the window regains\n * focus.\n */\n function addInitialPointerMoveListeners() {\n document.addEventListener('mousemove', onInitialPointerMove);\n document.addEventListener('mousedown', onInitialPointerMove);\n document.addEventListener('mouseup', onInitialPointerMove);\n document.addEventListener('pointermove', onInitialPointerMove);\n document.addEventListener('pointerdown', onInitialPointerMove);\n document.addEventListener('pointerup', onInitialPointerMove);\n document.addEventListener('touchmove', onInitialPointerMove);\n document.addEventListener('touchstart', onInitialPointerMove);\n document.addEventListener('touchend', onInitialPointerMove);\n }\n\n function removeInitialPointerMoveListeners() {\n document.removeEventListener('mousemove', onInitialPointerMove);\n document.removeEventListener('mousedown', onInitialPointerMove);\n document.removeEventListener('mouseup', onInitialPointerMove);\n document.removeEventListener('pointermove', onInitialPointerMove);\n document.removeEventListener('pointerdown', onInitialPointerMove);\n document.removeEventListener('pointerup', onInitialPointerMove);\n document.removeEventListener('touchmove', onInitialPointerMove);\n document.removeEventListener('touchstart', onInitialPointerMove);\n document.removeEventListener('touchend', onInitialPointerMove);\n }\n\n /**\n * When the polfyill first loads, assume the user is in keyboard modality.\n * If any event is received from a pointing device (e.g. mouse, pointer,\n * touch), turn off keyboard modality.\n * This accounts for situations where focus enters the page from the URL bar.\n * @param {Event} e\n */\n function onInitialPointerMove(e) {\n // Work around a Safari quirk that fires a mousemove on whenever the\n // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n return;\n }\n\n hadKeyboardEvent = false;\n removeInitialPointerMoveListeners();\n }\n\n // For some kinds of state, we are interested in changes at the global scope\n // only. For example, global pointer input, global key presses and global\n // visibility change should affect the state at every scope:\n document.addEventListener('keydown', onKeyDown, true);\n document.addEventListener('mousedown', onPointerDown, true);\n document.addEventListener('pointerdown', onPointerDown, true);\n document.addEventListener('touchstart', onPointerDown, true);\n document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n addInitialPointerMoveListeners();\n\n // For focus and blur, we specifically care about state changes in the local\n // scope. This is because focus / blur events that originate from within a\n // shadow root are not re-dispatched from the host element if it was already\n // the active element in its own scope:\n scope.addEventListener('focus', onFocus, true);\n scope.addEventListener('blur', onBlur, true);\n\n // We detect that a node is a ShadowRoot by ensuring that it is a\n // DocumentFragment and also has a host property. This check covers native\n // implementation and polyfill implementation transparently. If we only cared\n // about the native implementation, we could just check if the scope was\n // an instance of a ShadowRoot.\n if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n // have a root element to add a class to. So, we add this attribute to the\n // host element instead:\n scope.host.setAttribute('data-js-focus-visible', '');\n } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n document.documentElement.classList.add('js-focus-visible');\n document.documentElement.setAttribute('data-js-focus-visible', '');\n }\n }\n\n // It is important to wrap all references to global window and document in\n // these checks to support server-side rendering use cases\n // @see https://github.com/WICG/focus-visible/issues/199\n if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n // Make the polyfill helper globally available. This can be used as a signal\n // to interested libraries that wish to coordinate with the polyfill for e.g.,\n // applying the polyfill to a shadow root:\n window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n // Notify interested libraries of the polyfill's presence, in case the\n // polyfill was loaded lazily:\n var event;\n\n try {\n event = new CustomEvent('focus-visible-polyfill-ready');\n } catch (error) {\n // IE11 does not support using CustomEvent as a constructor directly:\n event = document.createEvent('CustomEvent');\n event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n }\n\n window.dispatchEvent(event);\n }\n\n if (typeof document !== 'undefined') {\n // Apply the polyfill to the global document, so that no JavaScript\n // coordination is required to use the polyfill in the top-level document:\n applyFocusVisiblePolyfill(document);\n }\n\n})));\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global global, define, System, Reflect, Promise */\r\nvar __extends;\r\nvar __assign;\r\nvar __rest;\r\nvar __decorate;\r\nvar __param;\r\nvar __metadata;\r\nvar __awaiter;\r\nvar __generator;\r\nvar __exportStar;\r\nvar __values;\r\nvar __read;\r\nvar __spread;\r\nvar __spreadArrays;\r\nvar __spreadArray;\r\nvar __await;\r\nvar __asyncGenerator;\r\nvar __asyncDelegator;\r\nvar __asyncValues;\r\nvar __makeTemplateObject;\r\nvar __importStar;\r\nvar __importDefault;\r\nvar __classPrivateFieldGet;\r\nvar __classPrivateFieldSet;\r\nvar __createBinding;\r\n(function (factory) {\r\n var root = typeof global === \"object\" ? global : typeof self === \"object\" ? self : typeof this === \"object\" ? this : {};\r\n if (typeof define === \"function\" && define.amd) {\r\n define(\"tslib\", [\"exports\"], function (exports) { factory(createExporter(root, createExporter(exports))); });\r\n }\r\n else if (typeof module === \"object\" && typeof module.exports === \"object\") {\r\n factory(createExporter(root, createExporter(module.exports)));\r\n }\r\n else {\r\n factory(createExporter(root));\r\n }\r\n function createExporter(exports, previous) {\r\n if (exports !== root) {\r\n if (typeof Object.create === \"function\") {\r\n Object.defineProperty(exports, \"__esModule\", { value: true });\r\n }\r\n else {\r\n exports.__esModule = true;\r\n }\r\n }\r\n return function (id, v) { return exports[id] = previous ? previous(id, v) : v; };\r\n }\r\n})\r\n(function (exporter) {\r\n var extendStatics = Object.setPrototypeOf ||\r\n ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n\r\n __extends = function (d, b) {\r\n if (typeof b !== \"function\" && b !== null)\r\n throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n extendStatics(d, b);\r\n function __() { this.constructor = d; }\r\n d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n };\r\n\r\n __assign = Object.assign || function (t) {\r\n for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n s = arguments[i];\r\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n }\r\n return t;\r\n };\r\n\r\n __rest = function (s, e) {\r\n var t = {};\r\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n t[p] = s[p];\r\n if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n t[p[i]] = s[p[i]];\r\n }\r\n return t;\r\n };\r\n\r\n __decorate = function (decorators, target, key, desc) {\r\n var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n };\r\n\r\n __param = function (paramIndex, decorator) {\r\n return function (target, key) { decorator(target, key, paramIndex); }\r\n };\r\n\r\n __metadata = function (metadataKey, metadataValue) {\r\n if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n };\r\n\r\n __awaiter = function (thisArg, _arguments, P, generator) {\r\n function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n return new (P || (P = Promise))(function (resolve, reject) {\r\n function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n });\r\n };\r\n\r\n __generator = function (thisArg, body) {\r\n var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n function verb(n) { return function (v) { return step([n, v]); }; }\r\n function step(op) {\r\n if (f) throw new TypeError(\"Generator is already executing.\");\r\n while (_) try {\r\n if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n if (y = 0, t) op = [op[0] & 2, t.value];\r\n switch (op[0]) {\r\n case 0: case 1: t = op; break;\r\n case 4: _.label++; return { value: op[1], done: false };\r\n case 5: _.label++; y = op[1]; op = [0]; continue;\r\n case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n default:\r\n if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n if (t[2]) _.ops.pop();\r\n _.trys.pop(); continue;\r\n }\r\n op = body.call(thisArg, _);\r\n } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n }\r\n };\r\n\r\n __exportStar = function(m, o) {\r\n for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n };\r\n\r\n __createBinding = Object.create ? (function(o, m, k, k2) {\r\n if (k2 === undefined) k2 = k;\r\n Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n }) : (function(o, m, k, k2) {\r\n if (k2 === undefined) k2 = k;\r\n o[k2] = m[k];\r\n });\r\n\r\n __values = function (o) {\r\n var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n if (m) return m.call(o);\r\n if (o && typeof o.length === \"number\") return {\r\n next: function () {\r\n if (o && i >= o.length) o = void 0;\r\n return { value: o && o[i++], done: !o };\r\n }\r\n };\r\n throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n };\r\n\r\n __read = function (o, n) {\r\n var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n if (!m) return o;\r\n var i = m.call(o), r, ar = [], e;\r\n try {\r\n while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n }\r\n catch (error) { e = { error: error }; }\r\n finally {\r\n try {\r\n if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n }\r\n finally { if (e) throw e.error; }\r\n }\r\n return ar;\r\n };\r\n\r\n /** @deprecated */\r\n __spread = function () {\r\n for (var ar = [], i = 0; i < arguments.length; i++)\r\n ar = ar.concat(__read(arguments[i]));\r\n return ar;\r\n };\r\n\r\n /** @deprecated */\r\n __spreadArrays = function () {\r\n for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n r[k] = a[j];\r\n return r;\r\n };\r\n\r\n __spreadArray = function (to, from, pack) {\r\n if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n if (ar || !(i in from)) {\r\n if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n ar[i] = from[i];\r\n }\r\n }\r\n return to.concat(ar || Array.prototype.slice.call(from));\r\n };\r\n\r\n __await = function (v) {\r\n return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n };\r\n\r\n __asyncGenerator = function (thisArg, _arguments, generator) {\r\n if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n function fulfill(value) { resume(\"next\", value); }\r\n function reject(value) { resume(\"throw\", value); }\r\n function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n };\r\n\r\n __asyncDelegator = function (o) {\r\n var i, p;\r\n return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n };\r\n\r\n __asyncValues = function (o) {\r\n if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n var m = o[Symbol.asyncIterator], i;\r\n return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n };\r\n\r\n __makeTemplateObject = function (cooked, raw) {\r\n if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n return cooked;\r\n };\r\n\r\n var __setModuleDefault = Object.create ? (function(o, v) {\r\n Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n }) : function(o, v) {\r\n o[\"default\"] = v;\r\n };\r\n\r\n __importStar = function (mod) {\r\n if (mod && mod.__esModule) return mod;\r\n var result = {};\r\n if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n __setModuleDefault(result, mod);\r\n return result;\r\n };\r\n\r\n __importDefault = function (mod) {\r\n return (mod && mod.__esModule) ? mod : { \"default\": mod };\r\n };\r\n\r\n __classPrivateFieldGet = function (receiver, state, kind, f) {\r\n if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n };\r\n\r\n __classPrivateFieldSet = function (receiver, state, value, kind, f) {\r\n if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n };\r\n\r\n exporter(\"__extends\", __extends);\r\n exporter(\"__assign\", __assign);\r\n exporter(\"__rest\", __rest);\r\n exporter(\"__decorate\", __decorate);\r\n exporter(\"__param\", __param);\r\n exporter(\"__metadata\", __metadata);\r\n exporter(\"__awaiter\", __awaiter);\r\n exporter(\"__generator\", __generator);\r\n exporter(\"__exportStar\", __exportStar);\r\n exporter(\"__createBinding\", __createBinding);\r\n exporter(\"__values\", __values);\r\n exporter(\"__read\", __read);\r\n exporter(\"__spread\", __spread);\r\n exporter(\"__spreadArrays\", __spreadArrays);\r\n exporter(\"__spreadArray\", __spreadArray);\r\n exporter(\"__await\", __await);\r\n exporter(\"__asyncGenerator\", __asyncGenerator);\r\n exporter(\"__asyncDelegator\", __asyncDelegator);\r\n exporter(\"__asyncValues\", __asyncValues);\r\n exporter(\"__makeTemplateObject\", __makeTemplateObject);\r\n exporter(\"__importStar\", __importStar);\r\n exporter(\"__importDefault\", __importDefault);\r\n exporter(\"__classPrivateFieldGet\", __classPrivateFieldGet);\r\n exporter(\"__classPrivateFieldSet\", __classPrivateFieldSet);\r\n});\r\n", "/*!\n * clipboard.js v2.0.8\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 134:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/clipboard-action.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\n\n/**\n * Inner class which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n */\n\nvar ClipboardAction = /*#__PURE__*/function () {\n /**\n * @param {Object} options\n */\n function ClipboardAction(options) {\n _classCallCheck(this, ClipboardAction);\n\n this.resolveOptions(options);\n this.initSelection();\n }\n /**\n * Defines base properties passed from constructor.\n * @param {Object} options\n */\n\n\n _createClass(ClipboardAction, [{\n key: \"resolveOptions\",\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n this.action = options.action;\n this.container = options.container;\n this.emitter = options.emitter;\n this.target = options.target;\n this.text = options.text;\n this.trigger = options.trigger;\n this.selectedText = '';\n }\n /**\n * Decides which selection strategy is going to be applied based\n * on the existence of `text` and `target` properties.\n */\n\n }, {\n key: \"initSelection\",\n value: function initSelection() {\n if (this.text) {\n this.selectFake();\n } else if (this.target) {\n this.selectTarget();\n }\n }\n /**\n * Creates a fake textarea element, sets its value from `text` property,\n */\n\n }, {\n key: \"createFakeElement\",\n value: function createFakeElement() {\n var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n this.fakeElem = document.createElement('textarea'); // Prevent zooming on iOS\n\n this.fakeElem.style.fontSize = '12pt'; // Reset box model\n\n this.fakeElem.style.border = '0';\n this.fakeElem.style.padding = '0';\n this.fakeElem.style.margin = '0'; // Move element out of screen horizontally\n\n this.fakeElem.style.position = 'absolute';\n this.fakeElem.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n this.fakeElem.style.top = \"\".concat(yPosition, \"px\");\n this.fakeElem.setAttribute('readonly', '');\n this.fakeElem.value = this.text;\n return this.fakeElem;\n }\n /**\n * Get's the value of fakeElem,\n * and makes a selection on it.\n */\n\n }, {\n key: \"selectFake\",\n value: function selectFake() {\n var _this = this;\n\n var fakeElem = this.createFakeElement();\n\n this.fakeHandlerCallback = function () {\n return _this.removeFake();\n };\n\n this.fakeHandler = this.container.addEventListener('click', this.fakeHandlerCallback) || true;\n this.container.appendChild(fakeElem);\n this.selectedText = select_default()(fakeElem);\n this.copyText();\n this.removeFake();\n }\n /**\n * Only removes the fake element after another click event, that way\n * a user can hit `Ctrl+C` to copy because selection still exists.\n */\n\n }, {\n key: \"removeFake\",\n value: function removeFake() {\n if (this.fakeHandler) {\n this.container.removeEventListener('click', this.fakeHandlerCallback);\n this.fakeHandler = null;\n this.fakeHandlerCallback = null;\n }\n\n if (this.fakeElem) {\n this.container.removeChild(this.fakeElem);\n this.fakeElem = null;\n }\n }\n /**\n * Selects the content from element passed on `target` property.\n */\n\n }, {\n key: \"selectTarget\",\n value: function selectTarget() {\n this.selectedText = select_default()(this.target);\n this.copyText();\n }\n /**\n * Executes the copy operation based on the current selection.\n */\n\n }, {\n key: \"copyText\",\n value: function copyText() {\n var succeeded;\n\n try {\n succeeded = document.execCommand(this.action);\n } catch (err) {\n succeeded = false;\n }\n\n this.handleResult(succeeded);\n }\n /**\n * Fires an event based on the copy operation result.\n * @param {Boolean} succeeded\n */\n\n }, {\n key: \"handleResult\",\n value: function handleResult(succeeded) {\n this.emitter.emit(succeeded ? 'success' : 'error', {\n action: this.action,\n text: this.selectedText,\n trigger: this.trigger,\n clearSelection: this.clearSelection.bind(this)\n });\n }\n /**\n * Moves focus away from `target` and back to the trigger, removes current selection.\n */\n\n }, {\n key: \"clearSelection\",\n value: function clearSelection() {\n if (this.trigger) {\n this.trigger.focus();\n }\n\n document.activeElement.blur();\n window.getSelection().removeAllRanges();\n }\n /**\n * Sets the `action` to be performed which can be either 'copy' or 'cut'.\n * @param {String} action\n */\n\n }, {\n key: \"destroy\",\n\n /**\n * Destroy lifecycle.\n */\n value: function destroy() {\n this.removeFake();\n }\n }, {\n key: \"action\",\n set: function set() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'copy';\n this._action = action;\n\n if (this._action !== 'copy' && this._action !== 'cut') {\n throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n }\n }\n /**\n * Gets the `action` property.\n * @return {String}\n */\n ,\n get: function get() {\n return this._action;\n }\n /**\n * Sets the `target` property using an element\n * that will be have its content copied.\n * @param {Element} target\n */\n\n }, {\n key: \"target\",\n set: function set(target) {\n if (target !== undefined) {\n if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n if (this.action === 'copy' && target.hasAttribute('disabled')) {\n throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n }\n\n if (this.action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n }\n\n this._target = target;\n } else {\n throw new Error('Invalid \"target\" value, use a valid Element');\n }\n }\n }\n /**\n * Gets the `target` property.\n * @return {String|HTMLElement}\n */\n ,\n get: function get() {\n return this._target;\n }\n }]);\n\n return ClipboardAction;\n}();\n\n/* harmony default export */ var clipboard_action = (ClipboardAction);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction clipboard_classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction clipboard_defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction clipboard_createClass(Constructor, protoProps, staticProps) { if (protoProps) clipboard_defineProperties(Constructor.prototype, protoProps); if (staticProps) clipboard_defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n var attribute = \"data-clipboard-\".concat(suffix);\n\n if (!element.hasAttribute(attribute)) {\n return;\n }\n\n return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n _inherits(Clipboard, _Emitter);\n\n var _super = _createSuper(Clipboard);\n\n /**\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n * @param {Object} options\n */\n function Clipboard(trigger, options) {\n var _this;\n\n clipboard_classCallCheck(this, Clipboard);\n\n _this = _super.call(this);\n\n _this.resolveOptions(options);\n\n _this.listenClick(trigger);\n\n return _this;\n }\n /**\n * Defines if attributes would be resolved using internal setter functions\n * or custom functions that were passed in the constructor.\n * @param {Object} options\n */\n\n\n clipboard_createClass(Clipboard, [{\n key: \"resolveOptions\",\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n }\n /**\n * Adds a click event listener to the passed trigger.\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n */\n\n }, {\n key: \"listenClick\",\n value: function listenClick(trigger) {\n var _this2 = this;\n\n this.listener = listen_default()(trigger, 'click', function (e) {\n return _this2.onClick(e);\n });\n }\n /**\n * Defines a new `ClipboardAction` on each click event.\n * @param {Event} e\n */\n\n }, {\n key: \"onClick\",\n value: function onClick(e) {\n var trigger = e.delegateTarget || e.currentTarget;\n\n if (this.clipboardAction) {\n this.clipboardAction = null;\n }\n\n this.clipboardAction = new clipboard_action({\n action: this.action(trigger),\n target: this.target(trigger),\n text: this.text(trigger),\n container: this.container,\n trigger: trigger,\n emitter: this\n });\n }\n /**\n * Default `action` lookup function.\n * @param {Element} trigger\n */\n\n }, {\n key: \"defaultAction\",\n value: function defaultAction(trigger) {\n return getAttributeValue('action', trigger);\n }\n /**\n * Default `target` lookup function.\n * @param {Element} trigger\n */\n\n }, {\n key: \"defaultTarget\",\n value: function defaultTarget(trigger) {\n var selector = getAttributeValue('target', trigger);\n\n if (selector) {\n return document.querySelector(selector);\n }\n }\n /**\n * Returns the support of the given action, or all actions if no action is\n * given.\n * @param {String} [action]\n */\n\n }, {\n key: \"defaultText\",\n\n /**\n * Default `text` lookup function.\n * @param {Element} trigger\n */\n value: function defaultText(trigger) {\n return getAttributeValue('text', trigger);\n }\n /**\n * Destroy lifecycle.\n */\n\n }, {\n key: \"destroy\",\n value: function destroy() {\n this.listener.destroy();\n\n if (this.clipboardAction) {\n this.clipboardAction.destroy();\n this.clipboardAction = null;\n }\n }\n }], [{\n key: \"isSupported\",\n value: function isSupported() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n var actions = typeof action === 'string' ? [action] : action;\n var support = !!document.queryCommandSupported;\n actions.forEach(function (action) {\n support = support && !!document.queryCommandSupported(action);\n });\n return support;\n }\n }]);\n\n return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n var proto = Element.prototype;\n\n proto.matches = proto.matchesSelector ||\n proto.mozMatchesSelector ||\n proto.msMatchesSelector ||\n proto.oMatchesSelector ||\n proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n if (typeof element.matches === 'function' &&\n element.matches(selector)) {\n return element;\n }\n element = element.parentNode;\n }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n var listenerFn = listener.apply(this, arguments);\n\n element.addEventListener(type, listenerFn, useCapture);\n\n return {\n destroy: function() {\n element.removeEventListener(type, listenerFn, useCapture);\n }\n }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n // Handle the regular Element usage\n if (typeof elements.addEventListener === 'function') {\n return _delegate.apply(null, arguments);\n }\n\n // Handle Element-less usage, it defaults to global delegation\n if (typeof type === 'function') {\n // Use `document` as the first parameter, then apply arguments\n // This is a short way to .unshift `arguments` without running into deoptimizations\n return _delegate.bind(null, document).apply(null, arguments);\n }\n\n // Handle Selector-based usage\n if (typeof elements === 'string') {\n elements = document.querySelectorAll(elements);\n }\n\n // Handle Array-like based usage\n return Array.prototype.map.call(elements, function (element) {\n return _delegate(element, selector, type, callback, useCapture);\n });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n return function(e) {\n e.delegateTarget = closest(e.target, selector);\n\n if (e.delegateTarget) {\n callback.call(element, e);\n }\n }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n return value !== undefined\n && value instanceof HTMLElement\n && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return value !== undefined\n && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n && ('length' in value)\n && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n return typeof value === 'string'\n || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n if (!target && !type && !callback) {\n throw new Error('Missing required arguments');\n }\n\n if (!is.string(type)) {\n throw new TypeError('Second argument must be a String');\n }\n\n if (!is.fn(callback)) {\n throw new TypeError('Third argument must be a Function');\n }\n\n if (is.node(target)) {\n return listenNode(target, type, callback);\n }\n else if (is.nodeList(target)) {\n return listenNodeList(target, type, callback);\n }\n else if (is.string(target)) {\n return listenSelector(target, type, callback);\n }\n else {\n throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n node.addEventListener(type, callback);\n\n return {\n destroy: function() {\n node.removeEventListener(type, callback);\n }\n }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.addEventListener(type, callback);\n });\n\n return {\n destroy: function() {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.removeEventListener(type, callback);\n });\n }\n }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n var selectedText;\n\n if (element.nodeName === 'SELECT') {\n element.focus();\n\n selectedText = element.value;\n }\n else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n var isReadOnly = element.hasAttribute('readonly');\n\n if (!isReadOnly) {\n element.setAttribute('readonly', '');\n }\n\n element.select();\n element.setSelectionRange(0, element.value.length);\n\n if (!isReadOnly) {\n element.removeAttribute('readonly');\n }\n\n selectedText = element.value;\n }\n else {\n if (element.hasAttribute('contenteditable')) {\n element.focus();\n }\n\n var selection = window.getSelection();\n var range = document.createRange();\n\n range.selectNodeContents(element);\n selection.removeAllRanges();\n selection.addRange(range);\n\n selectedText = selection.toString();\n }\n\n return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n // Keep this empty so it's easier to inherit from\n // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n on: function (name, callback, ctx) {\n var e = this.e || (this.e = {});\n\n (e[name] || (e[name] = [])).push({\n fn: callback,\n ctx: ctx\n });\n\n return this;\n },\n\n once: function (name, callback, ctx) {\n var self = this;\n function listener () {\n self.off(name, listener);\n callback.apply(ctx, arguments);\n };\n\n listener._ = callback\n return this.on(name, listener, ctx);\n },\n\n emit: function (name) {\n var data = [].slice.call(arguments, 1);\n var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n var i = 0;\n var len = evtArr.length;\n\n for (i; i < len; i++) {\n evtArr[i].fn.apply(evtArr[i].ctx, data);\n }\n\n return this;\n },\n\n off: function (name, callback) {\n var e = this.e || (this.e = {});\n var evts = e[name];\n var liveEvents = [];\n\n if (evts && callback) {\n for (var i = 0, len = evts.length; i < len; i++) {\n if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n liveEvents.push(evts[i]);\n }\n }\n\n // Remove event from queue to prevent memory leak\n // Suggested by https://github.com/lazd\n // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n (liveEvents.length)\n ? e[name] = liveEvents\n : delete e[name];\n\n return this;\n }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(134);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n var str = '' + string;\n var match = matchHtmlRegExp.exec(str);\n\n if (!match) {\n return str;\n }\n\n var escape;\n var html = '';\n var index = 0;\n var lastIndex = 0;\n\n for (index = match.index; index < str.length; index++) {\n switch (str.charCodeAt(index)) {\n case 34: // \"\n escape = '"';\n break;\n case 38: // &\n escape = '&';\n break;\n case 39: // '\n escape = ''';\n break;\n case 60: // <\n escape = '<';\n break;\n case 62: // >\n escape = '>';\n break;\n default:\n continue;\n }\n\n if (lastIndex !== index) {\n html += str.substring(lastIndex, index);\n }\n\n lastIndex = index + 1;\n html += escape;\n }\n\n return lastIndex !== index\n ? html + str.substring(lastIndex, index)\n : html;\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\nimport {\n EMPTY,\n NEVER,\n Subject,\n defer,\n delay,\n filter,\n map,\n merge,\n mergeWith,\n shareReplay,\n switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n at,\n getOptionalElement,\n requestJSON,\n setToggle,\n watchDocument,\n watchKeyboard,\n watchLocation,\n watchLocationTarget,\n watchMedia,\n watchPrint,\n watchViewport\n} from \"./browser\"\nimport {\n getComponentElement,\n getComponentElements,\n mountBackToTop,\n mountContent,\n mountDialog,\n mountHeader,\n mountHeaderTitle,\n mountPalette,\n mountSearch,\n mountSearchHiglight,\n mountSidebar,\n mountSource,\n mountTableOfContents,\n mountTabs,\n watchHeader,\n watchMain\n} from \"./components\"\nimport {\n SearchIndex,\n setupClipboardJS,\n setupInstantLoading,\n setupVersionSelector\n} from \"./integrations\"\nimport {\n patchIndeterminate,\n patchScrollfix,\n patchScrolllock\n} from \"./patches\"\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$ = watchLocationTarget()\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$ = watchMedia(\"(min-width: 960px)\")\nconst screen$ = watchMedia(\"(min-width: 1220px)\")\nconst print$ = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n ? __search?.index || requestJSON(\n new URL(\"search/search_index.json\", config.base)\n )\n : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject()\nsetupClipboardJS({ alert$ })\n\n/* Set up instant loading, if enabled */\nif (feature(\"navigation.instant\"))\n setupInstantLoading({ document$, location$, viewport$ })\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n setupVersionSelector()\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n .pipe(\n delay(125)\n )\n .subscribe(() => {\n setToggle(\"drawer\", false)\n setToggle(\"search\", false)\n })\n\n/* Set up global keyboard handlers */\nkeyboard$\n .pipe(\n filter(({ mode }) => mode === \"global\")\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Go to previous page */\n case \"p\":\n case \",\":\n const prev = getOptionalElement(\"[href][rel=prev]\")\n if (typeof prev !== \"undefined\")\n prev.click()\n break\n\n /* Go to next page */\n case \"n\":\n case \".\":\n const next = getOptionalElement(\"[href][rel=next]\")\n if (typeof next !== \"undefined\")\n next.click()\n break\n }\n })\n\n/* Set up patches */\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n .pipe(\n map(() => getComponentElement(\"main\")),\n switchMap(el => watchMain(el, { viewport$, header$ })),\n shareReplay(1)\n )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n /* Dialog */\n ...getComponentElements(\"dialog\")\n .map(el => mountDialog(el, { alert$ })),\n\n /* Header */\n ...getComponentElements(\"header\")\n .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n /* Color palette */\n ...getComponentElements(\"palette\")\n .map(el => mountPalette(el)),\n\n /* Search */\n ...getComponentElements(\"search\")\n .map(el => mountSearch(el, { index$, keyboard$ })),\n\n /* Repository information */\n ...getComponentElements(\"source\")\n .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n /* Content */\n ...getComponentElements(\"content\")\n .map(el => mountContent(el, { target$, print$ })),\n\n /* Search highlighting */\n ...getComponentElements(\"content\")\n .map(el => feature(\"search.highlight\")\n ? mountSearchHiglight(el, { index$, location$ })\n : EMPTY\n ),\n\n /* Header title */\n ...getComponentElements(\"header-title\")\n .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n /* Sidebar */\n ...getComponentElements(\"sidebar\")\n .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n ),\n\n /* Navigation tabs */\n ...getComponentElements(\"tabs\")\n .map(el => mountTabs(el, { viewport$, header$ })),\n\n /* Table of contents */\n ...getComponentElements(\"toc\")\n .map(el => mountTableOfContents(el, { viewport$, header$ })),\n\n /* Back-to-top button */\n ...getComponentElements(\"top\")\n .map(el => mountBackToTop(el, { viewport$, header$, main$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n .pipe(\n switchMap(() => content$),\n mergeWith(control$),\n shareReplay(1)\n )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$ = document$ /* Document observable */\nwindow.location$ = location$ /* Location subject */\nwindow.target$ = target$ /* Location target observable */\nwindow.keyboard$ = keyboard$ /* Keyboard observable */\nwindow.viewport$ = viewport$ /* Viewport observable */\nwindow.tablet$ = tablet$ /* Media tablet observable */\nwindow.screen$ = screen$ /* Media screen observable */\nwindow.print$ = print$ /* Media print observable */\nwindow.alert$ = alert$ /* Alert subject */\nwindow.component$ = component$ /* Component observable */\n", "import tslib from '../tslib.js';\r\nconst {\r\n __extends,\r\n __assign,\r\n __rest,\r\n __decorate,\r\n __param,\r\n __metadata,\r\n __awaiter,\r\n __generator,\r\n __exportStar,\r\n __createBinding,\r\n __values,\r\n __read,\r\n __spread,\r\n __spreadArrays,\r\n __spreadArray,\r\n __await,\r\n __asyncGenerator,\r\n __asyncDelegator,\r\n __asyncValues,\r\n __makeTemplateObject,\r\n __importStar,\r\n __importDefault,\r\n __classPrivateFieldGet,\r\n __classPrivateFieldSet,\r\n} = tslib;\r\nexport {\r\n __extends,\r\n __assign,\r\n __rest,\r\n __decorate,\r\n __param,\r\n __metadata,\r\n __awaiter,\r\n __generator,\r\n __exportStar,\r\n __createBinding,\r\n __values,\r\n __read,\r\n __spread,\r\n __spreadArrays,\r\n __spreadArray,\r\n __await,\r\n __asyncGenerator,\r\n __asyncDelegator,\r\n __asyncValues,\r\n __makeTemplateObject,\r\n __importStar,\r\n __importDefault,\r\n __classPrivateFieldGet,\r\n __classPrivateFieldSet,\r\n};\r\n", null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n ReplaySubject,\n Subject,\n fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject {\n const document$ = new ReplaySubject(1)\n fromEvent(document, \"DOMContentLoaded\", { once: true })\n .subscribe(() => document$.next(document))\n\n /* Return document */\n return document$\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements(\n selector: string, node?: ParentNode\n): T[]\n\nexport function getElements(\n selector: string, node: ParentNode = document\n): T[] {\n return Array.from(node.querySelectorAll(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement(\n selector: string, node?: ParentNode\n): T\n\nexport function getElement(\n selector: string, node: ParentNode = document\n): T {\n const el = getOptionalElement(selector, node)\n if (typeof el === \"undefined\")\n throw new ReferenceError(\n `Missing element: expected \"${selector}\" to be present`\n )\n\n /* Return element */\n return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement(\n selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement(\n selector: string, node: ParentNode = document\n): T | undefined {\n return node.querySelector(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n return document.activeElement instanceof HTMLElement\n ? document.activeElement || undefined\n : undefined\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n debounceTime,\n distinctUntilChanged,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * Previously, this function used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(document.body, \"focusin\"),\n fromEvent(document.body, \"focusout\")\n )\n .pipe(\n debounceTime(1),\n map(() => {\n const active = getActiveElement()\n return typeof active !== \"undefined\"\n ? el.contains(active)\n : false\n }),\n startWith(el === getActiveElement()),\n distinctUntilChanged()\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n animationFrameScheduler,\n auditTime,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n x: number /* Horizontal offset */\n y: number /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n el: HTMLElement\n): ElementOffset {\n return {\n x: el.offsetLeft,\n y: el.offsetTop\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(window, \"load\"),\n fromEvent(window, \"resize\")\n )\n .pipe(\n auditTime(0, animationFrameScheduler),\n map(() => getElementOffset(el)),\n startWith(getElementOffset(el))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n animationFrameScheduler,\n auditTime,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n el: HTMLElement\n): ElementOffset {\n return {\n x: el.scrollLeft,\n y: el.scrollTop\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(el, \"scroll\"),\n fromEvent(window, \"resize\")\n )\n .pipe(\n auditTime(0, animationFrameScheduler),\n map(() => getElementContentOffset(el)),\n startWith(getElementContentOffset(el))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n NEVER,\n Observable,\n Subject,\n defer,\n filter,\n finalize,\n map,\n merge,\n of,\n shareReplay,\n startWith,\n switchMap,\n tap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n width: number /* Element width */\n height: number /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n new ResizeObserver(entries => {\n for (const entry of entries)\n entry$.next(entry)\n })\n))\n .pipe(\n switchMap(observer => merge(NEVER, of(observer))\n .pipe(\n finalize(() => observer.disconnect())\n )\n ),\n shareReplay(1)\n )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n el: HTMLElement\n): ElementSize {\n return {\n width: el.offsetWidth,\n height: el.offsetHeight\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n el: HTMLElement\n): Observable {\n return observer$\n .pipe(\n tap(observer => observer.observe(el)),\n switchMap(observer => entry$\n .pipe(\n filter(({ target }) => target === el),\n finalize(() => observer.unobserve(el)),\n map(() => getElementSize(el))\n )\n ),\n startWith(getElementSize(el))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n el: HTMLElement\n): ElementSize {\n return {\n width: el.scrollWidth,\n height: el.scrollHeight\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n NEVER,\n Observable,\n Subject,\n defer,\n distinctUntilChanged,\n filter,\n finalize,\n map,\n merge,\n of,\n shareReplay,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport {\n getElementContentSize,\n getElementSize,\n watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n new IntersectionObserver(entries => {\n for (const entry of entries)\n entry$.next(entry)\n }, {\n threshold: 1\n })\n))\n .pipe(\n switchMap(observer => merge(NEVER, of(observer))\n .pipe(\n finalize(() => observer.disconnect())\n )\n ),\n shareReplay(1)\n )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n el: HTMLElement\n): Observable {\n return observer$\n .pipe(\n tap(observer => observer.observe(el)),\n switchMap(observer => entry$\n .pipe(\n filter(({ target }) => target === el),\n finalize(() => observer.unobserve(el)),\n map(({ isIntersecting }) => isIntersecting)\n )\n )\n )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n el: HTMLElement, threshold = 16\n): Observable {\n return watchElementContentOffset(el)\n .pipe(\n map(({ y }) => {\n const visible = getElementSize(el)\n const content = getElementContentSize(el)\n return y >= (\n content.height - visible.height - threshold\n )\n }),\n distinctUntilChanged()\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n | \"drawer\" /* Toggle for drawer */\n | \"search\" /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record = {\n drawer: getElement(\"[data-md-toggle=drawer]\"),\n search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n if (toggles[name].checked !== value)\n toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable {\n const el = toggles[name]\n return fromEvent(el, \"change\")\n .pipe(\n map(() => el.checked),\n startWith(el.checked)\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n map,\n share\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n | \"global\" /* Global */\n | \"search\" /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n mode: KeyboardMode /* Keyboard mode */\n type: string /* Key type */\n claim(): void /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n el: HTMLElement, type: string\n): boolean {\n switch (el.constructor) {\n\n /* Input elements */\n case HTMLInputElement:\n /* @ts-expect-error - omit unnecessary type cast */\n if (el.type === \"radio\")\n return /^Arrow/.test(type)\n else\n return true\n\n /* Select element and textarea */\n case HTMLSelectElement:\n case HTMLTextAreaElement:\n return true\n\n /* Everything else */\n default:\n return el.isContentEditable\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable {\n return fromEvent(window, \"keydown\")\n .pipe(\n filter(ev => !(ev.metaKey || ev.ctrlKey)),\n map(ev => ({\n mode: getToggle(\"search\") ? \"search\" : \"global\",\n type: ev.key,\n claim() {\n ev.preventDefault()\n ev.stopPropagation()\n }\n } as Keyboard)),\n filter(({ mode, type }) => {\n if (mode === \"global\") {\n const active = getActiveElement()\n if (typeof active !== \"undefined\")\n return !isSusceptibleToKeyboard(active, type)\n }\n return true\n }),\n share()\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * @param url - URL to change to\n */\nexport function setLocation(url: URL): void {\n location.href = url.href\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject {\n return new Subject()\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n & JSXInternal.HTMLAttributes\n & JSXInternal.SVGAttributes\n & Record\n\n/**\n * Child element\n */\ntype Child =\n | HTMLElement\n | Text\n | string\n | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n /* Handle primitive types (including raw HTML) */\n if (typeof child === \"string\" || typeof child === \"number\") {\n el.innerHTML += child.toString()\n\n /* Handle nodes */\n } else if (child instanceof Node) {\n el.appendChild(child)\n\n /* Handle nested children */\n } else if (Array.isArray(child)) {\n for (const node of child)\n appendChild(el, node)\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h(\n tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h(\n tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h(\n tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n const el = document.createElement(tag)\n\n /* Set attributes, if any */\n if (attributes)\n for (const attr of Object.keys(attributes))\n if (typeof attributes[attr] !== \"boolean\")\n el.setAttribute(attr, attributes[attr])\n else if (attributes[attr])\n el.setAttribute(attr, \"\")\n\n /* Append child nodes */\n for (const child of children)\n appendChild(el, child)\n\n /* Return element */\n return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n namespace JSX {\n type Element = HTMLElement\n type IntrinsicElements = JSXInternal.IntrinsicElements\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Truncate a string after the given number of characters\n *\n * This is not a very reasonable approach, since the summaries kind of suck.\n * It would be better to create something more intelligent, highlighting the\n * search occurrences and making a better summary out of it, but this note was\n * written three years ago, so who knows if we'll ever fix it.\n *\n * @param value - Value to be truncated\n * @param n - Number of characters\n *\n * @returns Truncated value\n */\nexport function truncate(value: string, n: number): string {\n let i = n\n if (value.length > i) {\n while (value[i] !== \" \" && --i > 0) { /* keep eating */ }\n return `${value.substring(0, i)}...`\n }\n return value\n}\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n if (value > 999) {\n const digits = +((value - 950) % 1000 > 99)\n return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n } else {\n return value.toString()\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n map,\n shareReplay,\n startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n return location.hash.substring(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n const el = h(\"a\", { href: hash })\n el.addEventListener(\"click\", ev => ev.stopPropagation())\n el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(): Observable {\n return fromEvent(window, \"hashchange\")\n .pipe(\n map(getLocationHash),\n startWith(getLocationHash()),\n filter(hash => hash.length > 0),\n shareReplay(1)\n )\n}\n\n/**\n * Watch location target\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(): Observable {\n return watchLocationHash()\n .pipe(\n map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n filter(el => typeof el !== \"undefined\")\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n fromEvent,\n fromEventPattern,\n mapTo,\n merge,\n startWith,\n switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable {\n const media = matchMedia(query)\n return fromEventPattern(next => (\n media.addListener(() => next(media.matches))\n ))\n .pipe(\n startWith(media.matches)\n )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable {\n const media = matchMedia(\"print\")\n return merge(\n fromEvent(window, \"beforeprint\").pipe(mapTo(true)),\n fromEvent(window, \"afterprint\").pipe(mapTo(false))\n )\n .pipe(\n startWith(media.matches)\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at(\n query$: Observable, factory: () => Observable\n): Observable {\n return query$\n .pipe(\n switchMap(active => active ? factory() : EMPTY)\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n catchError,\n filter,\n from,\n map,\n shareReplay,\n switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * If the request fails (e.g. when dispatched from `file://` locations), the\n * observable will complete without emitting a value.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Response observable\n */\nexport function request(\n url: URL | string, options: RequestInit = { credentials: \"same-origin\" }\n): Observable {\n return from(fetch(`${url}`, options))\n .pipe(\n filter(res => res.status === 200),\n catchError(() => EMPTY)\n )\n}\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON(\n url: URL | string, options?: RequestInit\n): Observable {\n return request(url, options)\n .pipe(\n switchMap(res => res.json()),\n shareReplay(1)\n )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n url: URL | string, options?: RequestInit\n): Observable {\n const dom = new DOMParser()\n return request(url, options)\n .pipe(\n switchMap(res => res.text()),\n map(res => dom.parseFromString(res, \"text/xml\")),\n shareReplay(1)\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n x: number /* Horizontal offset */\n y: number /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n return {\n x: Math.max(0, scrollX),\n y: Math.max(0, scrollY)\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable {\n return merge(\n fromEvent(window, \"scroll\", { passive: true }),\n fromEvent(window, \"resize\", { passive: true })\n )\n .pipe(\n map(getViewportOffset),\n startWith(getViewportOffset())\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n width: number /* Viewport width */\n height: number /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n return {\n width: innerWidth,\n height: innerHeight\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable {\n return fromEvent(window, \"resize\", { passive: true })\n .pipe(\n map(getViewportSize),\n startWith(getViewportSize())\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n map,\n shareReplay\n} from \"rxjs\"\n\nimport {\n ViewportOffset,\n watchViewportOffset\n} from \"../offset\"\nimport {\n ViewportSize,\n watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n offset: ViewportOffset /* Viewport offset */\n size: ViewportSize /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable {\n return combineLatest([\n watchViewportOffset(),\n watchViewportSize()\n ])\n .pipe(\n map(([offset, size]) => ({ offset, size })),\n shareReplay(1)\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n distinctUntilKeyChanged,\n map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
/* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n const size$ = viewport$\n .pipe(\n distinctUntilKeyChanged(\"size\")\n )\n\n /* Compute element offset */\n const offset$ = combineLatest([size$, header$])\n .pipe(\n map(() => getElementOffset(el))\n )\n\n /* Compute relative viewport, return hot observable */\n return combineLatest([header$, viewport$, offset$])\n .pipe(\n map(([{ height }, { offset, size }, { x, y }]) => ({\n offset: {\n x: offset.x - x,\n y: offset.y - y + height\n },\n size\n }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n fromEvent,\n map,\n share,\n switchMapTo,\n tap,\n throttle\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n type: unknown /* Message type */\n data?: unknown /* Message data */\n}\n\n/**\n * Worker handler\n *\n * @template T - Message type\n */\nexport interface WorkerHandler<\n T extends WorkerMessage\n> {\n tx$: Subject /* Message transmission subject */\n rx$: Observable /* Message receive observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n *\n * @template T - Worker message type\n */\ninterface WatchOptions {\n tx$: Observable /* Message transmission observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch a web worker\n *\n * This function returns an observable that sends all values emitted by the\n * message observable to the web worker. Web worker communication is expected\n * to be bidirectional (request-response) and synchronous. Messages that are\n * emitted during a pending request are throttled, the last one is emitted.\n *\n * @param worker - Web worker\n * @param options - Options\n *\n * @returns Worker message observable\n */\nexport function watchWorker(\n worker: Worker, { tx$ }: WatchOptions\n): Observable {\n\n /* Intercept messages from worker-like objects */\n const rx$ = fromEvent(worker, \"message\")\n .pipe(\n map(({ data }) => data as T)\n )\n\n /* Send and receive messages, return hot observable */\n return tx$\n .pipe(\n throttle(() => rx$, { leading: true, trailing: true }),\n tap(message => worker.postMessage(message)),\n switchMapTo(rx$),\n share()\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n | \"content.code.annotate\" /* Code annotations */\n | \"header.autohide\" /* Hide header */\n | \"navigation.expand\" /* Automatic expansion */\n | \"navigation.indexes\" /* Section pages */\n | \"navigation.instant\" /* Instant loading */\n | \"navigation.sections\" /* Section navigation */\n | \"navigation.tabs\" /* Tabs navigation */\n | \"navigation.tabs.sticky\" /* Tabs navigation (sticky) */\n | \"navigation.top\" /* Back-to-top button */\n | \"navigation.tracking\" /* Anchor tracking */\n | \"search.highlight\" /* Search highlighting */\n | \"search.share\" /* Search sharing */\n | \"search.suggest\" /* Search suggestions */\n | \"toc.integrate\" /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n | \"clipboard.copy\" /* Copy to clipboard */\n | \"clipboard.copied\" /* Copied to clipboard */\n | \"search.config.lang\" /* Search language */\n | \"search.config.pipeline\" /* Search pipeline */\n | \"search.config.separator\" /* Search separator */\n | \"search.placeholder\" /* Search */\n | \"search.result.placeholder\" /* Type to start searching */\n | \"search.result.none\" /* No matching documents */\n | \"search.result.one\" /* 1 matching document */\n | \"search.result.other\" /* # matching documents */\n | \"search.result.more.one\" /* 1 more on this page */\n | \"search.result.more.other\" /* # more on this page */\n | \"search.result.term.missing\" /* Missing */\n | \"select.version.title\" /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations = Record\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n provider: \"mike\" /* Version provider */\n default?: string /* Default version */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n base: string /* Base URL */\n features: Flag[] /* Feature flags */\n translations: Translations /* Translations */\n search: string /* Search worker URL */\n version?: Versioning /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n key: Translation, value?: string | number\n): string {\n return typeof value !== \"undefined\"\n ? config.translations[key].replace(\"#\", value.toString())\n : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n | \"announce\" /* Announcement bar */\n | \"container\" /* Container */\n | \"content\" /* Content */\n | \"dialog\" /* Dialog */\n | \"header\" /* Header */\n | \"header-title\" /* Header title */\n | \"header-topic\" /* Header topic */\n | \"main\" /* Main area */\n | \"outdated\" /* Version warning */\n | \"palette\" /* Color palette */\n | \"search\" /* Search */\n | \"search-query\" /* Search input */\n | \"search-result\" /* Search results */\n | \"search-share\" /* Search sharing */\n | \"search-suggest\" /* Search suggestions */\n | \"sidebar\" /* Sidebar */\n | \"skip\" /* Skip link */\n | \"source\" /* Repository information */\n | \"tabs\" /* Navigation tabs */\n | \"toc\" /* Table of contents */\n | \"top\" /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n T extends {} = {},\n U extends HTMLElement = HTMLElement\n> =\n T & {\n ref: U /* Component reference */\n }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n \"announce\": HTMLElement /* Announcement bar */\n \"container\": HTMLElement /* Container */\n \"content\": HTMLElement /* Content */\n \"dialog\": HTMLElement /* Dialog */\n \"header\": HTMLElement /* Header */\n \"header-title\": HTMLElement /* Header title */\n \"header-topic\": HTMLElement /* Header topic */\n \"main\": HTMLElement /* Main area */\n \"outdated\": HTMLElement /* Version warning */\n \"palette\": HTMLElement /* Color palette */\n \"search\": HTMLElement /* Search */\n \"search-query\": HTMLInputElement /* Search input */\n \"search-result\": HTMLElement /* Search results */\n \"search-share\": HTMLAnchorElement /* Search sharing */\n \"search-suggest\": HTMLElement /* Search suggestions */\n \"sidebar\": HTMLElement /* Sidebar */\n \"skip\": HTMLAnchorElement /* Skip link */\n \"source\": HTMLAnchorElement /* Repository information */\n \"tabs\": HTMLElement /* Navigation tabs */\n \"toc\": HTMLElement /* Table of contents */\n \"top\": HTMLAnchorElement /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement(\n type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements(\n type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n finalize,\n map,\n mergeWith,\n switchMap,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n getElementContentSize,\n watchElementSize\n} from \"~/browser\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../_\"\nimport {\n Annotation,\n mountAnnotationList\n} from \"../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block\n */\nexport interface CodeBlock {\n scrollable: boolean /* Code block overflows */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for Clipboard.js integration\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n if (el.nextElementSibling) {\n const sibling = el.nextElementSibling as HTMLElement\n if (sibling.tagName === \"OL\")\n return sibling\n\n /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n else if (sibling.tagName === \"P\" && !sibling.children.length)\n return findCandidateList(sibling)\n }\n\n /* Everything else */\n return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n el: HTMLElement\n): Observable {\n return watchElementSize(el)\n .pipe(\n map(({ width }) => {\n const content = getElementContentSize(el)\n return {\n scrollable: content.width > width\n }\n }),\n distinctUntilKeyChanged(\"scrollable\")\n )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n el: HTMLElement, options: MountOptions\n): Observable> {\n const { matches: hover } = matchMedia(\"(hover)\")\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ scrollable }) => {\n if (scrollable && hover)\n el.setAttribute(\"tabindex\", \"0\")\n else\n el.removeAttribute(\"tabindex\")\n })\n\n /* Render button for Clipboard.js integration */\n if (ClipboardJS.isSupported()) {\n const parent = el.closest(\"pre\")!\n parent.id = `__code_${++sequence}`\n parent.insertBefore(\n renderClipboardButton(parent.id),\n el\n )\n }\n\n /* Handle code annotations */\n const container = el.closest([\n \":not(td):not(.code) > .highlight\",\n \".highlighttable\"\n ].join(\", \"))\n if (container instanceof HTMLElement) {\n const list = findCandidateList(container)\n\n /* Mount code annotations, if enabled */\n if (typeof list !== \"undefined\" && (\n container.classList.contains(\"annotate\") ||\n feature(\"content.code.annotate\")\n )) {\n const annotations$ = mountAnnotationList(list, el, options)\n\n /* Create and return component */\n return watchCodeBlock(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state })),\n mergeWith(watchElementSize(container)\n .pipe(\n takeUntil(push$.pipe(takeLast(1))),\n map(({ width, height }) => width && height),\n distinctUntilChanged(),\n switchMap(active => active ? annotations$ : EMPTY)\n )\n )\n )\n }\n }\n\n /* Create and return component */\n return watchCodeBlock(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an empty annotation\n *\n * @param id - Annotation identifier\n *\n * @returns Element\n */\nexport function renderAnnotation(id: number): HTMLElement {\n return (\n \n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n return (\n code`}\n >\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { feature, translation } from \"~/_\"\nimport {\n SearchDocument,\n SearchMetadata,\n SearchResultItem\n} from \"~/integrations/search\"\nimport { h, truncate } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n TEASER = 1, /* Render teaser */\n PARENT = 2 /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n document: SearchDocument & SearchMetadata, flag: Flag\n): HTMLElement {\n const parent = flag & Flag.PARENT\n const teaser = flag & Flag.TEASER\n\n /* Render missing query terms */\n const missing = Object.keys(document.terms)\n .filter(key => !document.terms[key])\n .map(key => [{key}, \" \"])\n .flat()\n .slice(0, -1)\n\n /* Assemble query string for highlighting */\n const url = new URL(document.location)\n if (feature(\"search.highlight\"))\n url.searchParams.set(\"h\", Object.entries(document.terms)\n .filter(([, match]) => match)\n .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n )\n\n /* Render article or section, depending on flags */\n return (\n \n \n {parent > 0 &&
}\n

{document.title}

\n {teaser > 0 && document.text.length > 0 &&\n

\n {truncate(document.text, 320)}\n

\n }\n {teaser > 0 && missing.length > 0 &&\n

\n {translation(\"search.result.term.missing\")}: {...missing}\n

\n }\n \n \n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n result: SearchResultItem\n): HTMLElement {\n const threshold = result[0].score\n const docs = [...result]\n\n /* Find and extract parent article */\n const parent = docs.findIndex(doc => !doc.location.includes(\"#\"))\n const [article] = docs.splice(parent, 1)\n\n /* Determine last index above threshold */\n let index = docs.findIndex(doc => doc.score < threshold)\n if (index === -1)\n index = docs.length\n\n /* Partition sections */\n const best = docs.slice(0, index)\n const more = docs.slice(index)\n\n /* Render children */\n const children = [\n renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n ...more.length ? [\n
\n \n {more.length > 0 && more.length === 1\n ? translation(\"search.result.more.one\")\n : translation(\"search.result.more.other\", more.length)\n }\n \n {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n
\n ] : []\n ]\n\n /* Render search result */\n return (\n
  • \n {children}\n
    • \n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n return (\n
      \n {Object.entries(facts).map(([key, value]) => (\n
    • \n {typeof value === \"number\" ? round(value) : value}\n
      • \n ))}\n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n return (\n
    \n
    \n {table}\n
    \n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version\n */\nexport interface Version {\n version: string /* Version identifier */\n title: string /* Version title */\n aliases: string[] /* Version aliases */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n const config = configuration()\n\n /* Ensure trailing slash, see https://bit.ly/3rL5u3f */\n const url = new URL(`../${version.version}/`, config.base)\n return (\n
  • \n \n {version.title}\n \n
    • \n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n versions: Version[], active: Version\n): HTMLElement {\n return (\n
    \n \n {active.title}\n \n
      \n {versions.map(renderVersion)}\n
    \n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n animationFrameScheduler,\n combineLatest,\n defer,\n finalize,\n fromEvent,\n map,\n switchMap,\n take,\n tap,\n throttleTime\n} from \"rxjs\"\n\nimport {\n ElementOffset,\n getElement,\n getElementSize,\n watchElementContentOffset,\n watchElementFocus,\n watchElementOffset\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n active: boolean /* Annotation is active */\n offset: ElementOffset /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n el: HTMLElement, container: HTMLElement\n): Observable {\n const offset$ = defer(() => combineLatest([\n watchElementOffset(el),\n watchElementContentOffset(container)\n ]))\n .pipe(\n map(([{ x, y }, scroll]) => {\n const { width } = getElementSize(el)\n return ({\n x: x - scroll.x + width / 2,\n y: y - scroll.y\n })\n })\n )\n\n /* Actively watch annotation on focus */\n return watchElementFocus(el)\n .pipe(\n switchMap(active => offset$\n .pipe(\n map(offset => ({ active, offset })),\n take(+!active || Infinity)\n )\n )\n )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n el: HTMLElement, container: HTMLElement\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe({\n\n /* Handle emission */\n next({ offset }) {\n el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-tooltip-x\")\n el.style.removeProperty(\"--md-tooltip-y\")\n }\n })\n\n /* Track relative origin of tooltip */\n push$\n .pipe(\n throttleTime(500, animationFrameScheduler),\n map(() => container.getBoundingClientRect()),\n map(({ x }) => x)\n )\n .subscribe({\n\n /* Handle emission */\n next(origin) {\n if (origin)\n el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n else\n el.style.removeProperty(\"--md-tooltip-0\")\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-tooltip-0\")\n }\n })\n\n /* Close open annotation on click */\n const index = getElement(\":scope > :last-child\", el)\n const blur$ = fromEvent(index, \"mousedown\", { once: true })\n push$\n .pipe(\n switchMap(({ active }) => active ? blur$ : EMPTY),\n tap(ev => ev.preventDefault())\n )\n .subscribe(() => el.blur())\n\n /* Create and return component */\n return watchAnnotation(el, container)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n finalize,\n merge,\n share,\n takeLast,\n takeUntil\n} from \"rxjs\"\n\nimport {\n getElement,\n getElements\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n Annotation,\n mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation markers in the given code block\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findAnnotationMarkers(container: HTMLElement): Text[] {\n const markers: Text[] = []\n for (const comment of getElements(\".c, .c1, .cm\", container)) {\n let match: RegExpExecArray | null\n let text = comment.firstChild as Text\n\n /* Split text at marker and add to list */\n while ((match = /\\((\\d+)\\)/.exec(text.textContent!))) {\n const marker = text.splitText(match.index)\n text = marker.splitText(match[0].length)\n markers.push(marker)\n }\n }\n return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n el: HTMLElement, container: HTMLElement, { print$ }: MountOptions\n): Observable> {\n\n /* Find and replace all markers with empty annotations */\n const annotations = new Map()\n for (const marker of findAnnotationMarkers(container)) {\n const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n annotations.set(+id, renderAnnotation(+id))\n marker.replaceWith(annotations.get(+id)!)\n }\n\n /* Keep list if there are no annotations to render */\n if (annotations.size === 0)\n return EMPTY\n\n /* Create and return component */\n return defer(() => {\n const done$ = new Subject()\n\n /* Handle print mode - see https://bit.ly/3rgPdpt */\n print$\n .pipe(\n takeUntil(done$.pipe(takeLast(1)))\n )\n .subscribe(active => {\n el.hidden = !active\n\n /* Show annotations in code block or list (print) */\n for (const [id, annotation] of annotations) {\n const inner = getElement(\".md-typeset\", annotation)\n const child = getElement(`li:nth-child(${id})`, el)\n if (!active)\n swap(child, inner)\n else\n swap(inner, child)\n }\n })\n\n /* Create and return component */\n return merge(...[...annotations]\n .map(([, annotation]) => (\n mountAnnotation(annotation, container)\n ))\n )\n .pipe(\n finalize(() => done$.complete()),\n share()\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n filter,\n finalize,\n map,\n mapTo,\n merge,\n tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n action: \"open\" | \"close\" /* Details state */\n reveal?: boolean /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable
    {\n let open = true\n return merge(\n\n /* Open and focus details on location target */\n target$\n .pipe(\n map(target => target.closest(\"details:not([open])\")!),\n filter(details => el === details),\n mapTo
    ({ action: \"open\", reveal: true })\n ),\n\n /* Open details on print and close afterwards */\n print$\n .pipe(\n filter(active => active || !open),\n tap(() => open = el.open),\n map(active => ({\n action: active ? \"open\" : \"close\"\n }) as Details)\n )\n )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n el: HTMLDetailsElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject
    ()\n push$.subscribe(({ action, reveal }) => {\n if (action === \"open\")\n el.setAttribute(\"open\", \"\")\n else\n el.removeAttribute(\"open\")\n if (reveal)\n el.scrollIntoView()\n })\n\n /* Create and return component */\n return watchDetails(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n el: HTMLElement\n): Observable> {\n el.replaceWith(sentinel)\n sentinel.replaceWith(renderTable(el))\n\n /* Create and return component */\n return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n animationFrameScheduler,\n auditTime,\n combineLatest,\n defer,\n finalize,\n fromEvent,\n map,\n mapTo,\n merge,\n startWith,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport {\n getElement,\n getElementOffset,\n getElementSize,\n getElements,\n watchElementSize\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n active: HTMLLabelElement /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param el - Content tabs element\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n el: HTMLElement\n): Observable {\n const inputs = getElements(\":scope > input\", el)\n return merge(...inputs.map(input => fromEvent(input, \"change\")\n .pipe(\n mapTo({\n active: getElement(`label[for=${input.id}]`)\n })\n )\n ))\n .pipe(\n startWith({\n active: getElement(`label[for=${inputs[0].id}]`)\n } as ContentTabs)\n )\n}\n\n/**\n * Mount content tabs\n *\n * This function scrolls the active tab into view. While this functionality is\n * provided by browsers as part of `scrollInfoView`, browsers will always also\n * scroll the vertical axis, which we do not want. Thus, we decided to provide\n * this functionality ourselves.\n *\n * @param el - Content tabs element\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n el: HTMLElement\n): Observable> {\n const container = getElement(\".tabbed-labels\", el)\n return defer(() => {\n const push$ = new Subject()\n combineLatest([push$, watchElementSize(el)])\n .pipe(\n auditTime(1, animationFrameScheduler),\n takeUntil(push$.pipe(takeLast(1)))\n )\n .subscribe({\n\n /* Handle emission */\n next([{ active }]) {\n const offset = getElementOffset(active)\n const { width } = getElementSize(active)\n\n /* Set tab indicator offset and width */\n el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n /* Smoothly scroll container */\n container.scrollTo({\n behavior: \"smooth\",\n left: offset.x\n })\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-indicator-x\")\n el.style.removeProperty(\"--md-indicator-width\")\n }\n })\n\n /* Create and return component */\n return watchContentTabs(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Annotation } from \"../annotation\"\nimport { CodeBlock, mountCodeBlock } from \"../code\"\nimport { Details, mountDetails } from \"../details\"\nimport { DataTable, mountDataTable } from \"../table\"\nimport { ContentTabs, mountContentTabs } from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n | Annotation\n | ContentTabs\n | CodeBlock\n | DataTable\n | Details\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n el: HTMLElement, { target$, print$ }: MountOptions\n): Observable> {\n return merge(\n\n /* Code blocks */\n ...getElements(\"pre > code\", el)\n .map(child => mountCodeBlock(child, { print$ })),\n\n /* Data tables */\n ...getElements(\"table:not([class])\", el)\n .map(child => mountDataTable(child)),\n\n /* Details */\n ...getElements(\"details\", el)\n .map(child => mountDetails(child, { target$, print$ })),\n\n /* Content tabs */\n ...getElements(\"[data-tabs]\", el)\n .map(child => mountContentTabs(child))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n delay,\n finalize,\n map,\n merge,\n of,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n message: string /* Dialog message */\n active: boolean /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n alert$: Subject /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n alert$: Subject /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n _el: HTMLElement, { alert$ }: WatchOptions\n): Observable {\n return alert$\n .pipe(\n switchMap(message => merge(\n of(true),\n of(false).pipe(delay(2000))\n )\n .pipe(\n map(active => ({ message, active }))\n )\n )\n )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n el: HTMLElement, options: MountOptions\n): Observable> {\n const inner = getElement(\".md-typeset\", el)\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ message, active }) => {\n inner.textContent = message\n if (active)\n el.setAttribute(\"data-md-state\", \"open\")\n else\n el.removeAttribute(\"data-md-state\")\n })\n\n /* Create and return component */\n return watchDialog(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatest,\n combineLatestWith,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n map,\n of,\n shareReplay,\n startWith,\n switchMap,\n takeLast,\n takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n watchElementSize,\n watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n height: number /* Header visible height */\n sticky: boolean /* Header stickyness */\n hidden: boolean /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable {\n if (!feature(\"header.autohide\"))\n return of(false)\n\n /* Compute direction and turning point */\n const direction$ = viewport$\n .pipe(\n map(({ offset: { y } }) => y),\n bufferCount(2, 1),\n map(([a, b]) => [a < b, b] as const),\n distinctUntilKeyChanged(0)\n )\n\n /* Compute whether header should be hidden */\n const hidden$ = combineLatest([viewport$, direction$])\n .pipe(\n filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n map(([, [direction]]) => direction),\n distinctUntilChanged()\n )\n\n /* Compute threshold for hiding */\n const search$ = watchToggle(\"search\")\n return combineLatest([viewport$, search$])\n .pipe(\n map(([{ offset }, search]) => offset.y > 400 && !search),\n distinctUntilChanged(),\n switchMap(active => active ? hidden$ : of(false)),\n startWith(false)\n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n el: HTMLElement, options: WatchOptions\n): Observable
    {\n return defer(() => {\n const styles = getComputedStyle(el)\n return of(\n styles.position === \"sticky\" ||\n styles.position === \"-webkit-sticky\"\n )\n })\n .pipe(\n combineLatestWith(watchElementSize(el), isHidden(options)),\n map(([sticky, { height }, hidden]) => ({\n height: sticky ? height : 0,\n sticky,\n hidden\n })),\n distinctUntilChanged((a, b) => (\n a.sticky === b.sticky &&\n a.height === b.height &&\n a.hidden === b.hidden\n )),\n shareReplay(1)\n )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n el: HTMLElement, { header$, main$ }: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject
    ()\n push$\n .pipe(\n distinctUntilKeyChanged(\"active\"),\n combineLatestWith(header$)\n )\n .subscribe(([{ active }, { hidden }]) => {\n if (active)\n el.setAttribute(\"data-md-state\", hidden ? \"hidden\" : \"shadow\")\n else\n el.removeAttribute(\"data-md-state\")\n })\n\n /* Link to main area */\n main$.subscribe(push$)\n\n /* Create and return component */\n return header$\n .pipe(\n takeUntil(push$.pipe(takeLast(1))),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n distinctUntilKeyChanged,\n finalize,\n map,\n tap\n} from \"rxjs\"\n\nimport {\n Viewport,\n getElementSize,\n getOptionalElement,\n watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n active: boolean /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n return watchViewportAt(el, { viewport$, header$ })\n .pipe(\n map(({ offset: { y } }) => {\n const { height } = getElementSize(el)\n return {\n active: y >= height\n }\n }),\n distinctUntilKeyChanged(\"active\")\n )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n el: HTMLElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ active }) => {\n if (active)\n el.setAttribute(\"data-md-state\", \"active\")\n else\n el.removeAttribute(\"data-md-state\")\n })\n\n /* Obtain headline, if any */\n const heading = getOptionalElement(\"article h1\")\n if (typeof heading === \"undefined\")\n return EMPTY\n\n /* Create and return component */\n return watchHeaderTitle(heading, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n map,\n switchMap\n} from \"rxjs\"\n\nimport {\n Viewport,\n watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n offset: number /* Main area top offset */\n height: number /* Main area visible height */\n active: boolean /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable
    {\n\n /* Compute necessary adjustment for header */\n const adjust$ = header$\n .pipe(\n map(({ height }) => height),\n distinctUntilChanged()\n )\n\n /* Compute the main area's top and bottom borders */\n const border$ = adjust$\n .pipe(\n switchMap(() => watchElementSize(el)\n .pipe(\n map(({ height }) => ({\n top: el.offsetTop,\n bottom: el.offsetTop + height\n })),\n distinctUntilKeyChanged(\"bottom\")\n )\n )\n )\n\n /* Compute the main area's offset, visible height and if we scrolled past */\n return combineLatest([adjust$, border$, viewport$])\n .pipe(\n map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n height = Math.max(0, height\n - Math.max(0, top - y, header)\n - Math.max(0, height + y - bottom)\n )\n return {\n offset: top - header,\n height,\n active: top - header <= y\n }\n }),\n distinctUntilChanged((a, b) => (\n a.offset === b.offset &&\n a.height === b.height &&\n a.active === b.active\n ))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n finalize,\n fromEvent,\n map,\n mapTo,\n mergeMap,\n of,\n shareReplay,\n startWith,\n tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n scheme?: string /* Color scheme */\n primary?: string /* Primary color */\n accent?: string /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n index: number /* Palette index */\n color: PaletteColor /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n inputs: HTMLInputElement[]\n): Observable {\n const current = __md_get(\"__palette\") || {\n index: inputs.findIndex(input => matchMedia(\n input.getAttribute(\"data-md-color-media\")!\n ).matches)\n }\n\n /* Emit changes in color palette */\n return of(...inputs)\n .pipe(\n mergeMap(input => fromEvent(input, \"change\")\n .pipe(\n mapTo(input)\n )\n ),\n startWith(inputs[Math.max(0, current.index)]),\n map(input => ({\n index: inputs.indexOf(input),\n color: {\n scheme: input.getAttribute(\"data-md-color-scheme\"),\n primary: input.getAttribute(\"data-md-color-primary\"),\n accent: input.getAttribute(\"data-md-color-accent\")\n }\n } as Palette)),\n shareReplay(1)\n )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n el: HTMLElement\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(palette => {\n\n /* Set color palette */\n for (const [key, value] of Object.entries(palette.color))\n if (typeof value === \"string\")\n document.body.setAttribute(`data-md-color-${key}`, value)\n\n /* Toggle visibility */\n for (let index = 0; index < inputs.length; index++) {\n const label = inputs[index].nextElementSibling\n if (label instanceof HTMLElement)\n label.hidden = palette.index !== index\n }\n\n /* Persist preference in local storage */\n __md_set(\"__palette\", palette)\n })\n\n /* Create and return component */\n const inputs = getElements(\"input\", el)\n return watchPalette(inputs)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n Observable,\n Subject,\n mapTo,\n tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n alert$: Subject /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n el.setAttribute(\"data-md-copying\", \"\")\n const text = el.innerText\n el.removeAttribute(\"data-md-copying\")\n return text\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n { alert$ }: SetupOptions\n): void {\n if (ClipboardJS.isSupported()) {\n new Observable(subscriber => {\n new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n text: el => (\n el.getAttribute(\"data-clipboard-text\")! ||\n extract(getElement(\n el.getAttribute(\"data-clipboard-target\")!\n ))\n )\n })\n .on(\"success\", ev => subscriber.next(ev))\n })\n .pipe(\n tap(ev => {\n const trigger = ev.trigger as HTMLElement\n trigger.focus()\n }),\n mapTo(translation(\"clipboard.copied\"))\n )\n .subscribe(alert$)\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n NEVER,\n Observable,\n Subject,\n bufferCount,\n catchError,\n concatMap,\n debounceTime,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n fromEvent,\n map,\n merge,\n of,\n sample,\n share,\n skip,\n skipUntil,\n switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n Viewport,\n ViewportOffset,\n getElements,\n getOptionalElement,\n request,\n requestXML,\n setLocation,\n setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * History state\n */\nexport interface HistoryState {\n url: URL /* State URL */\n offset?: ViewportOffset /* State viewport offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n document$: Subject /* Document subject */\n location$: Subject /* Location subject */\n viewport$: Observable /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Preprocess a list of URLs\n *\n * This function replaces the `site_url` in the sitemap with the actual base\n * URL, to allow instant loading to work in occasions like Netlify previews.\n *\n * @param urls - URLs\n *\n * @returns Processed URLs\n */\nfunction preprocess(urls: string[]): string[] {\n if (urls.length < 2)\n return urls\n\n /* Take the first two URLs and remove everything after the last slash */\n const [root, next] = urls\n .sort((a, b) => a.length - b.length)\n .map(url => url.replace(/[^/]+$/, \"\"))\n\n /* Compute common prefix */\n let index = 0\n if (root === next)\n index = root.length\n else\n while (root.charCodeAt(index) === next.charCodeAt(index))\n index++\n\n /* Replace common prefix (i.e. base) with effective base */\n const config = configuration()\n return urls.map(url => (\n url.replace(root.slice(0, index), config.base)\n ))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant loading\n *\n * When fetching, theoretically, we could use `responseType: \"document\"`, but\n * since all MkDocs links are relative, we need to make sure that the current\n * location matches the document we just loaded. Otherwise any relative links\n * in the document could use the old location.\n *\n * This is the reason why we need to synchronize history events and the process\n * of fetching the document for navigation changes (except `popstate` events):\n *\n * 1. Fetch document via `XMLHTTPRequest`\n * 2. Set new location via `history.pushState`\n * 3. Parse and emit fetched document\n *\n * For `popstate` events, we must not use `history.pushState`, or the forward\n * history will be irreversibly overwritten. In case the request fails, the\n * location change is dispatched regularly.\n *\n * @param options - Options\n */\nexport function setupInstantLoading(\n { document$, location$, viewport$ }: SetupOptions\n): void {\n const config = configuration()\n if (location.protocol === \"file:\")\n return\n\n /* Disable automatic scroll restoration */\n if (\"scrollRestoration\" in history) {\n history.scrollRestoration = \"manual\"\n\n /* Hack: ensure that reloads restore viewport offset */\n fromEvent(window, \"beforeunload\")\n .subscribe(() => {\n history.scrollRestoration = \"auto\"\n })\n }\n\n /* Hack: ensure absolute favicon link to omit 404s when switching */\n const favicon = getOptionalElement(\"link[rel=icon]\")\n if (typeof favicon !== \"undefined\")\n favicon.href = favicon.href\n\n /* Intercept internal navigation */\n const push$ = requestXML(new URL(\"sitemap.xml\", config.base))\n .pipe(\n map(sitemap => preprocess(getElements(\"loc\", sitemap)\n .map(node => node.textContent!)\n )),\n switchMap(urls => fromEvent(document.body, \"click\")\n .pipe(\n filter(ev => !ev.metaKey && !ev.ctrlKey),\n switchMap(ev => {\n\n /* Handle HTML and SVG elements */\n if (ev.target instanceof Element) {\n const el = ev.target.closest(\"a\")\n if (el && !el.target) {\n const url = new URL(el.href)\n\n /* Canonicalize URL */\n url.search = \"\"\n url.hash = \"\"\n\n /* Check if URL should be intercepted */\n if (\n url.pathname !== location.pathname &&\n urls.includes(url.toString())\n ) {\n ev.preventDefault()\n return of({\n url: new URL(el.href)\n })\n }\n }\n }\n return NEVER\n })\n )\n ),\n share()\n )\n\n /* Intercept history back and forward */\n const pop$ = fromEvent(window, \"popstate\")\n .pipe(\n filter(ev => ev.state !== null),\n map(ev => ({\n url: new URL(location.href),\n offset: ev.state\n })),\n share()\n )\n\n /* Emit location change */\n merge(push$, pop$)\n .pipe(\n distinctUntilChanged((a, b) => a.url.href === b.url.href),\n map(({ url }) => url)\n )\n .subscribe(location$)\n\n /* Fetch document via `XMLHTTPRequest` */\n const response$ = location$\n .pipe(\n distinctUntilKeyChanged(\"pathname\"),\n switchMap(url => request(url.href)\n .pipe(\n catchError(() => {\n setLocation(url)\n return NEVER\n })\n )\n ),\n share()\n )\n\n /* Set new location via `history.pushState` */\n push$\n .pipe(\n sample(response$)\n )\n .subscribe(({ url }) => {\n history.pushState({}, \"\", `${url}`)\n })\n\n /* Parse and emit fetched document */\n const dom = new DOMParser()\n response$\n .pipe(\n switchMap(res => res.text()),\n map(res => dom.parseFromString(res, \"text/html\"))\n )\n .subscribe(document$)\n\n /* Replace meta tags and components */\n document$\n .pipe(\n skip(1)\n )\n .subscribe(replacement => {\n for (const selector of [\n\n /* Meta tags */\n \"title\",\n \"link[rel=canonical]\",\n \"meta[name=author]\",\n \"meta[name=description]\",\n\n /* Components */\n \"[data-md-component=announce]\",\n \"[data-md-component=container]\",\n \"[data-md-component=header-topic]\",\n \"[data-md-component=logo]\",\n \"[data-md-component=skip]\",\n ...feature(\"navigation.tabs.sticky\")\n ? [\"[data-md-component=tabs]\"]\n : []\n ]) {\n const source = getOptionalElement(selector)\n const target = getOptionalElement(selector, replacement)\n if (\n typeof source !== \"undefined\" &&\n typeof target !== \"undefined\"\n ) {\n source.replaceWith(target)\n }\n }\n })\n\n /* Re-evaluate scripts */\n document$\n .pipe(\n skip(1),\n map(() => getComponentElement(\"container\")),\n switchMap(el => of(...getElements(\"script\", el))),\n concatMap(el => {\n const script = h(\"script\")\n if (el.src) {\n for (const name of el.getAttributeNames())\n script.setAttribute(name, el.getAttribute(name)!)\n el.replaceWith(script)\n\n /* Complete when script is loaded */\n return new Observable(observer => {\n script.onload = () => observer.complete()\n })\n\n /* Complete immediately */\n } else {\n script.textContent = el.textContent\n el.replaceWith(script)\n return EMPTY\n }\n })\n )\n .subscribe()\n\n /* Emit history state change */\n merge(push$, pop$)\n .pipe(\n sample(document$)\n )\n .subscribe(({ url, offset }) => {\n if (url.hash && !offset) {\n setLocationHash(url.hash)\n } else {\n window.scrollTo(0, offset?.y || 0)\n }\n })\n\n /* Debounce update of viewport offset */\n viewport$\n .pipe(\n skipUntil(push$),\n debounceTime(250),\n distinctUntilKeyChanged(\"offset\")\n )\n .subscribe(({ offset }) => {\n history.replaceState(offset, \"\")\n })\n\n /* Set viewport offset from history */\n merge(push$, pop$)\n .pipe(\n bufferCount(2, 1),\n filter(([a, b]) => a.url.pathname === b.url.pathname),\n map(([, state]) => state)\n )\n .subscribe(({ offset }) => {\n window.scrollTo(0, offset?.y || 0)\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexDocument } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search document\n */\nexport interface SearchDocument extends SearchIndexDocument {\n parent?: SearchIndexDocument /* Parent article */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search document mapping\n */\nexport type SearchDocumentMap = Map\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document mapping\n *\n * @param docs - Search index documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n docs: SearchIndexDocument[]\n): SearchDocumentMap {\n const documents = new Map()\n const parents = new Set()\n for (const doc of docs) {\n const [path, hash] = doc.location.split(\"#\")\n\n /* Extract location and title */\n const location = doc.location\n const title = doc.title\n\n /* Escape and cleanup text */\n const text = escapeHTML(doc.text)\n .replace(/\\s+(?=[,.:;!?])/g, \"\")\n .replace(/\\s+/g, \" \")\n\n /* Handle section */\n if (hash) {\n const parent = documents.get(path)!\n\n /* Ignore first section, override article */\n if (!parents.has(parent)) {\n parent.title = doc.title\n parent.text = text\n\n /* Remember that we processed the article */\n parents.add(parent)\n\n /* Add subsequent section */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n parent\n })\n }\n\n /* Add article */\n } else {\n documents.set(location, {\n location,\n title,\n text\n })\n }\n }\n return documents\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexConfig } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search index configuration\n * @param escape - Whether to escape HTML\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n config: SearchIndexConfig, escape: boolean\n): SearchHighlightFactoryFn {\n const separator = new RegExp(config.separator, \"img\")\n const highlight = (_: unknown, data: string, term: string) => {\n return `${data}${term}`\n }\n\n /* Return factory function */\n return (query: string) => {\n query = query\n .replace(/[\\s*+\\-:~^]+/g, \" \")\n .trim()\n\n /* Create search term match expression */\n const match = new RegExp(`(^|${config.separator})(${\n query\n .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n .replace(separator, \"|\")\n })`, \"img\")\n\n /* Highlight string value */\n return value => (\n escape\n ? escapeHTML(value)\n : value\n )\n .replace(match, highlight)\n .replace(/<\\/mark>(\\s+)]*>/img, \"$1\")\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search transformation function\n *\n * @param value - Query value\n *\n * @returns Transformed query value\n */\nexport type SearchTransformFn = (value: string) => string\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Default transformation function\n *\n * 1. Search for terms in quotation marks and prepend a `+` modifier to denote\n * that the resulting document must contain all terms, converting the query\n * to an `AND` query (as opposed to the default `OR` behavior). While users\n * may expect terms enclosed in quotation marks to map to span queries, i.e.\n * for which order is important, Lunr.js doesn't support them, so the best\n * we can do is to convert the terms to an `AND` query.\n *\n * 2. Replace control characters which are not located at the beginning of the\n * query or preceded by white space, or are not followed by a non-whitespace\n * character or are at the end of the query string. Furthermore, filter\n * unmatched quotation marks.\n *\n * 3. Trim excess whitespace from left and right.\n *\n * @param query - Query value\n *\n * @returns Transformed query value\n */\nexport function defaultTransform(query: string): string {\n return query\n .split(/\"([^\"]+)\"/g) /* => 1 */\n .map((terms, index) => index & 1\n ? terms.replace(/^\\b|^(?![^\\x00-\\x7F]|$)|\\s+/g, \" +\")\n : terms\n )\n .join(\"\")\n .replace(/\"|(?:^|\\s+)[*+\\-:^~]+(?=\\s+|$)/g, \"\") /* => 2 */\n .trim() /* => 3 */\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchIndex, SearchResult } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n SETUP, /* Search index setup */\n READY, /* Search index ready */\n QUERY, /* Search query */\n RESULT /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n type: SearchMessageType.SETUP /* Message type */\n data: SearchIndex /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n type: SearchMessageType.READY /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n type: SearchMessageType.QUERY /* Message type */\n data: string /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n type: SearchMessageType.RESULT /* Message type */\n data: SearchResult /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n | SearchSetupMessage\n | SearchReadyMessage\n | SearchQueryMessage\n | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search setup messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchSetupMessage(\n message: SearchMessage\n): message is SearchSetupMessage {\n return message.type === SearchMessageType.SETUP\n}\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n message: SearchMessage\n): message is SearchReadyMessage {\n return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search query messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchQueryMessage(\n message: SearchMessage\n): message is SearchQueryMessage {\n return message.type === SearchMessageType.QUERY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n message: SearchMessage\n): message is SearchResultMessage {\n return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n ObservableInput,\n Subject,\n from,\n map,\n share\n} from \"rxjs\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { WorkerHandler, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../_\"\nimport {\n SearchOptions,\n SearchPipeline\n} from \"../../options\"\nimport {\n SearchMessage,\n SearchMessageType,\n SearchSetupMessage,\n isSearchResultMessage\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search worker\n */\nexport type SearchWorker = WorkerHandler\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search index\n *\n * @param data - Search index\n *\n * @returns Search index\n */\nfunction setupSearchIndex({ config, docs }: SearchIndex): SearchIndex {\n\n /* Override default language with value from translation */\n if (config.lang.length === 1 && config.lang[0] === \"en\")\n config.lang = [\n translation(\"search.config.lang\")\n ]\n\n /* Override default separator with value from translation */\n if (config.separator === \"[\\\\s\\\\-]+\")\n config.separator = translation(\"search.config.separator\")\n\n /* Set pipeline from translation */\n const pipeline = translation(\"search.config.pipeline\")\n .split(/\\s*,\\s*/)\n .filter(Boolean) as SearchPipeline\n\n /* Determine search options */\n const options: SearchOptions = {\n pipeline,\n suggestions: feature(\"search.suggest\")\n }\n\n /* Return search index after defaulting */\n return { config, docs, options }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates a web worker to set up and query the search index,\n * which is done using Lunr.js. The index must be passed as an observable to\n * enable hacks like _localsearch_ via search index embedding as JSON.\n *\n * @param url - Worker URL\n * @param index - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n url: string, index: ObservableInput\n): SearchWorker {\n const config = configuration()\n const worker = new Worker(url)\n\n /* Create communication channels and resolve relative links */\n const tx$ = new Subject()\n const rx$ = watchWorker(worker, { tx$ })\n .pipe(\n map(message => {\n if (isSearchResultMessage(message)) {\n for (const result of message.data.items)\n for (const document of result)\n document.location = `${new URL(document.location, config.base)}`\n }\n return message\n }),\n share()\n )\n\n /* Set up search index */\n from(index)\n .pipe(\n map(data => ({\n type: SearchMessageType.SETUP,\n data: setupSearchIndex(data)\n } as SearchSetupMessage))\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Return search worker */\n return { tx$, rx$ }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { combineLatest, map } from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n getElement,\n requestJSON\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n Version,\n renderVersionSelector\n} from \"~/templates\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n */\nexport function setupVersionSelector(): void {\n const config = configuration()\n const versions$ = requestJSON(\n new URL(\"../versions.json\", config.base)\n )\n\n /* Determine current version */\n const current$ = versions$\n .pipe(\n map(versions => {\n const [, current] = config.base.match(/([^/]+)\\/?$/)!\n return versions.find(({ version, aliases }) => (\n version === current || aliases.includes(current)\n )) || versions[0]\n })\n )\n\n /* Render version selector and warning */\n combineLatest([versions$, current$])\n .subscribe(([versions, current]) => {\n const topic = getElement(\".md-header__topic\")\n topic.appendChild(renderVersionSelector(versions, current))\n\n /* Check if version state was already determined */\n if (__md_get(\"__outdated\", sessionStorage) === null) {\n const latest = config.version?.default || \"latest\"\n const outdated = !current.aliases.includes(latest)\n\n /* Persist version state in session storage */\n __md_set(\"__outdated\", outdated, sessionStorage)\n if (outdated)\n for (const warning of getComponentElements(\"outdated\"))\n warning.hidden = false\n }\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n combineLatest,\n delay,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n finalize,\n fromEvent,\n map,\n merge,\n shareReplay,\n startWith,\n take,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n getLocation,\n setToggle,\n watchElementFocus\n} from \"~/browser\"\nimport {\n SearchMessageType,\n SearchQueryMessage,\n SearchWorker,\n defaultTransform,\n isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n value: string /* Query value */\n focus: boolean /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param worker - Search worker\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n el: HTMLInputElement, { rx$ }: SearchWorker\n): Observable {\n const fn = __search?.transform || defaultTransform\n\n /* Immediately show search dialog */\n const { searchParams } = getLocation()\n if (searchParams.has(\"q\"))\n setToggle(\"search\", true)\n\n /* Intercept query parameter (deep link) */\n const param$ = rx$\n .pipe(\n filter(isSearchReadyMessage),\n take(1),\n map(() => searchParams.get(\"q\") || \"\")\n )\n\n /* Set query from parameter */\n param$.subscribe(value => { // TODO: not ideal - find a better way\n if (value)\n el.value = value\n })\n\n /* Intercept focus and input events */\n const focus$ = watchElementFocus(el)\n const value$ = merge(\n fromEvent(el, \"keyup\"),\n fromEvent(el, \"focus\").pipe(delay(1)),\n param$\n )\n .pipe(\n map(() => fn(el.value)),\n startWith(\"\"),\n distinctUntilChanged(),\n )\n\n /* Combine into single observable */\n return combineLatest([value$, focus$])\n .pipe(\n map(([value, focus]) => ({ value, focus })),\n shareReplay(1)\n )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param worker - Search worker\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n el: HTMLInputElement, { tx$, rx$ }: SearchWorker\n): Observable> {\n const push$ = new Subject()\n\n /* Handle value changes */\n push$\n .pipe(\n distinctUntilKeyChanged(\"value\"),\n map(({ value }): SearchQueryMessage => ({\n type: SearchMessageType.QUERY,\n data: value\n }))\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Handle focus changes */\n push$\n .pipe(\n distinctUntilKeyChanged(\"focus\")\n )\n .subscribe(({ focus }) => {\n if (focus) {\n setToggle(\"search\", focus)\n el.placeholder = \"\"\n } else {\n el.placeholder = translation(\"search.placeholder\")\n }\n })\n\n /* Handle reset */\n fromEvent(el.form!, \"reset\")\n .pipe(\n takeUntil(push$.pipe(takeLast(1)))\n )\n .subscribe(() => el.focus())\n\n /* Create and return component */\n return watchSearchQuery(el, { tx$, rx$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n filter,\n finalize,\n map,\n merge,\n of,\n skipUntil,\n switchMap,\n take,\n tap,\n withLatestFrom,\n zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n getElement,\n watchElementBoundary\n} from \"~/browser\"\nimport {\n SearchResult,\n SearchWorker,\n isSearchReadyMessage,\n isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n query$: Observable /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param worker - Search worker\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n el: HTMLElement, { rx$ }: SearchWorker, { query$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n const boundary$ = watchElementBoundary(el.parentElement!)\n .pipe(\n filter(Boolean)\n )\n\n /* Retrieve nested components */\n const meta = getElement(\":scope > :first-child\", el)\n const list = getElement(\":scope > :last-child\", el)\n\n /* Wait until search is ready */\n const ready$ = rx$\n .pipe(\n filter(isSearchReadyMessage),\n take(1)\n )\n\n /* Update search result metadata */\n push$\n .pipe(\n withLatestFrom(query$),\n skipUntil(ready$)\n )\n .subscribe(([{ items }, { value }]) => {\n if (value) {\n switch (items.length) {\n\n /* No results */\n case 0:\n meta.textContent = translation(\"search.result.none\")\n break\n\n /* One result */\n case 1:\n meta.textContent = translation(\"search.result.one\")\n break\n\n /* Multiple result */\n default:\n meta.textContent = translation(\n \"search.result.other\",\n round(items.length)\n )\n }\n } else {\n meta.textContent = translation(\"search.result.placeholder\")\n }\n })\n\n /* Update search result list */\n push$\n .pipe(\n tap(() => list.innerHTML = \"\"),\n switchMap(({ items }) => merge(\n of(...items.slice(0, 10)),\n of(...items.slice(10))\n .pipe(\n bufferCount(4),\n zipWith(boundary$),\n switchMap(([chunk]) => of(...chunk))\n )\n ))\n )\n .subscribe(result => list.appendChild(\n renderSearchResultItem(result)\n ))\n\n /* Filter search result message */\n const result$ = rx$\n .pipe(\n filter(isSearchResultMessage),\n map(({ data }) => data)\n )\n\n /* Create and return component */\n return result$\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n finalize,\n fromEvent,\n map,\n tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n url: URL /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n query$: Observable /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n query$: Observable /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n _el: HTMLElement, { query$ }: WatchOptions\n): Observable {\n return query$\n .pipe(\n map(({ value }) => {\n const url = getLocation()\n url.hash = \"\"\n url.searchParams.delete(\"h\")\n url.searchParams.set(\"q\", value)\n return { url }\n })\n )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n el: HTMLAnchorElement, options: MountOptions\n): Observable> {\n const push$ = new Subject()\n push$.subscribe(({ url }) => {\n el.setAttribute(\"data-clipboard-text\", el.href)\n el.href = `${url}`\n })\n\n /* Prevent following of link */\n fromEvent(el, \"click\")\n .subscribe(ev => ev.preventDefault())\n\n /* Create and return component */\n return watchSearchShare(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n asyncScheduler,\n combineLatestWith,\n distinctUntilChanged,\n filter,\n finalize,\n fromEvent,\n map,\n merge,\n observeOn,\n tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n SearchResult,\n SearchWorker,\n isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n keyboard$: Observable /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param worker - Search worker\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n el: HTMLElement, { rx$ }: SearchWorker, { keyboard$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n\n /* Retrieve query component and track all changes */\n const query = getComponentElement(\"search-query\")\n const query$ = merge(\n fromEvent(query, \"keydown\"),\n fromEvent(query, \"focus\")\n )\n .pipe(\n observeOn(asyncScheduler),\n map(() => query.value),\n distinctUntilChanged(),\n )\n\n /* Update search suggestions */\n push$\n .pipe(\n combineLatestWith(query$),\n map(([{ suggestions }, value]) => {\n const words = value.split(/([\\s-]+)/)\n if (suggestions?.length && words[words.length - 1]) {\n const last = suggestions[suggestions.length - 1]\n if (last.startsWith(words[words.length - 1]))\n words[words.length - 1] = last\n } else {\n words.length = 0\n }\n return words\n })\n )\n .subscribe(words => el.innerHTML = words\n .join(\"\")\n .replace(/\\s/g, \" \")\n )\n\n /* Set up search keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"search\")\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Right arrow: accept current suggestion */\n case \"ArrowRight\":\n if (\n el.innerText.length &&\n query.selectionStart === query.value.length\n )\n query.value = el.innerText\n break\n }\n })\n\n /* Filter search result message */\n const result$ = rx$\n .pipe(\n filter(isSearchResultMessage),\n map(({ data }) => data)\n )\n\n /* Create and return component */\n return result$\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(() => ({ ref: el }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n NEVER,\n Observable,\n ObservableInput,\n filter,\n merge,\n mergeWith,\n sample,\n take\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n Keyboard,\n getActiveElement,\n getElements,\n setToggle\n} from \"~/browser\"\nimport {\n SearchIndex,\n SearchResult,\n isSearchQueryMessage,\n isSearchReadyMessage,\n setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n Component,\n getComponentElement,\n getComponentElements\n} from \"../../_\"\nimport {\n SearchQuery,\n mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n SearchShare,\n mountSearchShare\n} from \"../share\"\nimport {\n SearchSuggest,\n mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n | SearchQuery\n | SearchResult\n | SearchShare\n | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n index$: ObservableInput /* Search index observable */\n keyboard$: Observable /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable> {\n const config = configuration()\n try {\n const url = __search?.worker || config.search\n const worker = setupSearchWorker(url, index$)\n\n /* Retrieve query and result components */\n const query = getComponentElement(\"search-query\", el)\n const result = getComponentElement(\"search-result\", el)\n\n /* Re-emit query when search is ready */\n const { tx$, rx$ } = worker\n tx$\n .pipe(\n filter(isSearchQueryMessage),\n sample(rx$.pipe(filter(isSearchReadyMessage))),\n take(1)\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Set up search keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"search\")\n )\n .subscribe(key => {\n const active = getActiveElement()\n switch (key.type) {\n\n /* Enter: go to first (best) result */\n case \"Enter\":\n if (active === query) {\n const anchors = new Map()\n for (const anchor of getElements(\n \":first-child [href]\", result\n )) {\n const article = anchor.firstElementChild!\n anchors.set(anchor, parseFloat(\n article.getAttribute(\"data-md-score\")!\n ))\n }\n\n /* Go to result with highest score, if any */\n if (anchors.size) {\n const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n best.click()\n }\n\n /* Otherwise omit form submission */\n key.claim()\n }\n break\n\n /* Escape or Tab: close search */\n case \"Escape\":\n case \"Tab\":\n setToggle(\"search\", false)\n query.blur()\n break\n\n /* Vertical arrows: select previous or next search result */\n case \"ArrowUp\":\n case \"ArrowDown\":\n if (typeof active === \"undefined\") {\n query.focus()\n } else {\n const els = [query, ...getElements(\n \":not(details) > [href], summary, details[open] [href]\",\n result\n )]\n const i = Math.max(0, (\n Math.max(0, els.indexOf(active)) + els.length + (\n key.type === \"ArrowUp\" ? -1 : +1\n )\n ) % els.length)\n els[i].focus()\n }\n\n /* Prevent scrolling of page */\n key.claim()\n break\n\n /* All other keys: hand to search query */\n default:\n if (query !== getActiveElement())\n query.focus()\n }\n })\n\n /* Set up global keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"global\"),\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Open search and select query */\n case \"f\":\n case \"s\":\n case \"/\":\n query.focus()\n query.select()\n\n /* Prevent scrolling of page */\n key.claim()\n break\n }\n })\n\n /* Create and return component */\n const query$ = mountSearchQuery(query, worker)\n const result$ = mountSearchResult(result, worker, { query$ })\n return merge(query$, result$)\n .pipe(\n mergeWith(\n\n /* Search sharing */\n ...getComponentElements(\"search-share\", el)\n .map(child => mountSearchShare(child, { query$ })),\n\n /* Search suggestions */\n ...getComponentElements(\"search-suggest\", el)\n .map(child => mountSearchSuggest(child, worker, { keyboard$ }))\n )\n )\n\n /* Gracefully handle broken search */\n } catch (err) {\n el.hidden = true\n return NEVER\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n ObservableInput,\n combineLatest,\n filter,\n map,\n startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n SearchIndex,\n setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n nodes: Map /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n index$: ObservableInput /* Search index observable */\n location$: Observable /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n el: HTMLElement, { index$, location$ }: MountOptions\n): Observable> {\n return combineLatest([\n index$,\n location$\n .pipe(\n startWith(getLocation()),\n filter(url => !!url.searchParams.get(\"h\"))\n )\n ])\n .pipe(\n map(([index, url]) => setupSearchHighlighter(index.config, true)(\n url.searchParams.get(\"h\")!\n )),\n map(fn => {\n const nodes = new Map()\n\n /* Traverse text nodes and collect matches */\n const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n for (let node = it.nextNode(); node; node = it.nextNode()) {\n if (node.parentElement?.offsetHeight) {\n const original = node.textContent!\n const replaced = fn(original)\n if (replaced.length > original.length)\n nodes.set(node as ChildNode, replaced)\n }\n }\n\n /* Replace original nodes with matches */\n for (const [node, text] of nodes) {\n const { childNodes } = h(\"span\", null, text)\n node.replaceWith(...Array.from(childNodes))\n }\n\n /* Return component */\n return { ref: el, nodes }\n })\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n animationFrameScheduler,\n auditTime,\n combineLatest,\n defer,\n distinctUntilChanged,\n finalize,\n map,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport {\n Viewport,\n getElement,\n getElementOffset\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n height: number /* Sidebar height */\n locked: boolean /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n main$: Observable
    /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable {\n const parent = el.parentElement!\n const adjust =\n parent.offsetTop -\n parent.parentElement!.offsetTop\n\n /* Compute the sidebar's available height and if it should be locked */\n return combineLatest([main$, viewport$])\n .pipe(\n map(([{ offset, height }, { offset: { y } }]) => {\n height = height\n + Math.min(adjust, Math.max(0, y - offset))\n - adjust\n return {\n height,\n locked: y >= offset + adjust\n }\n }),\n distinctUntilChanged((a, b) => (\n a.height === b.height &&\n a.locked === b.locked\n ))\n )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n el: HTMLElement, { header$, ...options }: MountOptions\n): Observable> {\n const inner = getElement(\".md-sidebar__scrollwrap\", el)\n const { y } = getElementOffset(inner)\n return defer(() => {\n const push$ = new Subject()\n push$\n .pipe(\n auditTime(0, animationFrameScheduler),\n withLatestFrom(header$)\n )\n .subscribe({\n\n /* Handle emission */\n next([{ height }, { height: offset }]) {\n inner.style.height = `${height - 2 * y}px`\n el.style.top = `${offset}px`\n },\n\n /* Handle complete */\n complete() {\n inner.style.height = \"\"\n el.style.top = \"\"\n }\n })\n\n /* Create and return component */\n return watchSidebar(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n Observable,\n defaultIfEmpty,\n map,\n zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n tag_name: string /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n user: string, repo?: string\n): Observable {\n if (typeof repo !== \"undefined\") {\n const url = `https://api.github.com/repos/${user}/${repo}`\n return zip(\n\n /* Fetch version */\n requestJSON(`${url}/releases/latest`)\n .pipe(\n map(release => ({\n version: release.tag_name\n })),\n defaultIfEmpty({})\n ),\n\n /* Fetch stars and forks */\n requestJSON(url)\n .pipe(\n map(info => ({\n stars: info.stargazers_count,\n forks: info.forks_count\n })),\n defaultIfEmpty({})\n )\n )\n .pipe(\n map(([release, info]) => ({ ...release, ...info }))\n )\n\n /* User or organization */\n } else {\n const url = `https://api.github.com/users/${user}`\n return requestJSON(url)\n .pipe(\n map(info => ({\n repositories: info.public_repos\n })),\n defaultIfEmpty({})\n )\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n Observable,\n defaultIfEmpty,\n map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n base: string, project: string\n): Observable {\n const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n return requestJSON(url)\n .pipe(\n map(({ star_count, forks_count }) => ({\n stars: star_count,\n forks: forks_count\n })),\n defaultIfEmpty({})\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n stars?: number /* Number of stars */\n forks?: number /* Number of forks */\n version?: string /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n repositories?: number /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n | RepositoryFacts\n | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n url: string\n): Observable {\n const [type] = url.match(/(git(?:hub|lab))/i) || []\n switch (type.toLowerCase()) {\n\n /* GitHub repository */\n case \"github\":\n const [, user, repo] = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)!\n return fetchSourceFactsFromGitHub(user, repo)\n\n /* GitLab repository */\n case \"gitlab\":\n const [, base, slug] = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)!\n return fetchSourceFactsFromGitLab(base, slug)\n\n /* Everything else */\n default:\n return EMPTY\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n catchError,\n defer,\n filter,\n finalize,\n map,\n of,\n shareReplay,\n tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport { Component } from \"../../_\"\nimport {\n SourceFacts,\n fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n facts: SourceFacts /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n el: HTMLAnchorElement\n): Observable {\n return fetch$ ||= defer(() => {\n const cached = __md_get(\"__source\", sessionStorage)\n if (cached)\n return of(cached)\n else\n return fetchSourceFacts(el.href)\n .pipe(\n tap(facts => __md_set(\"__source\", facts, sessionStorage))\n )\n })\n .pipe(\n catchError(() => EMPTY),\n filter(facts => Object.keys(facts).length > 0),\n map(facts => ({ facts })),\n shareReplay(1)\n )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n el: HTMLAnchorElement\n): Observable> {\n const inner = getElement(\":scope > :last-child\", el)\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ facts }) => {\n inner.appendChild(renderSourceFacts(facts))\n inner.setAttribute(\"data-md-state\", \"done\")\n })\n\n /* Create and return component */\n return watchSource(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n distinctUntilKeyChanged,\n finalize,\n map,\n of,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n watchElementSize,\n watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n hidden: boolean /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n return watchElementSize(document.body)\n .pipe(\n switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n map(({ offset: { y } }) => {\n return {\n hidden: y >= 10\n }\n }),\n distinctUntilKeyChanged(\"hidden\")\n )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n el: HTMLElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe({\n\n /* Handle emission */\n next({ hidden }) {\n if (hidden)\n el.setAttribute(\"data-md-state\", \"hidden\")\n else\n el.removeAttribute(\"data-md-state\")\n },\n\n /* Handle complete */\n complete() {\n el.removeAttribute(\"data-md-state\")\n }\n })\n\n /* Create and return component */\n return (\n feature(\"navigation.tabs.sticky\")\n ? of({ hidden: false })\n : watchTabs(el, options)\n )\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatest,\n debounceTime,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n finalize,\n map,\n of,\n scan,\n startWith,\n switchMap,\n takeLast,\n takeUntil,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n getElements,\n getLocation,\n getOptionalElement,\n watchElementSize\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n prev: HTMLAnchorElement[][] /* Anchors (previous) */\n next: HTMLAnchorElement[][] /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n const table = new Map()\n\n /* Compute anchor-to-target mapping */\n const anchors = getElements(\"[href^=\\\\#]\", el)\n for (const anchor of anchors) {\n const id = decodeURIComponent(anchor.hash.substring(1))\n const target = getOptionalElement(`[id=\"${id}\"]`)\n if (typeof target !== \"undefined\")\n table.set(anchor, target)\n }\n\n /* Compute necessary adjustment for header */\n const adjust$ = header$\n .pipe(\n map(header => 24 + header.height)\n )\n\n /* Compute partition of previous and next anchors */\n const partition$ = watchElementSize(document.body)\n .pipe(\n distinctUntilKeyChanged(\"height\"),\n\n /* Build index to map anchor paths to vertical offsets */\n switchMap(body => defer(() => {\n let path: HTMLAnchorElement[] = []\n return of([...table].reduce((index, [anchor, target]) => {\n while (path.length) {\n const last = table.get(path[path.length - 1])!\n if (last.tagName >= target.tagName) {\n path.pop()\n } else {\n break\n }\n }\n\n /* If the current anchor is hidden, continue with its parent */\n let offset = target.offsetTop\n while (!offset && target.parentElement) {\n target = target.parentElement\n offset = target.offsetTop\n }\n\n /* Map reversed anchor path to vertical offset */\n return index.set(\n [...path = [...path, anchor]].reverse(),\n offset\n )\n }, new Map()))\n })\n .pipe(\n\n /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n\n /* Re-compute partition when viewport offset changes */\n switchMap(index => combineLatest([viewport$, adjust$])\n .pipe(\n scan(([prev, next], [{ offset: { y }, size }, adjust]) => {\n const last = y + size.height >= Math.floor(body.height)\n\n /* Look forward */\n while (next.length) {\n const [, offset] = next[0]\n if (offset - adjust < y || last) {\n prev = [...prev, next.shift()!]\n } else {\n break\n }\n }\n\n /* Look backward */\n while (prev.length) {\n const [, offset] = prev[prev.length - 1]\n if (offset - adjust >= y && !last) {\n next = [prev.pop()!, ...next]\n } else {\n break\n }\n }\n\n /* Return partition */\n return [prev, next]\n }, [[], [...index]]),\n distinctUntilChanged((a, b) => (\n a[0] === b[0] &&\n a[1] === b[1]\n ))\n )\n )\n )\n )\n )\n\n /* Compute and return anchor list migrations */\n return partition$\n .pipe(\n map(([prev, next]) => ({\n prev: prev.map(([path]) => path),\n next: next.map(([path]) => path)\n })),\n\n /* Extract anchor list migrations */\n startWith({ prev: [], next: [] }),\n bufferCount(2, 1),\n map(([a, b]) => {\n\n /* Moving down */\n if (a.prev.length < b.prev.length) {\n return {\n prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n next: []\n }\n\n /* Moving up */\n } else {\n return {\n prev: b.prev.slice(-1),\n next: b.next.slice(0, b.next.length - a.next.length)\n }\n }\n })\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n el: HTMLElement, { viewport$, header$ }: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ prev, next }) => {\n\n /* Look forward */\n for (const [anchor] of next) {\n anchor.removeAttribute(\"data-md-state\")\n anchor.classList.remove(\n \"md-nav__link--active\"\n )\n }\n\n /* Look backward */\n for (const [index, [anchor]] of prev.entries()) {\n anchor.setAttribute(\"data-md-state\", \"blur\")\n anchor.classList.toggle(\n \"md-nav__link--active\",\n index === prev.length - 1\n )\n }\n })\n\n /* Set up anchor tracking, if enabled */\n if (feature(\"navigation.tracking\"))\n viewport$\n .pipe(\n takeUntil(push$.pipe(takeLast(1))),\n distinctUntilKeyChanged(\"offset\"),\n debounceTime(250),\n withLatestFrom(push$)\n )\n .subscribe(([, { prev }]) => {\n const url = getLocation()\n\n /* Set hash fragment to active anchor */\n const anchor = prev[prev.length - 1]\n if (anchor && anchor.length) {\n const [active] = anchor\n const { hash } = new URL(active.href)\n if (url.hash !== hash) {\n url.hash = hash\n history.replaceState({}, \"\", `${url}`)\n }\n\n /* Reset anchor when at the top */\n } else {\n url.hash = \"\"\n history.replaceState({}, \"\", `${url}`)\n }\n })\n\n /* Create and return component */\n return watchTableOfContents(el, { viewport$, header$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatest,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n endWith,\n finalize,\n map,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n hidden: boolean /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n _el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable {\n\n /* Compute direction */\n const direction$ = viewport$\n .pipe(\n map(({ offset: { y } }) => y),\n bufferCount(2, 1),\n map(([a, b]) => a > b && b),\n distinctUntilChanged()\n )\n\n /* Compute whether button should be hidden */\n const hidden$ = main$\n .pipe(\n distinctUntilKeyChanged(\"active\")\n )\n\n /* Compute threshold for hiding */\n return combineLatest([hidden$, direction$])\n .pipe(\n map(([{ active }, direction]) => ({\n hidden: !(active && direction)\n })),\n distinctUntilChanged((a, b) => (\n a.hidden === b.hidden\n ))\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n el: HTMLElement, { viewport$, header$, main$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n push$.subscribe({\n\n /* Handle emission */\n next({ hidden }) {\n if (hidden) {\n el.setAttribute(\"data-md-state\", \"hidden\")\n el.setAttribute(\"tabindex\", \"-1\")\n el.blur()\n } else {\n el.removeAttribute(\"data-md-state\")\n el.removeAttribute(\"tabindex\")\n }\n },\n\n /* Handle complete */\n complete() {\n el.style.top = \"\"\n el.setAttribute(\"data-md-state\", \"hidden\")\n el.removeAttribute(\"tabindex\")\n }\n })\n\n /* Watch header height */\n header$\n .pipe(\n takeUntil(push$.pipe(endWith(0), takeLast(1))),\n distinctUntilKeyChanged(\"height\")\n )\n .subscribe(({ height }) => {\n el.style.top = `${height + 16}px`\n })\n\n /* Create and return component */\n return watchBackToTop(el, { viewport$, header$, main$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n mapTo,\n mergeMap,\n of,\n switchMap,\n takeWhile,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n document$: Observable /* Document observable */\n tablet$: Observable /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n { document$, tablet$ }: PatchOptions\n): void {\n document$\n .pipe(\n switchMap(() => of(...getElements(\n \"[data-md-state=indeterminate]\"\n ))),\n tap(el => {\n el.indeterminate = true\n el.checked = false\n }),\n mergeMap(el => fromEvent(el, \"change\")\n .pipe(\n takeWhile(() => el.hasAttribute(\"data-md-state\")),\n mapTo(el)\n )\n ),\n withLatestFrom(tablet$)\n )\n .subscribe(([el, tablet]) => {\n el.removeAttribute(\"data-md-state\")\n if (tablet)\n el.checked = false\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n mapTo,\n mergeMap,\n of,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n document$: Observable /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n { document$ }: PatchOptions\n): void {\n document$\n .pipe(\n switchMap(() => of(...getElements(\"[data-md-scrollfix]\"))),\n tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n filter(isAppleDevice),\n mergeMap(el => fromEvent(el, \"touchstart\")\n .pipe(\n mapTo(el)\n )\n )\n )\n .subscribe(el => {\n const top = el.scrollTop\n\n /* We're at the top of the container */\n if (top === 0) {\n el.scrollTop = 1\n\n /* We're at the bottom of the container */\n } else if (top + el.offsetHeight === el.scrollHeight) {\n el.scrollTop = top - 1\n }\n })\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n delay,\n map,\n of,\n switchMap,\n withLatestFrom\n} from \"rxjs\"\n\nimport {\n Viewport,\n watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n viewport$: Observable /* Viewport observable */\n tablet$: Observable /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n { viewport$, tablet$ }: PatchOptions\n): void {\n combineLatest([watchToggle(\"search\"), tablet$])\n .pipe(\n map(([active, tablet]) => active && !tablet),\n switchMap(active => of(active)\n .pipe(\n delay(active ? 400 : 100)\n )\n ),\n withLatestFrom(viewport$)\n )\n .subscribe(([active, { offset: { y }}]) => {\n if (active) {\n document.body.setAttribute(\"data-md-state\", \"lock\")\n document.body.style.top = `-${y}px`\n } else {\n const value = -1 * parseInt(document.body.style.top, 10)\n document.body.removeAttribute(\"data-md-state\")\n document.body.style.top = \"\"\n if (value)\n window.scrollTo(0, value)\n }\n })\n}\n"], + "mappings": "4iCAAA,oBAAC,UAAU,EAAQ,EAAS,CAC1B,MAAO,KAAY,UAAY,MAAO,KAAW,YAAc,IAC/D,MAAO,SAAW,YAAc,OAAO,IAAM,OAAO,GACnD,MACD,GAAO,UAAY,CAAE,aASrB,WAAmC,EAAO,CACxC,GAAI,GAAmB,GACnB,EAA0B,GAC1B,EAAiC,KAEjC,EAAsB,CACxB,KAAM,GACN,OAAQ,GACR,IAAK,GACL,IAAK,GACL,MAAO,GACP,SAAU,GACV,OAAQ,GACR,KAAM,GACN,MAAO,GACP,KAAM,GACN,KAAM,GACN,SAAU,GACV,iBAAkB,IAQpB,WAA4B,EAAI,CAC9B,MACE,MACA,IAAO,UACP,EAAG,WAAa,QAChB,EAAG,WAAa,QAChB,aAAe,IACf,YAAc,GAAG,WAcrB,WAAuC,EAAI,CACzC,GAAI,IAAO,EAAG,KACV,GAAU,EAAG,QAUjB,MARI,QAAY,SAAW,EAAoB,KAAS,CAAC,EAAG,UAIxD,KAAY,YAAc,CAAC,EAAG,UAI9B,EAAG,mBAYT,WAA8B,EAAI,CAChC,AAAI,EAAG,UAAU,SAAS,kBAG1B,GAAG,UAAU,IAAI,iBACjB,EAAG,aAAa,2BAA4B,KAQ9C,WAAiC,EAAI,CACnC,AAAI,CAAC,EAAG,aAAa,6BAGrB,GAAG,UAAU,OAAO,iBACpB,EAAG,gBAAgB,6BAWrB,WAAmB,EAAG,CACpB,AAAI,EAAE,SAAW,EAAE,QAAU,EAAE,SAI3B,GAAmB,EAAM,gBAC3B,EAAqB,EAAM,eAG7B,EAAmB,IAWrB,WAAuB,EAAG,CACxB,EAAmB,GAUrB,WAAiB,EAAG,CAElB,AAAI,CAAC,EAAmB,EAAE,SAItB,IAAoB,EAA8B,EAAE,UACtD,EAAqB,EAAE,QAQ3B,WAAgB,EAAG,CACjB,AAAI,CAAC,EAAmB,EAAE,SAKxB,GAAE,OAAO,UAAU,SAAS,kBAC5B,EAAE,OAAO,aAAa,8BAMtB,GAA0B,GAC1B,OAAO,aAAa,GACpB,EAAiC,OAAO,WAAW,UAAW,CAC5D,EAA0B,IACzB,KACH,EAAwB,EAAE,SAS9B,WAA4B,EAAG,CAC7B,AAAI,SAAS,kBAAoB,UAK3B,IACF,GAAmB,IAErB,KAUJ,YAA0C,CACxC,SAAS,iBAAiB,YAAa,GACvC,SAAS,iBAAiB,YAAa,GACvC,SAAS,iBAAiB,UAAW,GACrC,SAAS,iBAAiB,cAAe,GACzC,SAAS,iBAAiB,cAAe,GACzC,SAAS,iBAAiB,YAAa,GACvC,SAAS,iBAAiB,YAAa,GACvC,SAAS,iBAAiB,aAAc,GACxC,SAAS,iBAAiB,WAAY,GAGxC,YAA6C,CAC3C,SAAS,oBAAoB,YAAa,GAC1C,SAAS,oBAAoB,YAAa,GAC1C,SAAS,oBAAoB,UAAW,GACxC,SAAS,oBAAoB,cAAe,GAC5C,SAAS,oBAAoB,cAAe,GAC5C,SAAS,oBAAoB,YAAa,GAC1C,SAAS,oBAAoB,YAAa,GAC1C,SAAS,oBAAoB,aAAc,GAC3C,SAAS,oBAAoB,WAAY,GAU3C,WAA8B,EAAG,CAG/B,AAAI,EAAE,OAAO,UAAY,EAAE,OAAO,SAAS,gBAAkB,QAI7D,GAAmB,GACnB,KAMF,SAAS,iBAAiB,UAAW,EAAW,IAChD,SAAS,iBAAiB,YAAa,EAAe,IACtD,SAAS,iBAAiB,cAAe,EAAe,IACxD,SAAS,iBAAiB,aAAc,EAAe,IACvD,SAAS,iBAAiB,mBAAoB,EAAoB,IAElE,IAMA,EAAM,iBAAiB,QAAS,EAAS,IACzC,EAAM,iBAAiB,OAAQ,EAAQ,IAOvC,AAAI,EAAM,WAAa,KAAK,wBAA0B,EAAM,KAI1D,EAAM,KAAK,aAAa,wBAAyB,IACxC,EAAM,WAAa,KAAK,eACjC,UAAS,gBAAgB,UAAU,IAAI,oBACvC,SAAS,gBAAgB,aAAa,wBAAyB,KAOnE,GAAI,MAAO,SAAW,aAAe,MAAO,WAAa,YAAa,CAIpE,OAAO,0BAA4B,EAInC,GAAI,GAEJ,GAAI,CACF,EAAQ,GAAI,aAAY,sCACjB,EAAP,CAEA,EAAQ,SAAS,YAAY,eAC7B,EAAM,gBAAgB,+BAAgC,GAAO,GAAO,IAGtE,OAAO,cAAc,GAGvB,AAAI,MAAO,WAAa,aAGtB,EAA0B,cCpT9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gFAeA,GAAI,IACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACJ,AAAC,UAAU,EAAS,CAChB,GAAI,GAAO,MAAO,SAAW,SAAW,OAAS,MAAO,OAAS,SAAW,KAAO,MAAO,OAAS,SAAW,KAAO,GACrH,AAAI,MAAO,SAAW,YAAc,OAAO,IACvC,OAAO,QAAS,CAAC,WAAY,SAAU,EAAS,CAAE,EAAQ,EAAe,EAAM,EAAe,OAE7F,AAAI,MAAO,KAAW,UAAY,MAAO,IAAO,SAAY,SAC7D,EAAQ,EAAe,EAAM,EAAe,GAAO,WAGnD,EAAQ,EAAe,IAE3B,WAAwB,EAAS,EAAU,CACvC,MAAI,KAAY,GACZ,CAAI,MAAO,QAAO,QAAW,WACzB,OAAO,eAAe,EAAS,aAAc,CAAE,MAAO,KAGtD,EAAQ,WAAa,IAGtB,SAAU,EAAI,EAAG,CAAE,MAAO,GAAQ,GAAM,EAAW,EAAS,EAAI,GAAK,MAGnF,SAAU,EAAU,CACjB,GAAI,GAAgB,OAAO,gBACtB,CAAE,UAAW,aAAgB,QAAS,SAAU,EAAG,EAAG,CAAE,EAAE,UAAY,IACvE,SAAU,EAAG,EAAG,CAAE,OAAS,KAAK,GAAG,AAAI,OAAO,UAAU,eAAe,KAAK,EAAG,IAAI,GAAE,GAAK,EAAE,KAEhG,GAAY,SAAU,EAAG,EAAG,CACxB,GAAI,MAAO,IAAM,YAAc,IAAM,KACjC,KAAM,IAAI,WAAU,uBAAyB,OAAO,GAAK,iCAC7D,EAAc,EAAG,GACjB,YAAc,CAAE,KAAK,YAAc,EACnC,EAAE,UAAY,IAAM,KAAO,OAAO,OAAO,GAAM,GAAG,UAAY,EAAE,UAAW,GAAI,KAGnF,GAAW,OAAO,QAAU,SAAU,EAAG,CACrC,OAAS,GAAG,EAAI,EAAG,EAAI,UAAU,OAAQ,EAAI,EAAG,IAAK,CACjD,EAAI,UAAU,GACd,OAAS,KAAK,GAAG,AAAI,OAAO,UAAU,eAAe,KAAK,EAAG,IAAI,GAAE,GAAK,EAAE,IAE9E,MAAO,IAGX,GAAS,SAAU,EAAG,EAAG,CACrB,GAAI,GAAI,GACR,OAAS,KAAK,GAAG,AAAI,OAAO,UAAU,eAAe,KAAK,EAAG,IAAM,EAAE,QAAQ,GAAK,GAC9E,GAAE,GAAK,EAAE,IACb,GAAI,GAAK,MAAQ,MAAO,QAAO,uBAA0B,WACrD,OAAS,GAAI,EAAG,EAAI,OAAO,sBAAsB,GAAI,EAAI,EAAE,OAAQ,IAC/D,AAAI,EAAE,QAAQ,EAAE,IAAM,GAAK,OAAO,UAAU,qBAAqB,KAAK,EAAG,EAAE,KACvE,GAAE,EAAE,IAAM,EAAE,EAAE,KAE1B,MAAO,IAGX,GAAa,SAAU,EAAY,EAAQ,EAAK,EAAM,CAClD,GAAI,GAAI,UAAU,OAAQ,EAAI,EAAI,EAAI,EAAS,IAAS,KAAO,EAAO,OAAO,yBAAyB,EAAQ,GAAO,EAAM,EAC3H,GAAI,MAAO,UAAY,UAAY,MAAO,SAAQ,UAAa,WAAY,EAAI,QAAQ,SAAS,EAAY,EAAQ,EAAK,OACpH,QAAS,GAAI,EAAW,OAAS,EAAG,GAAK,EAAG,IAAK,AAAI,GAAI,EAAW,KAAI,GAAK,GAAI,EAAI,EAAE,GAAK,EAAI,EAAI,EAAE,EAAQ,EAAK,GAAK,EAAE,EAAQ,KAAS,GAChJ,MAAO,GAAI,GAAK,GAAK,OAAO,eAAe,EAAQ,EAAK,GAAI,GAGhE,GAAU,SAAU,EAAY,EAAW,CACvC,MAAO,UAAU,EAAQ,EAAK,CAAE,EAAU,EAAQ,EAAK,KAG3D,GAAa,SAAU,EAAa,EAAe,CAC/C,GAAI,MAAO,UAAY,UAAY,MAAO,SAAQ,UAAa,WAAY,MAAO,SAAQ,SAAS,EAAa,IAGpH,GAAY,SAAU,EAAS,EAAY,EAAG,EAAW,CACrD,WAAe,EAAO,CAAE,MAAO,aAAiB,GAAI,EAAQ,GAAI,GAAE,SAAU,EAAS,CAAE,EAAQ,KAC/F,MAAO,IAAK,IAAM,GAAI,UAAU,SAAU,EAAS,EAAQ,CACvD,WAAmB,EAAO,CAAE,GAAI,CAAE,EAAK,EAAU,KAAK,UAAkB,EAAP,CAAY,EAAO,IACpF,WAAkB,EAAO,CAAE,GAAI,CAAE,EAAK,EAAU,MAAS,UAAkB,EAAP,CAAY,EAAO,IACvF,WAAc,EAAQ,CAAE,EAAO,KAAO,EAAQ,EAAO,OAAS,EAAM,EAAO,OAAO,KAAK,EAAW,GAClG,EAAM,GAAY,EAAU,MAAM,EAAS,GAAc,KAAK,WAItE,GAAc,SAAU,EAAS,EAAM,CACnC,GAAI,GAAI,CAAE,MAAO,EAAG,KAAM,UAAW,CAAE,GAAI,EAAE,GAAK,EAAG,KAAM,GAAE,GAAI,MAAO,GAAE,IAAO,KAAM,GAAI,IAAK,IAAM,EAAG,EAAG,EAAG,EAC/G,MAAO,GAAI,CAAE,KAAM,EAAK,GAAI,MAAS,EAAK,GAAI,OAAU,EAAK,IAAM,MAAO,SAAW,YAAe,GAAE,OAAO,UAAY,UAAW,CAAE,MAAO,QAAU,EACvJ,WAAc,EAAG,CAAE,MAAO,UAAU,EAAG,CAAE,MAAO,GAAK,CAAC,EAAG,KACzD,WAAc,EAAI,CACd,GAAI,EAAG,KAAM,IAAI,WAAU,mCAC3B,KAAO,GAAG,GAAI,CACV,GAAI,EAAI,EAAG,GAAM,GAAI,EAAG,GAAK,EAAI,EAAE,OAAY,EAAG,GAAK,EAAE,OAAc,IAAI,EAAE,SAAc,EAAE,KAAK,GAAI,GAAK,EAAE,OAAS,CAAE,GAAI,EAAE,KAAK,EAAG,EAAG,KAAK,KAAM,MAAO,GAE3J,OADI,EAAI,EAAG,GAAG,GAAK,CAAC,EAAG,GAAK,EAAG,EAAE,QACzB,EAAG,QACF,OAAQ,GAAG,EAAI,EAAI,UACnB,GAAG,SAAE,QAAgB,CAAE,MAAO,EAAG,GAAI,KAAM,QAC3C,GAAG,EAAE,QAAS,EAAI,EAAG,GAAI,EAAK,CAAC,GAAI,aACnC,GAAG,EAAK,EAAE,IAAI,MAAO,EAAE,KAAK,MAAO,iBAEpC,GAAM,EAAI,EAAE,KAAM,IAAI,EAAE,OAAS,GAAK,EAAE,EAAE,OAAS,KAAQ,GAAG,KAAO,GAAK,EAAG,KAAO,GAAI,CAAE,EAAI,EAAG,SACjG,GAAI,EAAG,KAAO,GAAM,EAAC,GAAM,EAAG,GAAK,EAAE,IAAM,EAAG,GAAK,EAAE,IAAM,CAAE,EAAE,MAAQ,EAAG,GAAI,MAC9E,GAAI,EAAG,KAAO,GAAK,EAAE,MAAQ,EAAE,GAAI,CAAE,EAAE,MAAQ,EAAE,GAAI,EAAI,EAAI,MAC7D,GAAI,GAAK,EAAE,MAAQ,EAAE,GAAI,CAAE,EAAE,MAAQ,EAAE,GAAI,EAAE,IAAI,KAAK,GAAK,MAC3D,AAAI,EAAE,IAAI,EAAE,IAAI,MAChB,EAAE,KAAK,MAAO,SAEtB,EAAK,EAAK,KAAK,EAAS,SACnB,EAAP,CAAY,EAAK,CAAC,EAAG,GAAI,EAAI,SAAK,CAAU,EAAI,EAAI,EACtD,GAAI,EAAG,GAAK,EAAG,KAAM,GAAG,GAAI,MAAO,CAAE,MAAO,EAAG,GAAK,EAAG,GAAK,OAAQ,KAAM,MAIlF,GAAe,SAAS,EAAG,EAAG,CAC1B,OAAS,KAAK,GAAG,AAAI,IAAM,WAAa,CAAC,OAAO,UAAU,eAAe,KAAK,EAAG,IAAI,GAAgB,EAAG,EAAG,IAG/G,GAAkB,OAAO,OAAU,SAAS,EAAG,EAAG,EAAG,EAAI,CACrD,AAAI,IAAO,QAAW,GAAK,GAC3B,OAAO,eAAe,EAAG,EAAI,CAAE,WAAY,GAAM,IAAK,UAAW,CAAE,MAAO,GAAE,OAC1E,SAAS,EAAG,EAAG,EAAG,EAAI,CACxB,AAAI,IAAO,QAAW,GAAK,GAC3B,EAAE,GAAM,EAAE,IAGd,GAAW,SAAU,EAAG,CACpB,GAAI,GAAI,MAAO,SAAW,YAAc,OAAO,SAAU,EAAI,GAAK,EAAE,GAAI,EAAI,EAC5E,GAAI,EAAG,MAAO,GAAE,KAAK,GACrB,GAAI,GAAK,MAAO,GAAE,QAAW,SAAU,MAAO,CAC1C,KAAM,UAAY,CACd,MAAI,IAAK,GAAK,EAAE,QAAQ,GAAI,QACrB,CAAE,MAAO,GAAK,EAAE,KAAM,KAAM,CAAC,KAG5C,KAAM,IAAI,WAAU,EAAI,0BAA4B,oCAGxD,GAAS,SAAU,EAAG,EAAG,CACrB,GAAI,GAAI,MAAO,SAAW,YAAc,EAAE,OAAO,UACjD,GAAI,CAAC,EAAG,MAAO,GACf,GAAI,GAAI,EAAE,KAAK,GAAI,EAAG,EAAK,GAAI,EAC/B,GAAI,CACA,KAAQ,KAAM,QAAU,KAAM,IAAM,CAAE,GAAI,EAAE,QAAQ,MAAM,EAAG,KAAK,EAAE,aAEjE,EAAP,CAAgB,EAAI,CAAE,MAAO,UAC7B,CACI,GAAI,CACA,AAAI,GAAK,CAAC,EAAE,MAAS,GAAI,EAAE,SAAY,EAAE,KAAK,UAElD,CAAU,GAAI,EAAG,KAAM,GAAE,OAE7B,MAAO,IAIX,GAAW,UAAY,CACnB,OAAS,GAAK,GAAI,EAAI,EAAG,EAAI,UAAU,OAAQ,IAC3C,EAAK,EAAG,OAAO,GAAO,UAAU,KACpC,MAAO,IAIX,GAAiB,UAAY,CACzB,OAAS,GAAI,EAAG,EAAI,EAAG,EAAK,UAAU,OAAQ,EAAI,EAAI,IAAK,GAAK,UAAU,GAAG,OAC7E,OAAS,GAAI,MAAM,GAAI,EAAI,EAAG,EAAI,EAAG,EAAI,EAAI,IACzC,OAAS,GAAI,UAAU,GAAI,EAAI,EAAG,EAAK,EAAE,OAAQ,EAAI,EAAI,IAAK,IAC1D,EAAE,GAAK,EAAE,GACjB,MAAO,IAGX,GAAgB,SAAU,EAAI,EAAM,EAAM,CACtC,GAAI,GAAQ,UAAU,SAAW,EAAG,OAAS,GAAI,EAAG,EAAI,EAAK,OAAQ,EAAI,EAAI,EAAG,IAC5E,AAAI,IAAM,CAAE,KAAK,MACR,IAAI,GAAK,MAAM,UAAU,MAAM,KAAK,EAAM,EAAG,IAClD,EAAG,GAAK,EAAK,IAGrB,MAAO,GAAG,OAAO,GAAM,MAAM,UAAU,MAAM,KAAK,KAGtD,GAAU,SAAU,EAAG,CACnB,MAAO,gBAAgB,IAAW,MAAK,EAAI,EAAG,MAAQ,GAAI,IAAQ,IAGtE,GAAmB,SAAU,EAAS,EAAY,EAAW,CACzD,GAAI,CAAC,OAAO,cAAe,KAAM,IAAI,WAAU,wCAC/C,GAAI,GAAI,EAAU,MAAM,EAAS,GAAc,IAAK,EAAG,EAAI,GAC3D,MAAO,GAAI,GAAI,EAAK,QAAS,EAAK,SAAU,EAAK,UAAW,EAAE,OAAO,eAAiB,UAAY,CAAE,MAAO,OAAS,EACpH,WAAc,EAAG,CAAE,AAAI,EAAE,IAAI,GAAE,GAAK,SAAU,EAAG,CAAE,MAAO,IAAI,SAAQ,SAAU,EAAG,EAAG,CAAE,EAAE,KAAK,CAAC,EAAG,EAAG,EAAG,IAAM,GAAK,EAAO,EAAG,OAC9H,WAAgB,EAAG,EAAG,CAAE,GAAI,CAAE,EAAK,EAAE,GAAG,UAAc,EAAP,CAAY,EAAO,EAAE,GAAG,GAAI,IAC3E,WAAc,EAAG,CAAE,EAAE,gBAAiB,IAAU,QAAQ,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAS,GAAU,EAAO,EAAE,GAAG,GAAI,GACnH,WAAiB,EAAO,CAAE,EAAO,OAAQ,GACzC,WAAgB,EAAO,CAAE,EAAO,QAAS,GACzC,WAAgB,EAAG,EAAG,CAAE,AAAI,EAAE,GAAI,EAAE,QAAS,EAAE,QAAQ,EAAO,EAAE,GAAG,GAAI,EAAE,GAAG,MAGhF,GAAmB,SAAU,EAAG,CAC5B,GAAI,GAAG,EACP,MAAO,GAAI,GAAI,EAAK,QAAS,EAAK,QAAS,SAAU,EAAG,CAAE,KAAM,KAAO,EAAK,UAAW,EAAE,OAAO,UAAY,UAAY,CAAE,MAAO,OAAS,EAC1I,WAAc,EAAG,EAAG,CAAE,EAAE,GAAK,EAAE,GAAK,SAAU,EAAG,CAAE,MAAQ,GAAI,CAAC,GAAK,CAAE,MAAO,GAAQ,EAAE,GAAG,IAAK,KAAM,IAAM,UAAa,EAAI,EAAE,GAAK,GAAO,IAG/I,GAAgB,SAAU,EAAG,CACzB,GAAI,CAAC,OAAO,cAAe,KAAM,IAAI,WAAU,wCAC/C,GAAI,GAAI,EAAE,OAAO,eAAgB,EACjC,MAAO,GAAI,EAAE,KAAK,GAAM,GAAI,MAAO,KAAa,WAAa,GAAS,GAAK,EAAE,OAAO,YAAa,EAAI,GAAI,EAAK,QAAS,EAAK,SAAU,EAAK,UAAW,EAAE,OAAO,eAAiB,UAAY,CAAE,MAAO,OAAS,GAC9M,WAAc,EAAG,CAAE,EAAE,GAAK,EAAE,IAAM,SAAU,EAAG,CAAE,MAAO,IAAI,SAAQ,SAAU,EAAS,EAAQ,CAAE,EAAI,EAAE,GAAG,GAAI,EAAO,EAAS,EAAQ,EAAE,KAAM,EAAE,UAChJ,WAAgB,EAAS,EAAQ,EAAG,EAAG,CAAE,QAAQ,QAAQ,GAAG,KAAK,SAAS,EAAG,CAAE,EAAQ,CAAE,MAAO,EAAG,KAAM,KAAS,KAGtH,GAAuB,SAAU,EAAQ,EAAK,CAC1C,MAAI,QAAO,eAAkB,OAAO,eAAe,EAAQ,MAAO,CAAE,MAAO,IAAiB,EAAO,IAAM,EAClG,GAGX,GAAI,GAAqB,OAAO,OAAU,SAAS,EAAG,EAAG,CACrD,OAAO,eAAe,EAAG,UAAW,CAAE,WAAY,GAAM,MAAO,KAC9D,SAAS,EAAG,EAAG,CAChB,EAAE,QAAa,GAGnB,GAAe,SAAU,EAAK,CAC1B,GAAI,GAAO,EAAI,WAAY,MAAO,GAClC,GAAI,GAAS,GACb,GAAI,GAAO,KAAM,OAAS,KAAK,GAAK,AAAI,IAAM,WAAa,OAAO,UAAU,eAAe,KAAK,EAAK,IAAI,GAAgB,EAAQ,EAAK,GACtI,SAAmB,EAAQ,GACpB,GAGX,GAAkB,SAAU,EAAK,CAC7B,MAAQ,IAAO,EAAI,WAAc,EAAM,CAAE,QAAW,IAGxD,GAAyB,SAAU,EAAU,EAAO,EAAM,EAAG,CACzD,GAAI,IAAS,KAAO,CAAC,EAAG,KAAM,IAAI,WAAU,iDAC5C,GAAI,MAAO,IAAU,WAAa,IAAa,GAAS,CAAC,EAAI,CAAC,EAAM,IAAI,GAAW,KAAM,IAAI,WAAU,4EACvG,MAAO,KAAS,IAAM,EAAI,IAAS,IAAM,EAAE,KAAK,GAAY,EAAI,EAAE,MAAQ,EAAM,IAAI,IAGxF,GAAyB,SAAU,EAAU,EAAO,EAAO,EAAM,EAAG,CAChE,GAAI,IAAS,IAAK,KAAM,IAAI,WAAU,kCACtC,GAAI,IAAS,KAAO,CAAC,EAAG,KAAM,IAAI,WAAU,iDAC5C,GAAI,MAAO,IAAU,WAAa,IAAa,GAAS,CAAC,EAAI,CAAC,EAAM,IAAI,GAAW,KAAM,IAAI,WAAU,2EACvG,MAAQ,KAAS,IAAM,EAAE,KAAK,EAAU,GAAS,EAAI,EAAE,MAAQ,EAAQ,EAAM,IAAI,EAAU,GAAS,GAGxG,EAAS,YAAa,IACtB,EAAS,WAAY,IACrB,EAAS,SAAU,IACnB,EAAS,aAAc,IACvB,EAAS,UAAW,IACpB,EAAS,aAAc,IACvB,EAAS,YAAa,IACtB,EAAS,cAAe,IACxB,EAAS,eAAgB,IACzB,EAAS,kBAAmB,IAC5B,EAAS,WAAY,IACrB,EAAS,SAAU,IACnB,EAAS,WAAY,IACrB,EAAS,iBAAkB,IAC3B,EAAS,gBAAiB,IAC1B,EAAS,UAAW,IACpB,EAAS,mBAAoB,IAC7B,EAAS,mBAAoB,IAC7B,EAAS,gBAAiB,IAC1B,EAAS,uBAAwB,IACjC,EAAS,eAAgB,IACzB,EAAS,kBAAmB,IAC5B,EAAS,yBAA0B,IACnC,EAAS,yBAA0B,QChTvC;AAAA;AAAA;AAAA;AAAA;AAAA,GAMA,AAAC,UAA0C,EAAM,EAAS,CACzD,AAAG,MAAO,KAAY,UAAY,MAAO,KAAW,SACnD,GAAO,QAAU,IACb,AAAG,MAAO,SAAW,YAAc,OAAO,IAC9C,OAAO,GAAI,GACP,AAAG,MAAO,KAAY,SAC1B,GAAQ,YAAiB,IAEzB,EAAK,YAAiB,MACrB,GAAM,UAAW,CACpB,MAAiB,WAAW,CAClB,GAAI,GAAuB,CAE/B,IACC,SAAS,EAAyB,EAAqB,EAAqB,CAEnF,aAGA,EAAoB,EAAE,EAAqB,CACzC,QAAW,UAAW,CAAE,MAAqB,OAI/C,GAAI,GAAe,EAAoB,KACnC,EAAoC,EAAoB,EAAE,GAE1D,EAAS,EAAoB,KAC7B,EAA8B,EAAoB,EAAE,GAEpD,EAAa,EAAoB,KACjC,EAA8B,EAAoB,EAAE,GAExD,WAAiB,EAAK,CAA6B,MAAI,OAAO,SAAW,YAAc,MAAO,QAAO,UAAa,SAAY,EAAU,SAAiB,EAAK,CAAE,MAAO,OAAO,IAAiB,EAAU,SAAiB,EAAK,CAAE,MAAO,IAAO,MAAO,SAAW,YAAc,EAAI,cAAgB,QAAU,IAAQ,OAAO,UAAY,SAAW,MAAO,IAAiB,EAAQ,GAEnX,WAAyB,EAAU,EAAa,CAAE,GAAI,CAAE,aAAoB,IAAgB,KAAM,IAAI,WAAU,qCAEhH,WAA2B,EAAQ,EAAO,CAAE,OAAS,GAAI,EAAG,EAAI,EAAM,OAAQ,IAAK,CAAE,GAAI,GAAa,EAAM,GAAI,EAAW,WAAa,EAAW,YAAc,GAAO,EAAW,aAAe,GAAU,SAAW,IAAY,GAAW,SAAW,IAAM,OAAO,eAAe,EAAQ,EAAW,IAAK,IAE7S,WAAsB,EAAa,EAAY,EAAa,CAAE,MAAI,IAAY,EAAkB,EAAY,UAAW,GAAiB,GAAa,EAAkB,EAAa,GAAqB,EAQzM,GAAI,GAA+B,UAAY,CAI7C,WAAyB,EAAS,CAChC,EAAgB,KAAM,GAEtB,KAAK,eAAe,GACpB,KAAK,gBAQP,SAAa,EAAiB,CAAC,CAC7B,IAAK,iBACL,MAAO,UAA0B,CAC/B,GAAI,GAAU,UAAU,OAAS,GAAK,UAAU,KAAO,OAAY,UAAU,GAAK,GAClF,KAAK,OAAS,EAAQ,OACtB,KAAK,UAAY,EAAQ,UACzB,KAAK,QAAU,EAAQ,QACvB,KAAK,OAAS,EAAQ,OACtB,KAAK,KAAO,EAAQ,KACpB,KAAK,QAAU,EAAQ,QACvB,KAAK,aAAe,KAOrB,CACD,IAAK,gBACL,MAAO,UAAyB,CAC9B,AAAI,KAAK,KACP,KAAK,aACI,KAAK,QACd,KAAK,iBAOR,CACD,IAAK,oBACL,MAAO,UAA6B,CAClC,GAAI,GAAQ,SAAS,gBAAgB,aAAa,SAAW,MAC7D,KAAK,SAAW,SAAS,cAAc,YAEvC,KAAK,SAAS,MAAM,SAAW,OAE/B,KAAK,SAAS,MAAM,OAAS,IAC7B,KAAK,SAAS,MAAM,QAAU,IAC9B,KAAK,SAAS,MAAM,OAAS,IAE7B,KAAK,SAAS,MAAM,SAAW,WAC/B,KAAK,SAAS,MAAM,EAAQ,QAAU,QAAU,UAEhD,GAAI,GAAY,OAAO,aAAe,SAAS,gBAAgB,UAC/D,YAAK,SAAS,MAAM,IAAM,GAAG,OAAO,EAAW,MAC/C,KAAK,SAAS,aAAa,WAAY,IACvC,KAAK,SAAS,MAAQ,KAAK,KACpB,KAAK,WAOb,CACD,IAAK,aACL,MAAO,UAAsB,CAC3B,GAAI,GAAQ,KAER,EAAW,KAAK,oBAEpB,KAAK,oBAAsB,UAAY,CACrC,MAAO,GAAM,cAGf,KAAK,YAAc,KAAK,UAAU,iBAAiB,QAAS,KAAK,sBAAwB,GACzF,KAAK,UAAU,YAAY,GAC3B,KAAK,aAAe,IAAiB,GACrC,KAAK,WACL,KAAK,eAON,CACD,IAAK,aACL,MAAO,UAAsB,CAC3B,AAAI,KAAK,aACP,MAAK,UAAU,oBAAoB,QAAS,KAAK,qBACjD,KAAK,YAAc,KACnB,KAAK,oBAAsB,MAGzB,KAAK,UACP,MAAK,UAAU,YAAY,KAAK,UAChC,KAAK,SAAW,QAOnB,CACD,IAAK,eACL,MAAO,UAAwB,CAC7B,KAAK,aAAe,IAAiB,KAAK,QAC1C,KAAK,aAMN,CACD,IAAK,WACL,MAAO,UAAoB,CACzB,GAAI,GAEJ,GAAI,CACF,EAAY,SAAS,YAAY,KAAK,cAC/B,EAAP,CACA,EAAY,GAGd,KAAK,aAAa,KAOnB,CACD,IAAK,eACL,MAAO,SAAsB,EAAW,CACtC,KAAK,QAAQ,KAAK,EAAY,UAAY,QAAS,CACjD,OAAQ,KAAK,OACb,KAAM,KAAK,aACX,QAAS,KAAK,QACd,eAAgB,KAAK,eAAe,KAAK,UAO5C,CACD,IAAK,iBACL,MAAO,UAA0B,CAC/B,AAAI,KAAK,SACP,KAAK,QAAQ,QAGf,SAAS,cAAc,OACvB,OAAO,eAAe,oBAOvB,CACD,IAAK,UAKL,MAAO,UAAmB,CACxB,KAAK,eAEN,CACD,IAAK,SACL,IAAK,UAAe,CAClB,GAAI,GAAS,UAAU,OAAS,GAAK,UAAU,KAAO,OAAY,UAAU,GAAK,OAGjF,GAFA,KAAK,QAAU,EAEX,KAAK,UAAY,QAAU,KAAK,UAAY,MAC9C,KAAM,IAAI,OAAM,uDAQpB,IAAK,UAAe,CAClB,MAAO,MAAK,UAQb,CACD,IAAK,SACL,IAAK,SAAa,EAAQ,CACxB,GAAI,IAAW,OACb,GAAI,GAAU,EAAQ,KAAY,UAAY,EAAO,WAAa,EAAG,CACnE,GAAI,KAAK,SAAW,QAAU,EAAO,aAAa,YAChD,KAAM,IAAI,OAAM,qFAGlB,GAAI,KAAK,SAAW,OAAU,GAAO,aAAa,aAAe,EAAO,aAAa,aACnF,KAAM,IAAI,OAAM,yGAGlB,KAAK,QAAU,MAEf,MAAM,IAAI,OAAM,gDAStB,IAAK,UAAe,CAClB,MAAO,MAAK,YAIT,KAGwB,EAAoB,EAErD,WAA0B,EAAK,CAA6B,MAAI,OAAO,SAAW,YAAc,MAAO,QAAO,UAAa,SAAY,EAAmB,SAAiB,EAAK,CAAE,MAAO,OAAO,IAAiB,EAAmB,SAAiB,EAAK,CAAE,MAAO,IAAO,MAAO,SAAW,YAAc,EAAI,cAAgB,QAAU,IAAQ,OAAO,UAAY,SAAW,MAAO,IAAiB,EAAiB,GAEvZ,WAAkC,EAAU,EAAa,CAAE,GAAI,CAAE,aAAoB,IAAgB,KAAM,IAAI,WAAU,qCAEzH,YAAoC,EAAQ,EAAO,CAAE,OAAS,GAAI,EAAG,EAAI,EAAM,OAAQ,IAAK,CAAE,GAAI,GAAa,EAAM,GAAI,EAAW,WAAa,EAAW,YAAc,GAAO,EAAW,aAAe,GAAU,SAAW,IAAY,GAAW,SAAW,IAAM,OAAO,eAAe,EAAQ,EAAW,IAAK,IAEtT,YAA+B,EAAa,EAAY,EAAa,CAAE,MAAI,IAAY,GAA2B,EAAY,UAAW,GAAiB,GAAa,GAA2B,EAAa,GAAqB,EAEpO,YAAmB,EAAU,EAAY,CAAE,GAAI,MAAO,IAAe,YAAc,IAAe,KAAQ,KAAM,IAAI,WAAU,sDAAyD,EAAS,UAAY,OAAO,OAAO,GAAc,EAAW,UAAW,CAAE,YAAa,CAAE,MAAO,EAAU,SAAU,GAAM,aAAc,MAAe,GAAY,GAAgB,EAAU,GAEnX,YAAyB,EAAG,EAAG,CAAE,UAAkB,OAAO,gBAAkB,SAAyB,EAAG,EAAG,CAAE,SAAE,UAAY,EAAU,GAAa,GAAgB,EAAG,GAErK,YAAsB,EAAS,CAAE,GAAI,GAA4B,KAA6B,MAAO,WAAgC,CAAE,GAAI,GAAQ,GAAgB,GAAU,EAAQ,GAAI,EAA2B,CAAE,GAAI,IAAY,GAAgB,MAAM,YAAa,EAAS,QAAQ,UAAU,EAAO,UAAW,QAAqB,GAAS,EAAM,MAAM,KAAM,WAAc,MAAO,IAA2B,KAAM,IAE5Z,YAAoC,EAAM,EAAM,CAAE,MAAI,IAAS,GAAiB,KAAU,UAAY,MAAO,IAAS,YAAsB,EAAe,GAAuB,GAElL,YAAgC,EAAM,CAAE,GAAI,IAAS,OAAU,KAAM,IAAI,gBAAe,6DAAgE,MAAO,GAE/J,aAAqC,CAA0E,GAApE,MAAO,UAAY,aAAe,CAAC,QAAQ,WAA6B,QAAQ,UAAU,KAAM,MAAO,GAAO,GAAI,MAAO,QAAU,WAAY,MAAO,GAAM,GAAI,CAAE,YAAK,UAAU,SAAS,KAAK,QAAQ,UAAU,KAAM,GAAI,UAAY,KAAa,SAAe,EAAP,CAAY,MAAO,IAE1T,YAAyB,EAAG,CAAE,UAAkB,OAAO,eAAiB,OAAO,eAAiB,SAAyB,EAAG,CAAE,MAAO,GAAE,WAAa,OAAO,eAAe,IAAc,GAAgB,GAWxM,YAA2B,EAAQ,EAAS,CAC1C,GAAI,GAAY,kBAAkB,OAAO,GAEzC,GAAI,EAAC,EAAQ,aAAa,GAI1B,MAAO,GAAQ,aAAa,GAQ9B,GAAI,IAAyB,SAAU,EAAU,CAC/C,GAAU,EAAW,GAErB,GAAI,GAAS,GAAa,GAM1B,WAAmB,EAAS,EAAS,CACnC,GAAI,IAEJ,SAAyB,KAAM,GAE/B,GAAQ,EAAO,KAAK,MAEpB,GAAM,eAAe,GAErB,GAAM,YAAY,GAEX,GAST,UAAsB,EAAW,CAAC,CAChC,IAAK,iBACL,MAAO,UAA0B,CAC/B,GAAI,GAAU,UAAU,OAAS,GAAK,UAAU,KAAO,OAAY,UAAU,GAAK,GAClF,KAAK,OAAS,MAAO,GAAQ,QAAW,WAAa,EAAQ,OAAS,KAAK,cAC3E,KAAK,OAAS,MAAO,GAAQ,QAAW,WAAa,EAAQ,OAAS,KAAK,cAC3E,KAAK,KAAO,MAAO,GAAQ,MAAS,WAAa,EAAQ,KAAO,KAAK,YACrE,KAAK,UAAY,EAAiB,EAAQ,aAAe,SAAW,EAAQ,UAAY,SAAS,OAOlG,CACD,IAAK,cACL,MAAO,SAAqB,EAAS,CACnC,GAAI,IAAS,KAEb,KAAK,SAAW,IAAiB,EAAS,QAAS,SAAU,GAAG,CAC9D,MAAO,IAAO,QAAQ,QAQzB,CACD,IAAK,UACL,MAAO,SAAiB,EAAG,CACzB,GAAI,IAAU,EAAE,gBAAkB,EAAE,cAEpC,AAAI,KAAK,iBACP,MAAK,gBAAkB,MAGzB,KAAK,gBAAkB,GAAI,GAAiB,CAC1C,OAAQ,KAAK,OAAO,IACpB,OAAQ,KAAK,OAAO,IACpB,KAAM,KAAK,KAAK,IAChB,UAAW,KAAK,UAChB,QAAS,GACT,QAAS,SAQZ,CACD,IAAK,gBACL,MAAO,SAAuB,EAAS,CACrC,MAAO,IAAkB,SAAU,KAOpC,CACD,IAAK,gBACL,MAAO,SAAuB,EAAS,CACrC,GAAI,IAAW,GAAkB,SAAU,GAE3C,GAAI,GACF,MAAO,UAAS,cAAc,MASjC,CACD,IAAK,cAML,MAAO,SAAqB,EAAS,CACnC,MAAO,IAAkB,OAAQ,KAMlC,CACD,IAAK,UACL,MAAO,UAAmB,CACxB,KAAK,SAAS,UAEV,KAAK,iBACP,MAAK,gBAAgB,UACrB,KAAK,gBAAkB,SAGzB,CAAC,CACH,IAAK,cACL,MAAO,UAAuB,CAC5B,GAAI,GAAS,UAAU,OAAS,GAAK,UAAU,KAAO,OAAY,UAAU,GAAK,CAAC,OAAQ,OACtF,GAAU,MAAO,IAAW,SAAW,CAAC,GAAU,EAClD,GAAU,CAAC,CAAC,SAAS,sBACzB,UAAQ,QAAQ,SAAU,GAAQ,CAChC,GAAU,IAAW,CAAC,CAAC,SAAS,sBAAsB,MAEjD,OAIJ,GACN,KAE8B,GAAa,IAIxC,IACC,SAAS,EAAQ,CAExB,GAAI,GAAqB,EAKzB,GAAI,MAAO,UAAY,aAAe,CAAC,QAAQ,UAAU,QAAS,CAC9D,GAAI,GAAQ,QAAQ,UAEpB,EAAM,QAAU,EAAM,iBACN,EAAM,oBACN,EAAM,mBACN,EAAM,kBACN,EAAM,sBAU1B,WAAkB,EAAS,EAAU,CACjC,KAAO,GAAW,EAAQ,WAAa,GAAoB,CACvD,GAAI,MAAO,GAAQ,SAAY,YAC3B,EAAQ,QAAQ,GAClB,MAAO,GAET,EAAU,EAAQ,YAI1B,EAAO,QAAU,GAKX,IACC,SAAS,EAAQ,EAA0B,EAAqB,CAEvE,GAAI,GAAU,EAAoB,KAYlC,WAAmB,EAAS,EAAU,EAAM,EAAU,EAAY,CAC9D,GAAI,GAAa,EAAS,MAAM,KAAM,WAEtC,SAAQ,iBAAiB,EAAM,EAAY,GAEpC,CACH,QAAS,UAAW,CAChB,EAAQ,oBAAoB,EAAM,EAAY,KAe1D,WAAkB,EAAU,EAAU,EAAM,EAAU,EAAY,CAE9D,MAAI,OAAO,GAAS,kBAAqB,WAC9B,EAAU,MAAM,KAAM,WAI7B,MAAO,IAAS,WAGT,EAAU,KAAK,KAAM,UAAU,MAAM,KAAM,WAIlD,OAAO,IAAa,UACpB,GAAW,SAAS,iBAAiB,IAIlC,MAAM,UAAU,IAAI,KAAK,EAAU,SAAU,EAAS,CACzD,MAAO,GAAU,EAAS,EAAU,EAAM,EAAU,MAa5D,WAAkB,EAAS,EAAU,EAAM,EAAU,CACjD,MAAO,UAAS,EAAG,CACf,EAAE,eAAiB,EAAQ,EAAE,OAAQ,GAEjC,EAAE,gBACF,EAAS,KAAK,EAAS,IAKnC,EAAO,QAAU,GAKX,IACC,SAAS,EAAyB,EAAS,CAQlD,EAAQ,KAAO,SAAS,EAAO,CAC3B,MAAO,KAAU,QACV,YAAiB,cACjB,EAAM,WAAa,GAS9B,EAAQ,SAAW,SAAS,EAAO,CAC/B,GAAI,GAAO,OAAO,UAAU,SAAS,KAAK,GAE1C,MAAO,KAAU,QACT,KAAS,qBAAuB,IAAS,4BACzC,UAAY,IACZ,GAAM,SAAW,GAAK,EAAQ,KAAK,EAAM,MASrD,EAAQ,OAAS,SAAS,EAAO,CAC7B,MAAO,OAAO,IAAU,UACjB,YAAiB,SAS5B,EAAQ,GAAK,SAAS,EAAO,CACzB,GAAI,GAAO,OAAO,UAAU,SAAS,KAAK,GAE1C,MAAO,KAAS,sBAMd,IACC,SAAS,EAAQ,EAA0B,EAAqB,CAEvE,GAAI,GAAK,EAAoB,KACzB,EAAW,EAAoB,KAWnC,WAAgB,EAAQ,EAAM,EAAU,CACpC,GAAI,CAAC,GAAU,CAAC,GAAQ,CAAC,EACrB,KAAM,IAAI,OAAM,8BAGpB,GAAI,CAAC,EAAG,OAAO,GACX,KAAM,IAAI,WAAU,oCAGxB,GAAI,CAAC,EAAG,GAAG,GACP,KAAM,IAAI,WAAU,qCAGxB,GAAI,EAAG,KAAK,GACR,MAAO,GAAW,EAAQ,EAAM,GAE/B,GAAI,EAAG,SAAS,GACjB,MAAO,GAAe,EAAQ,EAAM,GAEnC,GAAI,EAAG,OAAO,GACf,MAAO,GAAe,EAAQ,EAAM,GAGpC,KAAM,IAAI,WAAU,6EAa5B,WAAoB,EAAM,EAAM,EAAU,CACtC,SAAK,iBAAiB,EAAM,GAErB,CACH,QAAS,UAAW,CAChB,EAAK,oBAAoB,EAAM,KAc3C,WAAwB,EAAU,EAAM,EAAU,CAC9C,aAAM,UAAU,QAAQ,KAAK,EAAU,SAAS,EAAM,CAClD,EAAK,iBAAiB,EAAM,KAGzB,CACH,QAAS,UAAW,CAChB,MAAM,UAAU,QAAQ,KAAK,EAAU,SAAS,EAAM,CAClD,EAAK,oBAAoB,EAAM,OAe/C,WAAwB,EAAU,EAAM,EAAU,CAC9C,MAAO,GAAS,SAAS,KAAM,EAAU,EAAM,GAGnD,EAAO,QAAU,GAKX,IACC,SAAS,EAAQ,CAExB,WAAgB,EAAS,CACrB,GAAI,GAEJ,GAAI,EAAQ,WAAa,SACrB,EAAQ,QAER,EAAe,EAAQ,cAElB,EAAQ,WAAa,SAAW,EAAQ,WAAa,WAAY,CACtE,GAAI,GAAa,EAAQ,aAAa,YAEtC,AAAK,GACD,EAAQ,aAAa,WAAY,IAGrC,EAAQ,SACR,EAAQ,kBAAkB,EAAG,EAAQ,MAAM,QAEtC,GACD,EAAQ,gBAAgB,YAG5B,EAAe,EAAQ,UAEtB,CACD,AAAI,EAAQ,aAAa,oBACrB,EAAQ,QAGZ,GAAI,GAAY,OAAO,eACnB,EAAQ,SAAS,cAErB,EAAM,mBAAmB,GACzB,EAAU,kBACV,EAAU,SAAS,GAEnB,EAAe,EAAU,WAG7B,MAAO,GAGX,EAAO,QAAU,GAKX,IACC,SAAS,EAAQ,CAExB,YAAc,EAKd,EAAE,UAAY,CACZ,GAAI,SAAU,EAAM,EAAU,EAAK,CACjC,GAAI,GAAI,KAAK,GAAM,MAAK,EAAI,IAE5B,MAAC,GAAE,IAAU,GAAE,GAAQ,KAAK,KAAK,CAC/B,GAAI,EACJ,IAAK,IAGA,MAGT,KAAM,SAAU,EAAM,EAAU,EAAK,CACnC,GAAI,GAAO,KACX,YAAqB,CACnB,EAAK,IAAI,EAAM,GACf,EAAS,MAAM,EAAK,WAGtB,SAAS,EAAI,EACN,KAAK,GAAG,EAAM,EAAU,IAGjC,KAAM,SAAU,EAAM,CACpB,GAAI,GAAO,GAAG,MAAM,KAAK,UAAW,GAChC,EAAW,OAAK,GAAM,MAAK,EAAI,KAAK,IAAS,IAAI,QACjD,EAAI,EACJ,EAAM,EAAO,OAEjB,IAAK,EAAG,EAAI,EAAK,IACf,EAAO,GAAG,GAAG,MAAM,EAAO,GAAG,IAAK,GAGpC,MAAO,OAGT,IAAK,SAAU,EAAM,EAAU,CAC7B,GAAI,GAAI,KAAK,GAAM,MAAK,EAAI,IACxB,EAAO,EAAE,GACT,EAAa,GAEjB,GAAI,GAAQ,EACV,OAAS,GAAI,EAAG,EAAM,EAAK,OAAQ,EAAI,EAAK,IAC1C,AAAI,EAAK,GAAG,KAAO,GAAY,EAAK,GAAG,GAAG,IAAM,GAC9C,EAAW,KAAK,EAAK,IAQ3B,MAAC,GAAW,OACR,EAAE,GAAQ,EACV,MAAO,GAAE,GAEN,OAIX,EAAO,QAAU,EACjB,EAAO,QAAQ,YAAc,IAQf,EAA2B,GAG/B,WAA6B,EAAU,CAEtC,GAAG,EAAyB,GAC3B,MAAO,GAAyB,GAAU,QAG3C,GAAI,GAAS,EAAyB,GAAY,CAGjD,QAAS,IAIV,SAAoB,GAAU,EAAQ,EAAO,QAAS,GAG/C,EAAO,QAKf,MAAC,WAAW,CAEX,EAAoB,EAAI,SAAS,EAAQ,CACxC,GAAI,GAAS,GAAU,EAAO,WAC7B,UAAW,CAAE,MAAO,GAAO,SAC3B,UAAW,CAAE,MAAO,IACrB,SAAoB,EAAE,EAAQ,CAAE,EAAG,IAC5B,MAKR,UAAW,CAEX,EAAoB,EAAI,SAAS,EAAS,EAAY,CACrD,OAAQ,KAAO,GACd,AAAG,EAAoB,EAAE,EAAY,IAAQ,CAAC,EAAoB,EAAE,EAAS,IAC5E,OAAO,eAAe,EAAS,EAAK,CAAE,WAAY,GAAM,IAAK,EAAW,SAO3E,UAAW,CACX,EAAoB,EAAI,SAAS,EAAK,EAAM,CAAE,MAAO,QAAO,UAAU,eAAe,KAAK,EAAK,OAOzF,EAAoB,QAEpC,YCx7BD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAeA,GAAI,IAAkB,UAOtB,GAAO,QAAU,GAUjB,YAAoB,EAAQ,CAC1B,GAAI,GAAM,GAAK,EACX,EAAQ,GAAgB,KAAK,GAEjC,GAAI,CAAC,EACH,MAAO,GAGT,GAAI,GACA,EAAO,GACP,EAAQ,EACR,EAAY,EAEhB,IAAK,EAAQ,EAAM,MAAO,EAAQ,EAAI,OAAQ,IAAS,CACrD,OAAQ,EAAI,WAAW,QAChB,IACH,EAAS,SACT,UACG,IACH,EAAS,QACT,UACG,IACH,EAAS,QACT,UACG,IACH,EAAS,OACT,UACG,IACH,EAAS,OACT,cAEA,SAGJ,AAAI,IAAc,GAChB,IAAQ,EAAI,UAAU,EAAW,IAGnC,EAAY,EAAQ,EACpB,GAAQ,EAGV,MAAO,KAAc,EACjB,EAAO,EAAI,UAAU,EAAW,GAChC,KCtDN,OAAO,SCtBP,OAAkB,WACZ,CACF,YACA,YACA,UACA,cACA,WACA,cACA,aACA,eACA,gBACA,mBACA,YACA,SACA,YACA,kBACA,gBACA,WACA,oBACA,oBACA,iBACA,wBACA,gBACA,mBACA,0BACA,2BACA,WCtBE,WAAqB,EAAU,CACnC,MAAO,OAAO,IAAU,WCIpB,YAA8B,EAAgC,CAClE,GAAM,GAAS,SAAC,EAAa,CAC3B,MAAM,KAAK,GACX,EAAS,MAAQ,GAAI,SAAQ,OAGzB,EAAW,EAAW,GAC5B,SAAS,UAAY,OAAO,OAAO,MAAM,WACzC,EAAS,UAAU,YAAc,EAC1B,ECAF,GAAM,IAA+C,GAC1D,SAAC,EAAM,CACL,MAAA,UAA4C,EAA0B,CACpE,EAAO,MACP,KAAK,QAAU,EACR,EAAO,OAAM;EACxB,EAAO,IAAI,SAAC,EAAK,EAAC,CAAK,MAAG,GAAI,EAAC,KAAK,EAAI,aAAc,KAAK;KACnD,GACJ,KAAK,KAAO,sBACZ,KAAK,OAAS,KCtBd,YAAuB,EAA6B,EAAO,CAC/D,GAAI,EAAK,CACP,GAAM,GAAQ,EAAI,QAAQ,GAC1B,GAAK,GAAS,EAAI,OAAO,EAAO,ICSpC,GAAA,IAAA,UAAA,CAyBE,WAAoB,EAA4B,CAA5B,KAAA,gBAAA,EAdb,KAAA,OAAS,GAER,KAAA,WAAmD,KAMnD,KAAA,WAAoD,KAc5D,SAAA,UAAA,YAAA,UAAA,aACM,EAEJ,GAAI,CAAC,KAAK,OAAQ,CAChB,KAAK,OAAS,GAGN,GAAA,GAAe,KAAI,WAC3B,GAAI,EAEF,GADA,KAAK,WAAa,KACd,MAAM,QAAQ,OAChB,OAAqB,GAAA,GAAA,GAAU,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAA5B,GAAM,GAAM,EAAA,MACf,EAAO,OAAO,4GAGhB,GAAW,OAAO,MAId,GAAA,GAAoB,KAAI,gBAChC,GAAI,EAAW,GACb,GAAI,CACF,UACO,EAAP,CACA,EAAS,YAAa,IAAsB,EAAE,OAAS,CAAC,GAIpD,GAAA,GAAe,KAAI,WAC3B,GAAI,EAAY,CACd,KAAK,WAAa,SAClB,OAAuB,GAAA,GAAA,GAAU,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAA9B,GAAM,GAAQ,EAAA,MACjB,GAAI,CACF,GAAa,SACN,EAAP,CACA,EAAS,GAAM,KAAN,EAAU,GACnB,AAAI,YAAe,IACjB,EAAM,EAAA,EAAA,GAAA,EAAO,IAAM,EAAK,EAAI,SAE5B,EAAO,KAAK,uGAMpB,GAAI,EACF,KAAM,IAAI,IAAoB,KAuBpC,EAAA,UAAA,IAAA,SAAI,EAAuB,OAGzB,GAAI,GAAY,IAAa,KAC3B,GAAI,KAAK,OAGP,GAAa,OACR,CACL,GAAI,YAAoB,GAAc,CAGpC,GAAI,EAAS,QAAU,EAAS,WAAW,MACzC,OAEF,EAAS,WAAW,MAEtB,AAAC,MAAK,WAAa,GAAA,KAAK,cAAU,MAAA,IAAA,OAAA,EAAI,IAAI,KAAK,KAU7C,EAAA,UAAA,WAAR,SAAmB,EAAoB,CAC7B,GAAA,GAAe,KAAI,WAC3B,MAAO,KAAe,GAAW,MAAM,QAAQ,IAAe,EAAW,SAAS,IAU5E,EAAA,UAAA,WAAR,SAAmB,EAAoB,CAC7B,GAAA,GAAe,KAAI,WAC3B,KAAK,WAAa,MAAM,QAAQ,GAAe,GAAW,KAAK,GAAS,GAAc,EAAa,CAAC,EAAY,GAAU,GAOpH,EAAA,UAAA,cAAR,SAAsB,EAAoB,CAChC,GAAA,GAAe,KAAI,WAC3B,AAAI,IAAe,EACjB,KAAK,WAAa,KACT,MAAM,QAAQ,IACvB,GAAU,EAAY,IAkB1B,EAAA,UAAA,OAAA,SAAO,EAAsC,CACnC,GAAA,GAAe,KAAI,WAC3B,GAAc,GAAU,EAAY,GAEhC,YAAoB,IACtB,EAAS,cAAc,OAhLb,EAAA,MAAS,UAAA,CACrB,GAAM,GAAQ,GAAI,GAClB,SAAM,OAAS,GACR,KAgLX,KAEO,GAAM,IAAqB,GAAa,MAEzC,YAAyB,EAAU,CACvC,MACE,aAAiB,KAChB,GAAS,UAAY,IAAS,EAAW,EAAM,SAAW,EAAW,EAAM,MAAQ,EAAW,EAAM,aAIzG,YAAsB,EAAuC,CAC3D,AAAI,EAAW,GACb,IAEA,EAAS,cC9MN,GAAM,IAAuB,CAClC,iBAAkB,KAClB,sBAAuB,KACvB,QAAS,OACT,sCAAuC,GACvC,yBAA0B,ICErB,GAAM,IAAmC,CAG9C,WAAU,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACD,GAAA,GAAa,GAAe,SACpC,MAAQ,KAAQ,KAAA,OAAR,EAAU,aAAc,YAAW,MAAA,OAAA,EAAA,GAAA,EAAI,MAEjD,aAAY,SAAC,EAAM,CACT,GAAA,GAAa,GAAe,SACpC,MAAQ,KAAQ,KAAA,OAAR,EAAU,eAAgB,cAAc,IAElD,SAAU,QCbN,YAA+B,EAAQ,CAC3C,GAAgB,WAAW,UAAA,CACjB,GAAA,GAAqB,GAAM,iBACnC,GAAI,EAEF,EAAiB,OAGjB,MAAM,KCnBN,aAAc,ECMb,GAAM,IAAyB,UAAA,CAAM,MAAA,IAAmB,IAAK,OAAW,WAOzE,YAA4B,EAAU,CAC1C,MAAO,IAAmB,IAAK,OAAW,GAQtC,YAA8B,EAAQ,CAC1C,MAAO,IAAmB,IAAK,EAAO,QASlC,YAA6B,EAAuB,EAAY,EAAU,CAC9E,MAAO,CACL,KAAI,EACJ,MAAK,EACL,MAAK,GCnCT,GAAI,IAAuD,KASrD,YAAuB,EAAc,CACzC,GAAI,GAAO,sCAAuC,CAChD,GAAM,GAAS,CAAC,GAKhB,GAJI,GACF,IAAU,CAAE,YAAa,GAAO,MAAO,OAEzC,IACI,EAAQ,CACJ,GAAA,GAAyB,GAAvB,EAAW,EAAA,YAAE,EAAK,EAAA,MAE1B,GADA,GAAU,KACN,EACF,KAAM,QAMV,KAQE,YAAuB,EAAQ,CACnC,AAAI,GAAO,uCAAyC,IAClD,IAAQ,YAAc,GACtB,GAAQ,MAAQ,GCnBpB,GAAA,IAAA,SAAA,EAAA,CAAmC,EAAA,EAAA,GA6BjC,WAAY,EAA6C,CAAzD,GAAA,GACE,EAAA,KAAA,OAAO,KATC,SAAA,UAAqB,GAU7B,AAAI,EACF,GAAK,YAAc,EAGf,GAAe,IACjB,EAAY,IAAI,IAGlB,EAAK,YAAc,KAvBhB,SAAA,OAAP,SAAiB,EAAwB,EAA2B,EAAqB,CACvF,MAAO,IAAI,IAAe,EAAM,EAAO,IAiCzC,EAAA,UAAA,KAAA,SAAK,EAAS,CACZ,AAAI,KAAK,UACP,GAA0B,GAAiB,GAAQ,MAEnD,KAAK,MAAM,IAWf,EAAA,UAAA,MAAA,SAAM,EAAS,CACb,AAAI,KAAK,UACP,GAA0B,GAAkB,GAAM,MAElD,MAAK,UAAY,GACjB,KAAK,OAAO,KAUhB,EAAA,UAAA,SAAA,UAAA,CACE,AAAI,KAAK,UACP,GAA0B,GAAuB,MAEjD,MAAK,UAAY,GACjB,KAAK,cAIT,EAAA,UAAA,YAAA,UAAA,CACE,AAAK,KAAK,QACR,MAAK,UAAY,GACjB,EAAA,UAAM,YAAW,KAAA,MACjB,KAAK,YAAc,OAIb,EAAA,UAAA,MAAV,SAAgB,EAAQ,CACtB,KAAK,YAAY,KAAK,IAGd,EAAA,UAAA,OAAV,SAAiB,EAAQ,CACvB,GAAI,CACF,KAAK,YAAY,MAAM,WAEvB,KAAK,gBAIC,EAAA,UAAA,UAAV,UAAA,CACE,GAAI,CACF,KAAK,YAAY,mBAEjB,KAAK,gBAGX,GApHmC,IAsHnC,GAAA,IAAA,SAAA,EAAA,CAAuC,EAAA,EAAA,GACrC,WACE,EACA,EACA,EAA8B,CAHhC,GAAA,GAKE,EAAA,KAAA,OAAO,KAEH,EACJ,GAAI,EAAW,GAGb,EAAO,UACE,EAAgB,CAMzB,AAAG,EAA0B,EAAc,KAAlC,EAAoB,EAAc,MAA3B,EAAa,EAAc,SAC3C,GAAI,GACJ,AAAI,GAAQ,GAAO,yBAIjB,GAAU,OAAO,OAAO,GACxB,EAAQ,YAAc,UAAA,CAAM,MAAA,GAAK,gBAEjC,EAAU,EAEZ,EAAO,GAAI,KAAA,OAAJ,EAAM,KAAK,GAClB,EAAQ,GAAK,KAAA,OAAL,EAAO,KAAK,GACpB,EAAW,GAAQ,KAAA,OAAR,EAAU,KAAK,GAK5B,SAAK,YAAc,CACjB,KAAM,EAAO,GAAqB,EAAM,GAAQ,GAChD,MAAO,GAAqB,GAAK,KAAL,EAAS,GAAqB,GAC1D,SAAU,EAAW,GAAqB,EAAU,GAAQ,MAGlE,MAAA,IA3CuC,IAoDvC,YAA8B,EAA8B,EAA6B,CACvF,MAAO,WAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACN,GAAI,CACF,EAAO,MAAA,OAAA,EAAA,GAAA,EAAI,WACJ,EAAP,CACA,AAAI,GAAO,sCACT,GAAa,GAIb,GAAqB,KAW7B,YAA6B,EAAQ,CACnC,KAAM,GAQR,YAAmC,EAA2C,EAA2B,CAC/F,GAAA,GAA0B,GAAM,sBACxC,GAAyB,GAAgB,WAAW,UAAA,CAAM,MAAA,GAAsB,EAAc,KAQzF,GAAM,IAA6D,CACxE,OAAQ,GACR,KAAM,GACN,MAAO,GACP,SAAU,ICzOL,GAAM,IAA+B,UAAA,CAAM,MAAC,OAAO,SAAW,YAAc,OAAO,YAAe,kBCDnG,YAAsB,EAAI,CAC9B,MAAO,GCsEH,aAAc,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACnB,MAAO,IAAc,GAIjB,YAA8B,EAA+B,CACjE,MAAI,GAAI,SAAW,EACV,GAGL,EAAI,SAAW,EACV,EAAI,GAGN,SAAe,EAAQ,CAC5B,MAAO,GAAI,OAAO,SAAC,EAAW,EAAuB,CAAK,MAAA,GAAG,IAAO,ICnExE,GAAA,GAAA,UAAA,CAkBE,WAAY,EAA6E,CACvF,AAAI,GACF,MAAK,WAAa,GA8BtB,SAAA,UAAA,KAAA,SAAQ,EAAyB,CAC/B,GAAM,GAAa,GAAI,GACvB,SAAW,OAAS,KACpB,EAAW,SAAW,EACf,GA2IT,EAAA,UAAA,UAAA,SACE,EACA,EACA,EAA8B,CAHhC,GAAA,GAAA,KAKQ,EAAa,GAAa,GAAkB,EAAiB,GAAI,IAAe,EAAgB,EAAO,GAE7G,UAAa,UAAA,CACL,GAAA,GAAuB,EAArB,EAAQ,EAAA,SAAE,EAAM,EAAA,OACxB,EAAW,IACT,EAGI,EAAS,KAAK,EAAY,GAC1B,EAIA,EAAK,WAAW,GAGhB,EAAK,cAAc,MAIpB,GAIC,EAAA,UAAA,cAAV,SAAwB,EAAmB,CACzC,GAAI,CACF,MAAO,MAAK,WAAW,SAChB,EAAP,CAIA,EAAK,MAAM,KA+Df,EAAA,UAAA,QAAA,SAAQ,EAA0B,EAAoC,CAAtE,GAAA,GAAA,KACE,SAAc,GAAe,GAEtB,GAAI,GAAkB,SAAC,EAAS,EAAM,CAC3C,GAAM,GAAa,GAAI,IAAkB,CACvC,KAAM,SAAC,EAAK,CACV,GAAI,CACF,EAAK,SACE,EAAP,CACA,EAAO,GACP,EAAW,gBAGf,MAAO,EACP,SAAU,IAEZ,EAAK,UAAU,MAKT,EAAA,UAAA,WAAV,SAAqB,EAA2B,OAC9C,MAAO,GAAA,KAAK,UAAM,MAAA,IAAA,OAAA,OAAA,EAAE,UAAU,IAQhC,EAAA,UAAC,IAAD,UAAA,CACE,MAAO,OA6FT,EAAA,UAAA,KAAA,UAAA,QAAK,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACH,MAAO,IAAc,GAAY,OA8BnC,EAAA,UAAA,UAAA,SAAU,EAAoC,CAA9C,GAAA,GAAA,KACE,SAAc,GAAe,GAEtB,GAAI,GAAY,SAAC,EAAS,EAAM,CACrC,GAAI,GACJ,EAAK,UACH,SAAC,EAAI,CAAK,MAAC,GAAQ,GACnB,SAAC,EAAQ,CAAK,MAAA,GAAO,IACrB,UAAA,CAAM,MAAA,GAAQ,QApab,EAAA,OAAkC,SAAI,EAAwD,CACnG,MAAO,IAAI,GAAc,IAua7B,KASA,YAAwB,EAA+C,OACrE,MAAO,GAAA,GAAW,KAAX,EAAe,GAAO,WAAO,MAAA,IAAA,OAAA,EAAI,QAG1C,YAAuB,EAAU,CAC/B,MAAO,IAAS,EAAW,EAAM,OAAS,EAAW,EAAM,QAAU,EAAW,EAAM,UAGxF,YAAyB,EAAU,CACjC,MAAQ,IAAS,YAAiB,KAAgB,GAAW,IAAU,GAAe,GCxelF,YAAkB,EAAW,CACjC,MAAO,GAAW,GAAM,KAAA,OAAN,EAAQ,MAOtB,WACJ,EAAqF,CAErF,MAAO,UAAC,EAAqB,CAC3B,GAAI,GAAQ,GACV,MAAO,GAAO,KAAK,SAA+B,EAA2B,CAC3E,GAAI,CACF,MAAO,GAAK,EAAc,YACnB,EAAP,CACA,KAAK,MAAM,MAIjB,KAAM,IAAI,WAAU,2CCvBxB,GAAA,GAAA,SAAA,EAAA,CAA2C,EAAA,EAAA,GAazC,WACE,EACA,EACA,EACA,EACQ,EAAuB,CALjC,GAAA,GAmBE,EAAA,KAAA,KAAM,IAAY,KAdV,SAAA,WAAA,EAeR,EAAK,MAAQ,EACT,SAAuC,EAAQ,CAC7C,GAAI,CACF,EAAO,SACA,EAAP,CACA,EAAY,MAAM,KAGtB,EAAA,UAAM,MACV,EAAK,OAAS,EACV,SAAuC,EAAQ,CAC7C,GAAI,CACF,EAAQ,SACD,EAAP,CAEA,EAAY,MAAM,WAGlB,KAAK,gBAGT,EAAA,UAAM,OACV,EAAK,UAAY,EACb,UAAA,CACE,GAAI,CACF,UACO,EAAP,CAEA,EAAY,MAAM,WAGlB,KAAK,gBAGT,EAAA,UAAM,YAGZ,SAAA,UAAA,YAAA,UAAA,OACU,EAAW,KAAI,OACvB,EAAA,UAAM,YAAW,KAAA,MAEjB,CAAC,GAAU,IAAA,KAAK,cAAU,MAAA,IAAA,QAAA,EAAA,KAAf,QAEf,GA5E2C,ICQpC,GAAM,IAAiD,CAG5D,SAAA,SAAS,EAAQ,CACf,GAAI,GAAU,sBACV,EAAkD,qBAC9C,EAAa,GAAsB,SAC3C,AAAI,GACF,GAAU,EAAS,sBACnB,EAAS,EAAS,sBAEpB,GAAM,GAAS,EAAQ,SAAC,EAAS,CAI/B,EAAS,OACT,EAAS,KAEX,MAAO,IAAI,IAAa,UAAA,CAAM,MAAA,IAAM,KAAA,OAAN,EAAS,MAEzC,sBAAqB,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACZ,GAAA,GAAa,GAAsB,SAC3C,MAAQ,KAAQ,KAAA,OAAR,EAAU,wBAAyB,uBAAsB,MAAA,OAAA,EAAA,GAAA,EAAI,MAEvE,qBAAoB,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACX,GAAA,GAAa,GAAsB,SAC3C,MAAQ,KAAQ,KAAA,OAAR,EAAU,uBAAwB,sBAAqB,MAAA,OAAA,EAAA,GAAA,EAAI,MAErE,SAAU,QCrBL,GAAM,IAAuD,GAClE,SAAC,EAAM,CACL,MAAA,WAAoC,CAClC,EAAO,MACP,KAAK,KAAO,0BACZ,KAAK,QAAU,yBCVrB,GAAA,GAAA,SAAA,EAAA,CAAgC,EAAA,EAAA,GAqB9B,YAAA,CAAA,GAAA,GAEE,EAAA,KAAA,OAAO,KAtBT,SAAA,OAAS,GAET,EAAA,UAA2B,GAE3B,EAAA,UAAY,GAEZ,EAAA,SAAW,GAEX,EAAA,YAAmB,OAkBnB,SAAA,UAAA,KAAA,SAAQ,EAAwB,CAC9B,GAAM,GAAU,GAAI,IAAiB,KAAM,MAC3C,SAAQ,SAAW,EACZ,GAIC,EAAA,UAAA,eAAV,UAAA,CACE,GAAI,KAAK,OACP,KAAM,IAAI,KAId,EAAA,UAAA,KAAA,SAAK,EAAQ,CAAb,GAAA,GAAA,KACE,GAAa,UAAA,SAEX,GADA,EAAK,iBACD,CAAC,EAAK,UAAW,CACnB,GAAM,GAAO,EAAK,UAAU,YAC5B,OAAuB,GAAA,GAAA,GAAI,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAxB,GAAM,GAAQ,EAAA,MACjB,EAAS,KAAK,0GAMtB,EAAA,UAAA,MAAA,SAAM,EAAQ,CAAd,GAAA,GAAA,KACE,GAAa,UAAA,CAEX,GADA,EAAK,iBACD,CAAC,EAAK,UAAW,CACnB,EAAK,SAAW,EAAK,UAAY,GACjC,EAAK,YAAc,EAEnB,OADQ,GAAc,EAAI,UACnB,EAAU,QACf,EAAU,QAAS,MAAM,OAMjC,EAAA,UAAA,SAAA,UAAA,CAAA,GAAA,GAAA,KACE,GAAa,UAAA,CAEX,GADA,EAAK,iBACD,CAAC,EAAK,UAAW,CACnB,EAAK,UAAY,GAEjB,OADQ,GAAc,EAAI,UACnB,EAAU,QACf,EAAU,QAAS,eAM3B,EAAA,UAAA,YAAA,UAAA,CACE,KAAK,UAAY,KAAK,OAAS,GAC/B,KAAK,UAAY,MAGnB,OAAA,eAAI,EAAA,UAAA,WAAQ,KAAZ,UAAA,OACE,MAAO,IAAA,KAAK,aAAS,MAAA,IAAA,OAAA,OAAA,EAAE,QAAS,mCAIxB,EAAA,UAAA,cAAV,SAAwB,EAAyB,CAC/C,YAAK,iBACE,EAAA,UAAM,cAAa,KAAA,KAAC,IAInB,EAAA,UAAA,WAAV,SAAqB,EAAyB,CAC5C,YAAK,iBACL,KAAK,wBAAwB,GACtB,KAAK,gBAAgB,IAIpB,EAAA,UAAA,gBAAV,SAA0B,EAA2B,CAC7C,GAAA,GAAqC,KAAnC,EAAQ,EAAA,SAAE,EAAS,EAAA,UAAE,EAAS,EAAA,UACtC,MAAO,IAAY,EACf,GACC,GAAU,KAAK,GAAa,GAAI,IAAa,UAAA,CAAM,MAAA,IAAU,EAAW,OAIrE,EAAA,UAAA,wBAAV,SAAkC,EAA2B,CACrD,GAAA,GAAuC,KAArC,EAAQ,EAAA,SAAE,EAAW,EAAA,YAAE,EAAS,EAAA,UACxC,AAAI,EACF,EAAW,MAAM,GACR,GACT,EAAW,YAUf,EAAA,UAAA,aAAA,UAAA,CACE,GAAM,GAAkB,GAAI,GAC5B,SAAW,OAAS,KACb,GA/GF,EAAA,OAAkC,SAAI,EAA0B,EAAqB,CAC1F,MAAO,IAAI,IAAoB,EAAa,IAgHhD,GAlIgC,GAuIhC,GAAA,IAAA,SAAA,EAAA,CAAyC,EAAA,EAAA,GACvC,WAES,EACP,EAAsB,CAHxB,GAAA,GAKE,EAAA,KAAA,OAAO,KAHA,SAAA,YAAA,EAIP,EAAK,OAAS,IAGhB,SAAA,UAAA,KAAA,SAAK,EAAQ,SACX,AAAA,GAAA,GAAA,KAAK,eAAW,MAAA,IAAA,OAAA,OAAA,EAAE,QAAI,MAAA,IAAA,QAAA,EAAA,KAAA,EAAG,IAG3B,EAAA,UAAA,MAAA,SAAM,EAAQ,SACZ,AAAA,GAAA,GAAA,KAAK,eAAW,MAAA,IAAA,OAAA,OAAA,EAAE,SAAK,MAAA,IAAA,QAAA,EAAA,KAAA,EAAG,IAG5B,EAAA,UAAA,SAAA,UAAA,SACE,AAAA,GAAA,GAAA,KAAK,eAAW,MAAA,IAAA,OAAA,OAAA,EAAE,YAAQ,MAAA,IAAA,QAAA,EAAA,KAAA,IAIlB,EAAA,UAAA,WAAV,SAAqB,EAAyB,SAC5C,MAAO,GAAA,GAAA,KAAK,UAAM,MAAA,IAAA,OAAA,OAAA,EAAE,UAAU,MAAW,MAAA,IAAA,OAAA,EAAI,IAEjD,GA1ByC,GCjJlC,GAAM,IAA+C,CAC1D,IAAG,UAAA,CAGD,MAAQ,IAAsB,UAAY,MAAM,OAElD,SAAU,QCwBZ,GAAA,IAAA,SAAA,EAAA,CAAsC,EAAA,EAAA,GAUpC,WACU,EACA,EACA,EAA6D,CAF7D,AAAA,IAAA,QAAA,GAAA,KACA,IAAA,QAAA,GAAA,KACA,IAAA,QAAA,GAAA,IAHV,GAAA,GAKE,EAAA,KAAA,OAAO,KAJC,SAAA,YAAA,EACA,EAAA,YAAA,EACA,EAAA,mBAAA,EAZF,EAAA,QAA0B,GAC1B,EAAA,oBAAsB,GAc5B,EAAK,oBAAsB,IAAgB,IAC3C,EAAK,YAAc,KAAK,IAAI,EAAG,GAC/B,EAAK,YAAc,KAAK,IAAI,EAAG,KAGjC,SAAA,UAAA,KAAA,SAAK,EAAQ,CACL,GAAA,GAA+E,KAA7E,EAAS,EAAA,UAAE,EAAO,EAAA,QAAE,EAAmB,EAAA,oBAAE,EAAkB,EAAA,mBAAE,EAAW,EAAA,YAChF,AAAK,GACH,GAAQ,KAAK,GACb,CAAC,GAAuB,EAAQ,KAAK,EAAmB,MAAQ,IAElE,KAAK,cACL,EAAA,UAAM,KAAI,KAAA,KAAC,IAIH,EAAA,UAAA,WAAV,SAAqB,EAAyB,CAC5C,KAAK,iBACL,KAAK,cAQL,OANM,GAAe,KAAK,gBAAgB,GAEpC,EAAmC,KAAjC,EAAmB,EAAA,oBAAE,EAAO,EAAA,QAG9B,EAAO,EAAQ,QACZ,EAAI,EAAG,EAAI,EAAK,QAAU,CAAC,EAAW,OAAQ,GAAK,EAAsB,EAAI,EACpF,EAAW,KAAK,EAAK,IAGvB,YAAK,wBAAwB,GAEtB,GAGD,EAAA,UAAA,YAAR,UAAA,CACQ,GAAA,GAAoE,KAAlE,EAAW,EAAA,YAAE,EAAkB,EAAA,mBAAE,EAAO,EAAA,QAAE,EAAmB,EAAA,oBAK/D,EAAsB,GAAsB,EAAI,GAAK,EAK3D,GAJA,EAAc,KAAY,EAAqB,EAAQ,QAAU,EAAQ,OAAO,EAAG,EAAQ,OAAS,GAIhG,CAAC,EAAqB,CAKxB,OAJM,GAAM,EAAmB,MAC3B,EAAO,EAGF,EAAI,EAAG,EAAI,EAAQ,QAAW,EAAQ,IAAiB,EAAK,GAAK,EACxE,EAAO,EAET,GAAQ,EAAQ,OAAO,EAAG,EAAO,KAGvC,GAzEsC,GClBtC,GAAA,IAAA,SAAA,EAAA,CAA+B,EAAA,EAAA,GAC7B,WAAY,EAAsB,EAAmD,OACnF,GAAA,KAAA,OAAO,KAYF,SAAA,UAAA,SAAP,SAAgB,EAAW,EAAiB,CAAjB,MAAA,KAAA,QAAA,GAAA,GAClB,MAEX,GAjB+B,ICJxB,GAAM,IAAqC,CAGhD,YAAW,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACF,GAAA,GAAa,GAAgB,SACrC,MAAQ,KAAQ,KAAA,OAAR,EAAU,cAAe,aAAY,MAAA,OAAA,EAAA,GAAA,EAAI,MAEnD,cAAa,SAAC,EAAM,CACV,GAAA,GAAa,GAAgB,SACrC,MAAQ,KAAQ,KAAA,OAAR,EAAU,gBAAiB,eAAe,IAEpD,SAAU,QClBZ,GAAA,IAAA,SAAA,EAAA,CAAoC,EAAA,EAAA,GAOlC,WAAsB,EAAqC,EAAmD,CAA9G,GAAA,GACE,EAAA,KAAA,KAAM,EAAW,IAAK,KADF,SAAA,UAAA,EAAqC,EAAA,KAAA,EAFjD,EAAA,QAAmB,KAMtB,SAAA,UAAA,SAAP,SAAgB,EAAW,EAAiB,CAC1C,GADyB,IAAA,QAAA,GAAA,GACrB,KAAK,OACP,MAAO,MAIT,KAAK,MAAQ,EAEb,GAAM,GAAK,KAAK,GACV,EAAY,KAAK,UAuBvB,MAAI,IAAM,MACR,MAAK,GAAK,KAAK,eAAe,EAAW,EAAI,IAK/C,KAAK,QAAU,GAEf,KAAK,MAAQ,EAEb,KAAK,GAAK,KAAK,IAAM,KAAK,eAAe,EAAW,KAAK,GAAI,GAEtD,MAGC,EAAA,UAAA,eAAV,SAAyB,EAA2B,EAAW,EAAiB,CAAjB,MAAA,KAAA,QAAA,GAAA,GACtD,GAAiB,YAAY,EAAU,MAAM,KAAK,EAAW,MAAO,IAGnE,EAAA,UAAA,eAAV,SAAyB,EAA4B,EAAS,EAAwB,CAEpF,GAF4D,IAAA,QAAA,GAAA,GAExD,GAAS,MAAQ,KAAK,QAAU,GAAS,KAAK,UAAY,GAC5D,MAAO,GAIT,GAAiB,cAAc,IAQ1B,EAAA,UAAA,QAAP,SAAe,EAAU,EAAa,CACpC,GAAI,KAAK,OACP,MAAO,IAAI,OAAM,gCAGnB,KAAK,QAAU,GACf,GAAM,GAAQ,KAAK,SAAS,EAAO,GACnC,GAAI,EACF,MAAO,GACF,AAAI,KAAK,UAAY,IAAS,KAAK,IAAM,MAc9C,MAAK,GAAK,KAAK,eAAe,KAAK,UAAW,KAAK,GAAI,QAIjD,EAAA,UAAA,SAAV,SAAmB,EAAU,EAAc,CACzC,GAAI,GAAmB,GACnB,EACJ,GAAI,CACF,KAAK,KAAK,SACH,EAAP,CACA,EAAU,GAIV,EAAa,GAAQ,GAAI,OAAM,sCAEjC,GAAI,EACF,YAAK,cACE,GAIX,EAAA,UAAA,YAAA,UAAA,CACE,GAAI,CAAC,KAAK,OAAQ,CACV,GAAA,GAAoB,KAAlB,EAAE,EAAA,GAAE,EAAS,EAAA,UACb,EAAY,EAAS,QAE7B,KAAK,KAAO,KAAK,MAAQ,KAAK,UAAY,KAC1C,KAAK,QAAU,GAEf,GAAU,EAAS,MACf,GAAM,MACR,MAAK,GAAK,KAAK,eAAe,EAAW,EAAI,OAG/C,KAAK,MAAQ,KACb,EAAA,UAAM,YAAW,KAAA,QAGvB,GA3IoC,ICiBpC,GAAA,IAAA,UAAA,CAGE,WAAoB,EAAoC,EAAiC,CAAjC,AAAA,IAAA,QAAA,GAAoB,EAAU,KAAlE,KAAA,oBAAA,EAClB,KAAK,IAAM,EA8BN,SAAA,UAAA,SAAP,SAAmB,EAAqD,EAAmB,EAAS,CAA5B,MAAA,KAAA,QAAA,GAAA,GAC/D,GAAI,MAAK,oBAAuB,KAAM,GAAM,SAAS,EAAO,IAlCvD,EAAA,IAAoB,GAAsB,IAoC1D,KCzDA,GAAA,IAAA,SAAA,EAAA,CAAoC,EAAA,EAAA,GAkBlC,WAAY,EAAgC,EAAiC,CAAjC,AAAA,IAAA,QAAA,GAAoB,GAAU,KAA1E,GAAA,GACE,EAAA,KAAA,KAAM,EAAiB,IAAI,KAlBtB,SAAA,QAAmC,GAOnC,EAAA,QAAmB,GAQnB,EAAA,WAAkB,SAMlB,SAAA,UAAA,MAAP,SAAa,EAAwB,CAC3B,GAAA,GAAY,KAAI,QAExB,GAAI,KAAK,QAAS,CAChB,EAAQ,KAAK,GACb,OAGF,GAAI,GACJ,KAAK,QAAU,GAEf,EACE,IAAK,EAAQ,EAAO,QAAQ,EAAO,MAAO,EAAO,OAC/C,YAEM,EAAS,EAAQ,SAI3B,GAFA,KAAK,QAAU,GAEX,EAAO,CACT,KAAQ,EAAS,EAAQ,SACvB,EAAO,cAET,KAAM,KAGZ,GAhDoC,IC8C7B,GAAM,IAAiB,GAAI,IAAe,IAKpC,GAAQ,GClDrB,GAAA,IAAA,SAAA,EAAA,CAA6C,EAAA,EAAA,GAC3C,WAAsB,EAA8C,EAAmD,CAAvH,GAAA,GACE,EAAA,KAAA,KAAM,EAAW,IAAK,KADF,SAAA,UAAA,EAA8C,EAAA,KAAA,IAI1D,SAAA,UAAA,eAAV,SAAyB,EAAoC,EAAU,EAAiB,CAEtF,MAFqE,KAAA,QAAA,GAAA,GAEjE,IAAU,MAAQ,EAAQ,EACrB,EAAA,UAAM,eAAc,KAAA,KAAC,EAAW,EAAI,GAG7C,GAAU,QAAQ,KAAK,MAIhB,EAAU,YAAe,GAAU,WAAa,GAAuB,sBAAsB,UAAA,CAAM,MAAA,GAAU,MAAM,aAElH,EAAA,UAAA,eAAV,SAAyB,EAAoC,EAAU,EAAiB,CAItF,GAJqE,IAAA,QAAA,GAAA,GAIhE,GAAS,MAAQ,EAAQ,GAAO,GAAS,MAAQ,KAAK,MAAQ,EACjE,MAAO,GAAA,UAAM,eAAc,KAAA,KAAC,EAAW,EAAI,GAK7C,AAAK,EAAU,QAAQ,KAAK,SAAC,EAAM,CAAK,MAAA,GAAO,KAAO,KACpD,IAAuB,qBAAqB,GAC5C,EAAU,WAAa,SAK7B,GAlC6C,ICF7C,GAAA,IAAA,SAAA,EAAA,CAA6C,EAAA,EAAA,GAA7C,YAAA,gDACS,SAAA,UAAA,MAAP,SAAa,EAAyB,CACpC,KAAK,QAAU,GAUf,GAAM,GAAU,KAAK,WACrB,KAAK,WAAa,OAEV,GAAA,GAAY,KAAI,QACpB,EACJ,EAAS,GAAU,EAAQ,QAE3B,EACE,IAAK,EAAQ,EAAO,QAAQ,EAAO,MAAO,EAAO,OAC/C,YAEM,GAAS,EAAQ,KAAO,EAAO,KAAO,GAAW,EAAQ,SAInE,GAFA,KAAK,QAAU,GAEX,EAAO,CACT,KAAQ,GAAS,EAAQ,KAAO,EAAO,KAAO,GAAW,EAAQ,SAC/D,EAAO,cAET,KAAM,KAGZ,GAlC6C,ICgCtC,GAAM,IAA0B,GAAI,IAAwB,ICR5D,GAAM,GAAQ,GAAI,GAAkB,SAAC,EAAU,CAAK,MAAA,GAAW,aCxBhE,YAAsB,EAAU,CACpC,MAAO,IAAS,EAAW,EAAM,UCAnC,YAAiB,EAAQ,CACvB,MAAO,GAAI,EAAI,OAAS,GAGpB,YAA4B,EAAW,CAC3C,MAAO,GAAW,GAAK,IAAS,EAAK,MAAQ,OAGzC,YAAuB,EAAW,CACtC,MAAO,IAAY,GAAK,IAAS,EAAK,MAAQ,OAG1C,YAAoB,EAAa,EAAoB,CACzD,MAAO,OAAO,IAAK,IAAU,SAAW,EAAK,MAAS,ECjBjD,GAAM,IAAe,SAAI,EAAM,CAAwB,MAAA,IAAK,MAAO,GAAE,QAAW,UAAY,MAAO,IAAM,YCM1G,YAAoB,EAAU,CAClC,MAAO,GAAW,GAAK,KAAA,OAAL,EAAO,MCFrB,YAA8B,EAAU,CAC5C,MAAO,GAAW,EAAM,KCJpB,YAA6B,EAAQ,CACzC,MAAO,QAAO,eAAiB,EAAW,GAAG,KAAA,OAAH,EAAM,OAAO,gBCCnD,YAA2C,EAAU,CAEzD,MAAO,IAAI,WACT,gBACE,KAAU,MAAQ,MAAO,IAAU,SAAW,oBAAsB,IAAI,EAAK,KAAG,4HCRhF,aAA2B,CAC/B,MAAI,OAAO,SAAW,YAAc,CAAC,OAAO,SACnC,aAGF,OAAO,SAGT,GAAM,IAAW,KCJlB,YAAqB,EAAU,CACnC,MAAO,GAAW,GAAK,KAAA,OAAL,EAAQ,KCFtB,YAAuD,EAAqC,mGAC1F,EAAS,EAAe,qEAGF,MAAA,CAAA,EAAA,GAAM,EAAO,sBAA/B,GAAkB,EAAA,OAAhB,EAAK,EAAA,MAAE,EAAI,EAAA,KACf,iBAAA,CAAA,EAAA,UACF,MAAA,CAAA,EAAA,EAAA,2BAEI,WAAN,MAAA,CAAA,EAAA,EAAA,eAAA,SAAA,wCAGF,SAAO,yCAIL,YAAkC,EAAQ,CAG9C,MAAO,GAAW,GAAG,KAAA,OAAH,EAAK,WCPnB,WAAuB,EAAyB,CACpD,GAAI,YAAiB,GACnB,MAAO,GAET,GAAI,GAAS,KAAM,CACjB,GAAI,GAAoB,GACtB,MAAO,IAAsB,GAE/B,GAAI,GAAY,GACd,MAAO,IAAc,GAEvB,GAAI,GAAU,GACZ,MAAO,IAAY,GAErB,GAAI,GAAgB,GAClB,MAAO,IAAkB,GAE3B,GAAI,GAAW,GACb,MAAO,IAAa,GAEtB,GAAI,GAAqB,GACvB,MAAO,IAAuB,GAIlC,KAAM,IAAiC,GAOnC,YAAmC,EAAQ,CAC/C,MAAO,IAAI,GAAW,SAAC,EAAyB,CAC9C,GAAM,GAAM,EAAI,MAChB,GAAI,EAAW,EAAI,WACjB,MAAO,GAAI,UAAU,GAGvB,KAAM,IAAI,WAAU,oEAWlB,YAA2B,EAAmB,CAClD,MAAO,IAAI,GAAW,SAAC,EAAyB,CAU9C,OAAS,GAAI,EAAG,EAAI,EAAM,QAAU,CAAC,EAAW,OAAQ,IACtD,EAAW,KAAK,EAAM,IAExB,EAAW,aAIT,YAAyB,EAAuB,CACpD,MAAO,IAAI,GAAW,SAAC,EAAyB,CAC9C,EACG,KACC,SAAC,EAAK,CACJ,AAAK,EAAW,QACd,GAAW,KAAK,GAChB,EAAW,aAGf,SAAC,EAAQ,CAAK,MAAA,GAAW,MAAM,KAEhC,KAAK,KAAM,MAIZ,YAA0B,EAAqB,CACnD,MAAO,IAAI,GAAW,SAAC,EAAyB,aAC9C,OAAoB,GAAA,GAAA,GAAQ,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAzB,GAAM,GAAK,EAAA,MAEd,GADA,EAAW,KAAK,GACZ,EAAW,OACb,yGAGJ,EAAW,aAIT,YAA+B,EAA+B,CAClE,MAAO,IAAI,GAAW,SAAC,EAAyB,CAC9C,GAAQ,EAAe,GAAY,MAAM,SAAC,EAAG,CAAK,MAAA,GAAW,MAAM,OAIjE,YAAoC,EAAqC,CAC7E,MAAO,IAAkB,GAAmC,IAG9D,YAA0B,EAAiC,EAAyB,uIACxD,EAAA,GAAA,iFAIxB,GAJe,EAAK,EAAA,MACpB,EAAW,KAAK,GAGZ,EAAW,OACb,MAAA,CAAA,8RAGJ,SAAW,oBC/GP,YACJ,EACA,EACA,EACA,EACA,EAAc,CADd,AAAA,IAAA,QAAA,GAAA,GACA,IAAA,QAAA,GAAA,IAEA,GAAM,GAAuB,EAAU,SAAS,UAAA,CAC9C,IACA,AAAI,EACF,EAAmB,IAAI,KAAK,SAAS,KAAM,IAE3C,KAAK,eAEN,GAIH,GAFA,EAAmB,IAAI,GAEnB,CAAC,EAKH,MAAO,GCmBL,YAAuB,EAA0B,EAAS,CAAT,MAAA,KAAA,QAAA,GAAA,GAC9C,EAAQ,SAAC,EAAQ,EAAU,CAChC,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CAAK,MAAA,IAAgB,EAAY,EAAW,UAAA,CAAM,MAAA,GAAW,KAAK,IAAQ,IAChF,UAAA,CAAM,MAAA,IAAgB,EAAY,EAAW,UAAA,CAAM,MAAA,GAAW,YAAY,IAC1E,SAAC,EAAG,CAAK,MAAA,IAAgB,EAAY,EAAW,UAAA,CAAM,MAAA,GAAW,MAAM,IAAM,QCJ/E,YAAyB,EAA0B,EAAiB,CAAjB,MAAA,KAAA,QAAA,GAAA,GAChD,EAAQ,SAAC,EAAQ,EAAU,CAChC,EAAW,IAAI,EAAU,SAAS,UAAA,CAAM,MAAA,GAAO,UAAU,IAAa,MC5DpE,YAAgC,EAA6B,EAAwB,CACzF,MAAO,GAAU,GAAO,KAAK,GAAY,GAAY,GAAU,ICD3D,YAA6B,EAAuB,EAAwB,CAChF,MAAO,GAAU,GAAO,KAAK,GAAY,GAAY,GAAU,ICH3D,YAA2B,EAAqB,EAAwB,CAC5E,MAAO,IAAI,GAAc,SAAC,EAAU,CAElC,GAAI,GAAI,EAER,MAAO,GAAU,SAAS,UAAA,CACxB,AAAI,IAAM,EAAM,OAGd,EAAW,WAIX,GAAW,KAAK,EAAM,MAIjB,EAAW,QACd,KAAK,gBCVT,YAA8B,EAAoB,EAAwB,CAC9E,MAAO,IAAI,GAAc,SAAC,EAAU,CAClC,GAAI,GAKJ,UAAgB,EAAY,EAAW,UAAA,CAErC,EAAY,EAAc,MAE1B,GACE,EACA,EACA,UAAA,OACM,EACA,EACJ,GAAI,CAEF,AAAC,EAAkB,EAAS,OAAzB,EAAK,EAAA,MAAE,EAAI,EAAA,WACP,EAAP,CAEA,EAAW,MAAM,GACjB,OAGF,AAAI,EAKF,EAAW,WAGX,EAAW,KAAK,IAGpB,EACA,MAQG,UAAA,CAAM,MAAA,GAAW,GAAQ,KAAA,OAAR,EAAU,SAAW,EAAS,YCrDpD,YAAmC,EAAyB,EAAwB,CACxF,GAAI,CAAC,EACH,KAAM,IAAI,OAAM,2BAElB,MAAO,IAAI,GAAc,SAAC,EAAU,CAClC,GAAgB,EAAY,EAAW,UAAA,CACrC,GAAM,GAAW,EAAM,OAAO,iBAC9B,GACE,EACA,EACA,UAAA,CACE,EAAS,OAAO,KAAK,SAAC,EAAM,CAC1B,AAAI,EAAO,KAGT,EAAW,WAEX,EAAW,KAAK,EAAO,UAI7B,EACA,QCrBF,YAAwC,EAA8B,EAAwB,CAClG,MAAO,IAAsB,GAAmC,GAAQ,GCqBpE,YAAuB,EAA2B,EAAwB,CAC9E,GAAI,GAAS,KAAM,CACjB,GAAI,GAAoB,GACtB,MAAO,IAAmB,EAAO,GAEnC,GAAI,GAAY,GACd,MAAO,IAAc,EAAO,GAE9B,GAAI,GAAU,GACZ,MAAO,IAAgB,EAAO,GAEhC,GAAI,GAAgB,GAClB,MAAO,IAAsB,EAAO,GAEtC,GAAI,GAAW,GACb,MAAO,IAAiB,EAAO,GAEjC,GAAI,GAAqB,GACvB,MAAO,IAA2B,EAAO,GAG7C,KAAM,IAAiC,GC0DnC,YAAkB,EAA2B,EAAyB,CAC1E,MAAO,GAAY,GAAU,EAAO,GAAa,EAAU,GC5BvD,YAAY,QAAI,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACpB,GAAM,GAAY,GAAa,GAC/B,MAAO,IAAK,EAAa,GC1ErB,YAAsB,EAAU,CACpC,MAAO,aAAiB,OAAQ,CAAC,MAAM,GCqCnC,WAAoB,EAAyC,EAAa,CAC9E,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAEhC,GAAI,GAAQ,EAGZ,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAQ,CAG1C,EAAW,KAAK,EAAQ,KAAK,EAAS,EAAO,WCpD7C,GAAA,IAAY,MAAK,QAEzB,YAA2B,EAA6B,EAAW,CAC/D,MAAO,IAAQ,GAAQ,EAAE,MAAA,OAAA,EAAA,GAAA,EAAI,KAAQ,EAAG,GAOtC,YAAiC,EAA2B,CAC9D,MAAO,GAAI,SAAA,EAAI,CAAI,MAAA,IAAY,EAAI,KCd/B,GAAA,IAAY,MAAK,QACjB,GAA0D,OAAM,eAArC,GAA+B,OAAM,UAAlB,GAAY,OAAM,KAQlE,YAA+D,EAAuB,CAC1F,GAAI,EAAK,SAAW,EAAG,CACrB,GAAM,GAAQ,EAAK,GACnB,GAAI,GAAQ,GACV,MAAO,CAAE,KAAM,EAAO,KAAM,MAE9B,GAAI,GAAO,GAAQ,CACjB,GAAM,GAAO,GAAQ,GACrB,MAAO,CACL,KAAM,EAAK,IAAI,SAAC,EAAG,CAAK,MAAA,GAAM,KAC9B,KAAI,IAKV,MAAO,CAAE,KAAM,EAAa,KAAM,MAGpC,YAAgB,EAAQ,CACtB,MAAO,IAAO,MAAO,IAAQ,UAAY,GAAe,KAAS,GC5B7D,YAAuB,EAAgB,EAAa,CACxD,MAAO,GAAK,OAAO,SAAC,EAAQ,EAAK,EAAC,CAAK,MAAE,GAAO,GAAO,EAAO,GAAK,GAAS,ICoMxE,YAAuB,QAAoC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAC/D,GAAM,GAAY,GAAa,GACzB,EAAiB,GAAkB,GAEnC,EAA8B,GAAqB,GAA3C,EAAW,EAAA,KAAE,EAAI,EAAA,KAE/B,GAAI,EAAY,SAAW,EAIzB,MAAO,IAAK,GAAI,GAGlB,GAAM,GAAS,GAAI,GACjB,GACE,EACA,EACA,EAEI,SAAC,EAAM,CAAK,MAAA,IAAa,EAAM,IAE/B,KAIR,MAAO,GAAkB,EAAO,KAAK,GAAiB,IAAqC,EAGvF,YACJ,EACA,EACA,EAAiD,CAAjD,MAAA,KAAA,QAAA,GAAA,IAEO,SAAC,EAA2B,CAGjC,GACE,EACA,UAAA,CAaE,OAZQ,GAAW,EAAW,OAExB,EAAS,GAAI,OAAM,GAGrB,EAAS,EAIT,EAAuB,aAGlB,EAAC,CACR,GACE,EACA,UAAA,CACE,GAAM,GAAS,GAAK,EAAY,GAAI,GAChC,EAAgB,GACpB,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CAEJ,EAAO,GAAK,EACP,GAEH,GAAgB,GAChB,KAEG,GAGH,EAAW,KAAK,EAAe,EAAO,WAG1C,UAAA,CACE,AAAK,EAAE,GAGL,EAAW,eAMrB,IAjCK,EAAI,EAAG,EAAI,EAAQ,MAAnB,IAqCX,IASN,YAAuB,EAAsC,EAAqB,EAA0B,CAC1G,AAAI,EACF,GAAgB,EAAc,EAAW,GAEzC,ICtRE,YACJ,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EAA+B,CAG/B,GAAM,GAAc,GAEhB,EAAS,EAET,EAAQ,EAER,EAAa,GAKX,EAAgB,UAAA,CAIpB,AAAI,GAAc,CAAC,EAAO,QAAU,CAAC,GACnC,EAAW,YAKT,EAAY,SAAC,EAAQ,CAAK,MAAC,GAAS,EAAa,EAAW,GAAS,EAAO,KAAK,IAEjF,EAAa,SAAC,EAAQ,CAI1B,GAAU,EAAW,KAAK,GAI1B,IAKA,GAAI,GAAgB,GAGpB,EAAU,EAAQ,EAAO,MAAU,UACjC,GAAI,GACF,EACA,SAAC,EAAU,CAGT,GAAY,MAAZ,EAAe,GAEf,AAAI,EAGF,EAAU,GAGV,EAAW,KAAK,IAGpB,UAAA,CAGE,EAAgB,IAGlB,OACA,UAAA,CAIE,GAAI,EAKF,GAAI,CAIF,IAKA,qBACE,GAAM,GAAgB,EAAO,QAI7B,AAAI,EACF,GAAgB,EAAY,EAAmB,UAAA,CAAM,MAAA,GAAW,KAEhE,EAAW,IARR,EAAO,QAAU,EAAS,OAYjC,UACO,EAAP,CACA,EAAW,MAAM,QAS7B,SAAO,UACL,GAAI,GAAmB,EAAY,EAAW,UAAA,CAE5C,EAAa,GACb,OAMG,UAAA,CACL,GAAkB,MAAlB,KClEE,YACJ,EACA,EACA,EAA6B,CAE7B,MAFA,KAAA,QAAA,GAAA,KAEI,EAAW,GAEN,GAAS,SAAC,EAAG,EAAC,CAAK,MAAA,GAAI,SAAC,EAAQ,EAAU,CAAK,MAAA,GAAe,EAAG,EAAG,EAAG,KAAK,EAAU,EAAQ,EAAG,MAAM,GACrG,OAAO,IAAmB,UACnC,GAAa,GAGR,EAAQ,SAAC,EAAQ,EAAU,CAAK,MAAA,IAAe,EAAQ,EAAY,EAAS,MChC/E,YAAmD,EAA6B,CAA7B,MAAA,KAAA,QAAA,GAAA,KAChD,GAAS,GAAU,GCFtB,aAAmB,CACvB,MAAO,IAAS,GCwDZ,aAAgB,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACrB,MAAO,MAAY,GAAK,EAAM,GAAa,KCnEvC,WAAgD,EAA0B,CAC9E,MAAO,IAAI,GAA+B,SAAC,EAAU,CACnD,EAAU,KAAqB,UAAU,KC5C7C,GAAM,IAA0B,CAAC,cAAe,kBAC1C,GAAqB,CAAC,mBAAoB,uBAC1C,GAAgB,CAAC,KAAM,OA2NvB,WACJ,EACA,EACA,EACA,EAAsC,CAMtC,GAJI,EAAW,IACb,GAAiB,EACjB,EAAU,QAER,EACF,MAAO,GAAa,EAAQ,EAAW,GAAiC,KAAK,GAAiB,IAU1F,GAAA,GAAA,EAEJ,GAAc,GACV,GAAmB,IAAI,SAAC,EAAU,CAAK,MAAA,UAAC,EAAY,CAAK,MAAA,GAAO,GAAY,EAAW,EAAS,MAElG,GAAwB,GACtB,GAAwB,IAAI,GAAwB,EAAQ,IAC5D,GAA0B,GAC1B,GAAc,IAAI,GAAwB,EAAQ,IAClD,GAAE,GATD,EAAG,EAAA,GAAE,EAAM,EAAA,GAgBlB,GAAI,CAAC,GACC,GAAY,GACd,MAAO,IAAS,SAAC,EAAc,CAAK,MAAA,GAAU,EAAW,EAAW,KAClE,EAAU,IAOhB,GAAI,CAAC,EACH,KAAM,IAAI,WAAU,wBAGtB,MAAO,IAAI,GAAc,SAAC,EAAU,CAIlC,GAAM,GAAU,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAAmB,MAAA,GAAW,KAAK,EAAI,EAAK,OAAS,EAAO,EAAK,KAElF,SAAI,GAEG,UAAA,CAAM,MAAA,GAAQ,MAWzB,YAAiC,EAAa,EAAiB,CAC7D,MAAO,UAAC,EAAkB,CAAK,MAAA,UAAC,EAAY,CAAK,MAAA,GAAO,GAAY,EAAW,KAQjF,YAAiC,EAAW,CAC1C,MAAO,GAAW,EAAO,cAAgB,EAAW,EAAO,gBAQ7D,YAAmC,EAAW,CAC5C,MAAO,GAAW,EAAO,KAAO,EAAW,EAAO,KAQpD,YAAuB,EAAW,CAChC,MAAO,GAAW,EAAO,mBAAqB,EAAW,EAAO,qBC1L5D,YACJ,EACA,EACA,EAAsC,CAEtC,MAAI,GACK,GAAoB,EAAY,GAAe,KAAK,GAAiB,IAGvE,GAAI,GAAoB,SAAC,EAAU,CACxC,GAAM,GAAU,UAAA,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAAc,MAAA,GAAW,KAAK,EAAE,SAAW,EAAI,EAAE,GAAK,IACjE,EAAW,EAAW,GAC5B,MAAO,GAAW,GAAiB,UAAA,CAAM,MAAA,GAAc,EAAS,IAAY,SClB1E,YACJ,EACA,EACA,EAAyC,CAFzC,AAAA,IAAA,QAAA,GAAA,GAEA,IAAA,QAAA,GAAA,IAIA,GAAI,GAAmB,GAEvB,MAAI,IAAuB,MAIzB,CAAI,GAAY,GACd,EAAY,EAIZ,EAAmB,GAIhB,GAAI,GAAW,SAAC,EAAU,CAI/B,GAAI,GAAM,GAAY,GAAW,CAAC,EAAU,EAAW,MAAQ,EAE/D,AAAI,EAAM,GAER,GAAM,GAIR,GAAI,GAAI,EAGR,MAAO,GAAU,SAAS,UAAA,CACxB,AAAK,EAAW,QAEd,GAAW,KAAK,KAEhB,AAAI,GAAK,EAGP,KAAK,SAAS,OAAW,GAGzB,EAAW,aAGd,KCpGD,YAAe,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACpB,GAAM,GAAY,GAAa,GACzB,EAAa,GAAU,EAAM,KAC7B,EAAU,EAChB,MAAO,AAAC,GAAQ,OAGZ,EAAQ,SAAW,EAEnB,EAAU,EAAQ,IAElB,GAAS,GAAY,GAAK,EAAS,IALnC,EC3DC,GAAM,IAAQ,GAAI,GAAkB,ICjCnC,GAAA,IAAY,MAAK,QAMnB,YAA4B,EAAiB,CACjD,MAAO,GAAK,SAAW,GAAK,GAAQ,EAAK,IAAM,EAAK,GAAM,ECoDtD,WAAoB,EAAiD,EAAa,CACtF,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAEhC,GAAI,GAAQ,EAIZ,EAAO,UAIL,GAAI,GAAmB,EAAY,SAAC,EAAK,CAAK,MAAA,GAAU,KAAK,EAAS,EAAO,MAAY,EAAW,KAAK,QCpBzG,aAAa,QAAC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAClB,GAAM,GAAiB,GAAkB,GAEnC,EAAU,GAAe,GAE/B,MAAO,GAAQ,OACX,GAAI,GAAsB,SAAC,EAAU,CAGnC,GAAI,GAAuB,EAAQ,IAAI,UAAA,CAAM,MAAA,KAKzC,EAAY,EAAQ,IAAI,UAAA,CAAM,MAAA,KAGlC,EAAW,IAAI,UAAA,CACb,EAAU,EAAY,OAMxB,mBAAS,EAAW,CAClB,EAAU,EAAQ,IAAc,UAC9B,GAAI,GACF,EACA,SAAC,EAAK,CAKJ,GAJA,EAAQ,GAAa,KAAK,GAItB,EAAQ,MAAM,SAAC,EAAM,CAAK,MAAA,GAAO,SAAS,CAC5C,GAAM,GAAc,EAAQ,IAAI,SAAC,EAAM,CAAK,MAAA,GAAO,UAEnD,EAAW,KAAK,EAAiB,EAAc,MAAA,OAAA,EAAA,GAAA,EAAI,KAAU,GAIzD,EAAQ,KAAK,SAAC,EAAQ,EAAC,CAAK,MAAA,CAAC,EAAO,QAAU,EAAU,MAC1D,EAAW,aAIjB,UAAA,CAGE,EAAU,GAAe,GAIzB,CAAC,EAAQ,GAAa,QAAU,EAAW,eA5B1C,EAAc,EAAG,CAAC,EAAW,QAAU,EAAc,EAAQ,OAAQ,MAArE,GAmCT,MAAO,WAAA,CACL,EAAU,EAAY,QAG1B,EC9DA,YAAmB,EAAoD,CAC3E,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAW,GACX,EAAsB,KACtB,EAA6C,KAC7C,EAAa,GAEX,EAAc,UAAA,CAGlB,GAFA,GAAkB,MAAlB,EAAoB,cACpB,EAAqB,KACjB,EAAU,CACZ,EAAW,GACX,GAAM,GAAQ,EACd,EAAY,KACZ,EAAW,KAAK,GAElB,GAAc,EAAW,YAGrB,EAAkB,UAAA,CACtB,EAAqB,KACrB,GAAc,EAAW,YAG3B,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CACJ,EAAW,GACX,EAAY,EACP,GACH,EAAU,EAAiB,IAAQ,UAChC,EAAqB,GAAI,GAAmB,EAAY,EAAa,KAI5E,UAAA,CACE,EAAa,GACZ,EAAC,GAAY,CAAC,GAAsB,EAAmB,SAAW,EAAW,gBCrClF,YAAuB,EAAkB,EAAgC,CAAhC,MAAA,KAAA,QAAA,GAAA,IACtC,GAAM,UAAA,CAAM,MAAA,IAAM,EAAU,KCK/B,YAAyB,EAAoB,EAAsC,CAAtC,MAAA,KAAA,QAAA,GAAA,MAGjD,EAAmB,GAAgB,KAAhB,EAAoB,EAEhC,EAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAiB,GACjB,EAAQ,EAEZ,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,aACA,EAAuB,KAK3B,AAAI,IAAU,IAAsB,GAClC,EAAQ,KAAK,QAIf,OAAqB,GAAA,GAAA,GAAO,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAzB,GAAM,GAAM,EAAA,MACf,EAAO,KAAK,GAMR,GAAc,EAAO,QACvB,GAAS,GAAM,KAAN,EAAU,GACnB,EAAO,KAAK,sGAIhB,GAAI,MAIF,OAAqB,GAAA,GAAA,GAAM,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAxB,GAAM,GAAM,EAAA,MACf,GAAU,EAAS,GACnB,EAAW,KAAK,uGAItB,UAAA,aAGE,OAAqB,GAAA,GAAA,GAAO,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAzB,GAAM,GAAM,EAAA,MACf,EAAW,KAAK,qGAElB,EAAW,YAGb,OACA,UAAA,CAEE,EAAU,UCXd,YACJ,EAAgD,CAEhD,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAgC,KAChC,EAAY,GACZ,EAEJ,EAAW,EAAO,UAChB,GAAI,GAAmB,EAAY,OAAW,OAAW,SAAC,EAAG,CAC3D,EAAgB,EAAU,EAAS,EAAK,GAAW,GAAU,KAC7D,AAAI,EACF,GAAS,cACT,EAAW,KACX,EAAc,UAAU,IAIxB,EAAY,MAKd,GAMF,GAAS,cACT,EAAW,KACX,EAAe,UAAU,MC3HzB,YACJ,EACA,EACA,EACA,EACA,EAAqC,CAErC,MAAO,UAAC,EAAuB,EAA2B,CAIxD,GAAI,GAAW,EAIX,EAAa,EAEb,EAAQ,EAGZ,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CAEJ,GAAM,GAAI,IAEV,EAAQ,EAEJ,EAAY,EAAO,EAAO,GAIxB,GAAW,GAAO,GAGxB,GAAc,EAAW,KAAK,IAIhC,GACG,UAAA,CACC,GAAY,EAAW,KAAK,GAC5B,EAAW,eC9BjB,aAAuB,QAAO,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAClC,GAAM,GAAiB,GAAkB,GACzC,MAAO,GACH,GAAK,GAAa,MAAA,OAAA,EAAA,GAAA,EAAK,KAAuC,GAAiB,IAC/E,EAAQ,SAAC,EAAQ,EAAU,CACzB,GAAiB,EAAA,CAAE,GAAM,EAAK,GAAe,MAAQ,KCavD,aAA2B,QAC/B,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAEA,MAAO,IAAa,MAAA,OAAA,EAAA,GAAA,EAAI,KC+BpB,YACJ,EACA,EAA6G,CAE7G,MAAO,GAAW,GAAkB,GAAS,EAAS,EAAgB,GAAK,GAAS,EAAS,GCnBzF,YAA0B,EAAiB,EAAyC,CAAzC,MAAA,KAAA,QAAA,GAAA,IACxC,EAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAkC,KAClC,EAAsB,KACtB,EAA0B,KAExB,EAAO,UAAA,CACX,GAAI,EAAY,CAEd,EAAW,cACX,EAAa,KACb,GAAM,GAAQ,EACd,EAAY,KACZ,EAAW,KAAK,KAGpB,YAAqB,CAInB,GAAM,GAAa,EAAY,EACzB,EAAM,EAAU,MACtB,GAAI,EAAM,EAAY,CAEpB,EAAa,KAAK,SAAS,OAAW,EAAa,GACnD,EAAW,IAAI,GACf,OAGF,IAGF,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAQ,CACP,EAAY,EACZ,EAAW,EAAU,MAGhB,GACH,GAAa,EAAU,SAAS,EAAc,GAC9C,EAAW,IAAI,KAGnB,UAAA,CAGE,IACA,EAAW,YAGb,OACA,UAAA,CAEE,EAAY,EAAa,UChF7B,YAA+B,EAAe,CAClD,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAW,GACf,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CACJ,EAAW,GACX,EAAW,KAAK,IAElB,UAAA,CACE,AAAK,GACH,EAAW,KAAK,GAElB,EAAW,gBCNf,YAAkB,EAAa,CACnC,MAAO,IAAS,EAEZ,UAAA,CAAM,MAAA,IACN,EAAQ,SAAC,EAAQ,EAAU,CACzB,GAAI,GAAO,EACX,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAK,CAIvC,AAAI,EAAE,GAAQ,GACZ,GAAW,KAAK,GAIZ,GAAS,GACX,EAAW,iBC1BrB,aAAwB,CAC5B,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,EAAO,UAAU,GAAI,GAAmB,EAAY,OCFlD,YAAmB,EAAQ,CAC/B,MAAO,GAAI,UAAA,CAAM,MAAA,KCmCb,YACJ,EACA,EAAmC,CAEnC,MAAI,GAEK,SAAC,EAAqB,CAC3B,MAAA,IAAO,EAAkB,KAAK,GAAK,GAAI,MAAmB,EAAO,KAAK,GAAU,MAG7E,GAAS,SAAC,EAAO,EAAK,CAAK,MAAA,GAAsB,EAAO,GAAO,KAAK,GAAK,GAAI,GAAM,MCvBtF,YAAmB,EAAoB,EAAyC,CAAzC,AAAA,IAAA,QAAA,GAAA,IAC3C,GAAM,GAAW,GAAM,EAAK,GAC5B,MAAO,IAAU,UAAA,CAAM,MAAA,KCoFnB,WACJ,EACA,EAA0D,CAA1D,MAAA,KAAA,QAAA,GAA+B,IAK/B,EAAa,GAAU,KAAV,EAAc,GAEpB,EAAQ,SAAC,EAAQ,EAAU,CAGhC,GAAI,GAEA,EAAQ,GAEZ,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAK,CAEvC,GAAM,GAAa,EAAY,GAK/B,AAAI,IAAS,CAAC,EAAY,EAAa,KAMrC,GAAQ,GACR,EAAc,EAGd,EAAW,KAAK,SAO1B,YAAwB,EAAQ,EAAM,CACpC,MAAO,KAAM,EC/GT,WAAwD,EAAQ,EAAuC,CAC3G,MAAO,GAAqB,SAAC,EAAM,EAAI,CAAK,MAAA,GAAU,EAAQ,EAAE,GAAM,EAAE,IAAQ,EAAE,KAAS,EAAE,KCZzF,aAAiB,QAAI,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACzB,MAAO,UAAC,EAAqB,CAAK,MAAA,IAAO,EAAQ,EAAE,MAAA,OAAA,EAAA,GAAA,EAAI,OCFnD,WAAsB,EAAoB,CAC9C,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAGhC,GAAI,CACF,EAAO,UAAU,WAEjB,EAAW,IAAI,MC3Bf,YAAsB,EAAa,CACvC,MAAO,IAAS,EACZ,UAAA,CAAM,MAAA,IACN,EAAQ,SAAC,EAAQ,EAAU,CAKzB,GAAI,GAAc,GAClB,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CAEJ,EAAO,KAAK,GAGZ,EAAQ,EAAO,QAAU,EAAO,SAElC,UAAA,aAGE,OAAoB,GAAA,GAAA,GAAM,EAAA,EAAA,OAAA,CAAA,EAAA,KAAA,EAAA,EAAA,OAAE,CAAvB,GAAM,GAAK,EAAA,MACd,EAAW,KAAK,qGAElB,EAAW,YAGb,OACA,UAAA,CAEE,EAAS,UCtDjB,aAAe,QAAI,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACvB,GAAM,GAAY,GAAa,GACzB,EAAa,GAAU,EAAM,KACnC,SAAO,GAAe,GAEf,EAAQ,SAAC,EAAQ,EAAU,CAChC,GAAS,GAAY,GAAI,EAAA,CAAE,GAAM,EAAM,IAAgC,IAAY,UAAU,KCgB3F,aAAmB,QACvB,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAEA,MAAO,IAAK,MAAA,OAAA,EAAA,GAAA,EAAI,KCHZ,YAAoB,EAAyB,CACjD,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAW,GACX,EAAsB,KAC1B,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAK,CACvC,EAAW,GACX,EAAY,KAGhB,GAAM,GAAO,UAAA,CACX,GAAI,EAAU,CACZ,EAAW,GACX,GAAM,GAAQ,EACd,EAAY,KACZ,EAAW,KAAK,KAGpB,EAAS,UAAU,GAAI,GAAmB,EAAY,EAAM,OC8B1D,YAAwB,EAA6D,EAAQ,CAMjG,MAAO,GAAQ,GAAc,EAAa,EAAW,UAAU,QAAU,EAAG,KCqCxE,YAAmB,EAA4B,CAA5B,AAAA,IAAA,QAAA,GAAA,IACf,GAAA,GAAgH,EAAO,UAAvH,EAAS,IAAA,OAAG,UAAA,CAAM,MAAA,IAAI,IAAY,EAAE,EAA4E,EAAO,aAAnF,EAAY,IAAA,OAAG,GAAI,EAAE,EAAuD,EAAO,gBAA9D,EAAe,IAAA,OAAG,GAAI,EAAE,EAA+B,EAAO,oBAAtC,EAAmB,IAAA,OAAG,GAAI,EAUnH,MAAO,UAAC,EAAa,CACnB,GAAI,GAAuC,KACvC,EAAuC,KACvC,EAAiC,KACjC,EAAW,EACX,EAAe,GACf,EAAa,GAEX,EAAc,UAAA,CAClB,GAAe,MAAf,EAAiB,cACjB,EAAkB,MAId,EAAQ,UAAA,CACZ,IACA,EAAa,EAAU,KACvB,EAAe,EAAa,IAExB,EAAsB,UAAA,CAG1B,GAAM,GAAO,EACb,IACA,GAAI,MAAJ,EAAM,eAGR,MAAO,GAAc,SAAC,EAAQ,GAAU,CACtC,IACI,CAAC,GAAc,CAAC,GAClB,IAOF,GAAM,IAAQ,EAAU,GAAO,KAAP,EAAW,IAOnC,GAAW,IAAI,UAAA,CACb,IAKI,IAAa,GAAK,CAAC,GAAc,CAAC,GACpC,GAAkB,GAAY,EAAqB,MAMvD,GAAK,UAAU,IAEV,GAMH,GAAa,GAAI,IAAe,CAC9B,KAAM,SAAC,GAAK,CAAK,MAAA,IAAK,KAAK,KAC3B,MAAO,SAAC,GAAG,CACT,EAAa,GACb,IACA,EAAkB,GAAY,EAAO,EAAc,IACnD,GAAK,MAAM,KAEb,SAAU,UAAA,CACR,EAAe,GACf,IACA,EAAkB,GAAY,EAAO,GACrC,GAAK,cAGT,GAAK,GAAQ,UAAU,MAExB,IAIP,YACE,EACA,EAA+C,QAC/C,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,EAAA,GAAA,UAAA,GAEA,MAAI,KAAO,GACT,KAEO,MAGL,IAAO,GACF,KAGF,EAAE,MAAA,OAAA,EAAA,GAAA,EAAI,KACV,KAAK,GAAK,IACV,UAAU,UAAA,CAAM,MAAA,OChIf,WACJ,EACA,EACA,EAAyB,SAErB,EACA,EAAW,GACf,MAAI,IAAsB,MAAO,IAAuB,SACtD,GAAa,GAAA,EAAmB,cAAU,MAAA,IAAA,OAAA,EAAI,IAC9C,EAAa,GAAA,EAAmB,cAAU,MAAA,IAAA,OAAA,EAAI,IAC9C,EAAW,CAAC,CAAC,EAAmB,SAChC,EAAY,EAAmB,WAE/B,EAAa,GAAkB,KAAlB,EAAsB,IAE9B,GAAS,CACd,UAAW,UAAA,CAAM,MAAA,IAAI,IAAc,EAAY,EAAY,IAC3D,aAAc,GACd,gBAAiB,GACjB,oBAAqB,IC1GnB,YAAkB,EAAa,CACnC,MAAO,GAAO,SAAC,EAAG,EAAK,CAAK,MAAA,IAAS,ICUjC,YAAuB,EAAyB,CACpD,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAS,GAEP,EAAiB,GAAI,GACzB,EACA,UAAA,CACE,GAAc,MAAd,EAAgB,cAChB,EAAS,IAEX,IAGF,EAAU,GAAU,UAAU,GAE9B,EAAO,UAAU,GAAI,GAAmB,EAAY,SAAC,EAAK,CAAK,MAAA,IAAU,EAAW,KAAK,QCDvF,YAAmB,QAAO,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GAC9B,GAAM,GAAY,GAAa,GAC/B,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAIhC,AAAC,GAAY,GAAO,EAAQ,EAAQ,GAAa,GAAO,EAAQ,IAAS,UAAU,KCiBjF,WACJ,EACA,EAA6G,CAE7G,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAyD,KACzD,EAAQ,EAER,EAAa,GAIX,EAAgB,UAAA,CAAM,MAAA,IAAc,CAAC,GAAmB,EAAW,YAEzE,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,CAEJ,GAAe,MAAf,EAAiB,cACjB,GAAI,GAAa,EACX,EAAa,IAEnB,EAAU,EAAQ,EAAO,IAAa,UACnC,EAAkB,GAAI,GACrB,EAIA,SAAC,EAAU,CAAK,MAAA,GAAW,KAAK,EAAiB,EAAe,EAAO,EAAY,EAAY,KAAgB,IAC/G,UAAA,CAIE,EAAkB,KAClB,QAKR,UAAA,CACE,EAAa,GACb,SCnEJ,YACJ,EACA,EAA6G,CAE7G,MAAO,GAAW,GAAkB,EAAU,UAAA,CAAM,MAAA,IAAiB,GAAkB,EAAU,UAAA,CAAM,MAAA,KCjBnG,YAAuB,EAA8B,CACzD,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,EAAU,GAAU,UAAU,GAAI,GAAmB,EAAY,UAAA,CAAM,MAAA,GAAW,YAAY,KAC9F,CAAC,EAAW,QAAU,EAAO,UAAU,KCMrC,YAAuB,EAAiD,EAAiB,CAAjB,MAAA,KAAA,QAAA,GAAA,IACrE,EAAQ,SAAC,EAAQ,EAAU,CAChC,GAAI,GAAQ,EACZ,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAK,CACvC,GAAM,GAAS,EAAU,EAAO,KAChC,AAAC,IAAU,IAAc,EAAW,KAAK,GACzC,CAAC,GAAU,EAAW,gBCqDxB,WACJ,EACA,EACA,EAA8B,CAK9B,GAAM,GACJ,EAAW,IAAmB,GAAS,EAElC,CAAE,KAAM,EAA2E,MAAK,EAAE,SAAQ,GACnG,EAEN,MAAO,GACH,EAAQ,SAAC,EAAQ,EAAU,OACzB,AAAA,GAAA,EAAY,aAAS,MAAA,IAAA,QAAA,EAAA,KAArB,GACA,GAAI,GAAU,GACd,EAAO,UACL,GAAI,GACF,EACA,SAAC,EAAK,OACJ,AAAA,GAAA,EAAY,QAAI,MAAA,IAAA,QAAA,EAAA,KAAhB,EAAmB,GACnB,EAAW,KAAK,IAElB,UAAA,OACE,EAAU,GACV,GAAA,EAAY,YAAQ,MAAA,IAAA,QAAA,EAAA,KAApB,GACA,EAAW,YAEb,SAAC,EAAG,OACF,EAAU,GACV,GAAA,EAAY,SAAK,MAAA,IAAA,QAAA,EAAA,KAAjB,EAAoB,GACpB,EAAW,MAAM,IAEnB,UAAA,SACE,AAAI,GACF,IAAA,EAAY,eAAW,MAAA,IAAA,QAAA,EAAA,KAAvB,IAEF,GAAA,EAAY,YAAQ,MAAA,IAAA,QAAA,EAAA,KAApB,QAQR,GCpJC,GAAM,IAAwC,CACnD,QAAS,GACT,SAAU,IA+CN,YACJ,EACA,EAA8C,CAA9C,MAAA,KAAA,QAAA,GAAA,IAEO,EAAQ,SAAC,EAAQ,EAAU,CACxB,GAAA,GAAsB,EAAM,QAAnB,EAAa,EAAM,SAChC,EAAW,GACX,EAAsB,KACtB,EAAiC,KACjC,EAAa,GAEX,EAAgB,UAAA,CACpB,GAAS,MAAT,EAAW,cACX,EAAY,KACR,GACF,KACA,GAAc,EAAW,aAIvB,EAAoB,UAAA,CACxB,EAAY,KACZ,GAAc,EAAW,YAGrB,EAAgB,SAAC,EAAQ,CAC7B,MAAC,GAAY,EAAU,EAAiB,IAAQ,UAAU,GAAI,GAAmB,EAAY,EAAe,KAExG,EAAO,UAAA,CACX,GAAI,EAAU,CAIZ,EAAW,GACX,GAAM,GAAQ,EACd,EAAY,KAEZ,EAAW,KAAK,GAChB,CAAC,GAAc,EAAc,KAIjC,EAAO,UACL,GAAI,GACF,EAMA,SAAC,EAAK,CACJ,EAAW,GACX,EAAY,EACZ,CAAE,IAAa,CAAC,EAAU,SAAY,GAAU,IAAS,EAAc,KAEzE,UAAA,CACE,EAAa,GACb,CAAE,IAAY,GAAY,GAAa,CAAC,EAAU,SAAW,EAAW,gBCpC5E,YACJ,EACA,EACA,EAA8B,CAD9B,AAAA,IAAA,QAAA,GAAA,IACA,IAAA,QAAA,GAAA,IAEA,GAAM,GAAY,GAAM,EAAU,GAClC,MAAO,IAAS,UAAA,CAAM,MAAA,IAAW,GChC7B,aAAwB,QAAO,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACnC,GAAM,GAAU,GAAkB,GAElC,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAehC,OAdM,GAAM,EAAO,OACb,EAAc,GAAI,OAAM,GAI1B,EAAW,EAAO,IAAI,UAAA,CAAM,MAAA,KAG5B,EAAQ,cAMH,EAAC,CACR,EAAU,EAAO,IAAI,UACnB,GAAI,GACF,EACA,SAAC,EAAK,CACJ,EAAY,GAAK,EACb,CAAC,GAAS,CAAC,EAAS,IAEtB,GAAS,GAAK,GAKb,GAAQ,EAAS,MAAM,MAAe,GAAW,QAKtD,MAlBG,EAAI,EAAG,EAAI,EAAK,MAAhB,GAwBT,EAAO,UACL,GAAI,GAAmB,EAAY,SAAC,EAAK,CACvC,GAAI,EAAO,CAET,GAAM,GAAM,EAAA,CAAI,GAAK,EAAK,IAC1B,EAAW,KAAK,EAAU,EAAO,MAAA,OAAA,EAAA,GAAA,EAAI,KAAU,SClFnD,aAAa,QAAO,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACxB,MAAO,GAAQ,SAAC,EAAQ,EAAU,CAChC,GAAS,MAAA,OAAA,EAAA,CAAC,GAA8B,EAAM,KAAyC,UAAU,KCG/F,aAAiB,QAAkC,GAAA,GAAA,EAAA,EAAA,EAAA,UAAA,OAAA,IAAA,EAAA,GAAA,UAAA,GACvD,MAAO,IAAG,MAAA,OAAA,EAAA,GAAA,EAAI,KCaT,aAA4C,CACjD,GAAM,GAAY,GAAI,IAAwB,GAC9C,SAAU,SAAU,mBAAoB,CAAE,KAAM,KAC7C,UAAU,IAAM,EAAU,KAAK,WAG3B,ECFF,WACL,EAAkB,EAAmB,SAChC,CACL,MAAO,OAAM,KAAK,EAAK,iBAAoB,IAwBtC,WACL,EAAkB,EAAmB,SAClC,CACH,GAAM,GAAK,GAAsB,EAAU,GAC3C,GAAI,MAAO,IAAO,YAChB,KAAM,IAAI,gBACR,8BAA8B,oBAIlC,MAAO,GAuBF,YACL,EAAkB,EAAmB,SACtB,CACf,MAAO,GAAK,cAAiB,IAAa,OAQrC,aAAqD,CAC1D,MAAO,UAAS,wBAAyB,cACrC,SAAS,eAAiB,OChEzB,YACL,EACqB,CACrB,MAAO,GACL,EAAU,SAAS,KAAM,WACzB,EAAU,SAAS,KAAM,aAExB,KACC,GAAa,GACb,EAAI,IAAM,CACR,GAAM,GAAS,KACf,MAAO,OAAO,IAAW,YACrB,EAAG,SAAS,GACZ,KAEN,EAAU,IAAO,MACjB,KCdC,YACL,EACe,CACf,MAAO,CACL,EAAG,EAAG,WACN,EAAG,EAAG,WAaH,YACL,EAC2B,CAC3B,MAAO,GACL,EAAU,OAAQ,QAClB,EAAU,OAAQ,WAEjB,KACC,GAAU,EAAG,IACb,EAAI,IAAM,GAAiB,IAC3B,EAAU,GAAiB,KCtC1B,YACL,EACe,CACf,MAAO,CACL,EAAG,EAAG,WACN,EAAG,EAAG,WAaH,YACL,EAC2B,CAC3B,MAAO,GACL,EAAU,EAAI,UACd,EAAU,OAAQ,WAEjB,KACC,GAAU,EAAG,IACb,EAAI,IAAM,GAAwB,IAClC,EAAU,GAAwB,KChBxC,GAAM,IAAS,GAAI,GAYb,GAAY,EAAM,IAAM,EAC5B,GAAI,gBAAe,GAAW,CAC5B,OAAW,KAAS,GAClB,GAAO,KAAK,OAGf,KACC,EAAU,GAAY,EAAM,GAAO,EAAG,IACnC,KACC,EAAS,IAAM,EAAS,gBAG5B,EAAY,IAcT,YACL,EACa,CACb,MAAO,CACL,MAAQ,EAAG,YACX,OAAQ,EAAG,cAyBR,YACL,EACyB,CACzB,MAAO,IACJ,KACC,EAAI,GAAY,EAAS,QAAQ,IACjC,EAAU,GAAY,GACnB,KACC,EAAO,CAAC,CAAE,YAAa,IAAW,GAClC,EAAS,IAAM,EAAS,UAAU,IAClC,EAAI,IAAM,GAAe,MAG7B,EAAU,GAAe,KCvGxB,YACL,EACa,CACb,MAAO,CACL,MAAQ,EAAG,YACX,OAAQ,EAAG,cCWf,GAAM,IAAS,GAAI,GAUb,GAAY,EAAM,IAAM,EAC5B,GAAI,sBAAqB,GAAW,CAClC,OAAW,KAAS,GAClB,GAAO,KAAK,IACb,CACD,UAAW,MAGZ,KACC,EAAU,GAAY,EAAM,GAAO,EAAG,IACnC,KACC,EAAS,IAAM,EAAS,gBAG5B,EAAY,IAyCT,YACL,EAAiB,EAAY,GACR,CACrB,MAAO,IAA0B,GAC9B,KACC,EAAI,CAAC,CAAE,OAAQ,CACb,GAAM,GAAU,GAAe,GACzB,EAAU,GAAsB,GACtC,MAAO,IACL,EAAQ,OAAS,EAAQ,OAAS,IAGtC,KC/EN,GAAM,IAA4C,CAChD,OAAQ,EAAW,2BACnB,OAAQ,EAAW,4BAcd,YAAmB,EAAuB,CAC/C,MAAO,IAAQ,GAAM,QAchB,YAAmB,EAAc,EAAsB,CAC5D,AAAI,GAAQ,GAAM,UAAY,GAC5B,GAAQ,GAAM,QAYX,YAAqB,EAAmC,CAC7D,GAAM,GAAK,GAAQ,GACnB,MAAO,GAAU,EAAI,UAClB,KACC,EAAI,IAAM,EAAG,SACb,EAAU,EAAG,UChCnB,YACE,EAAiB,EACR,CACT,OAAQ,EAAG,iBAGJ,kBAEH,MAAI,GAAG,OAAS,QACP,SAAS,KAAK,GAEd,OAGN,uBACA,qBACH,MAAO,WAIP,MAAO,GAAG,mBAaT,aAA+C,CACpD,MAAO,GAAyB,OAAQ,WACrC,KACC,EAAO,GAAM,CAAE,GAAG,SAAW,EAAG,UAChC,EAAI,GAAO,EACT,KAAM,GAAU,UAAY,SAAW,SACvC,KAAM,EAAG,IACT,OAAQ,CACN,EAAG,iBACH,EAAG,sBAGP,EAAO,CAAC,CAAE,OAAM,UAAW,CACzB,GAAI,IAAS,SAAU,CACrB,GAAM,GAAS,KACf,GAAI,MAAO,IAAW,YACpB,MAAO,CAAC,GAAwB,EAAQ,GAE5C,MAAO,KAET,MClFC,aAA4B,CACjC,MAAO,IAAI,KAAI,SAAS,MAQnB,YAAqB,EAAgB,CAC1C,SAAS,KAAO,EAAI,KAUf,aAAuC,CAC5C,MAAO,IAAI,GCJb,YAAqB,EAAiB,EAA8B,CAGlE,GAAI,MAAO,IAAU,UAAY,MAAO,IAAU,SAChD,EAAG,WAAa,EAAM,mBAGb,YAAiB,MAC1B,EAAG,YAAY,WAGN,MAAM,QAAQ,GACvB,OAAW,KAAQ,GACjB,GAAY,EAAI,GA2Bf,WACL,EAAa,KAAmC,EAC7C,CACH,GAAM,GAAK,SAAS,cAAc,GAGlC,GAAI,EACF,OAAW,KAAQ,QAAO,KAAK,GAC7B,AAAI,MAAO,GAAW,IAAU,UAC9B,EAAG,aAAa,EAAM,EAAW,IAC1B,EAAW,IAClB,EAAG,aAAa,EAAM,IAG5B,OAAW,KAAS,GAClB,GAAY,EAAI,GAGlB,MAAO,GC1EF,YAAkB,EAAe,EAAmB,CACzD,GAAI,GAAI,EACR,GAAI,EAAM,OAAS,EAAG,CACpB,KAAO,EAAM,KAAO,KAAO,EAAE,EAAI,GAAG,CACpC,MAAO,GAAG,EAAM,UAAU,EAAG,QAE/B,MAAO,GAmBF,YAAe,EAAuB,CAC3C,GAAI,EAAQ,IAAK,CACf,GAAM,GAAS,CAAG,IAAQ,KAAO,IAAO,IACxC,MAAO,GAAK,IAAQ,MAAY,KAAM,QAAQ,UAE9C,OAAO,GAAM,WC1BV,aAAmC,CACxC,MAAO,UAAS,KAAK,UAAU,GAa1B,YAAyB,EAAoB,CAClD,GAAM,GAAK,EAAE,IAAK,CAAE,KAAM,IAC1B,EAAG,iBAAiB,QAAS,GAAM,EAAG,mBACtC,EAAG,QAUE,aAAiD,CACtD,MAAO,GAA2B,OAAQ,cACvC,KACC,EAAI,IACJ,EAAU,MACV,EAAO,GAAQ,EAAK,OAAS,GAC7B,EAAY,IASX,aAAwD,CAC7D,MAAO,MACJ,KACC,EAAI,GAAM,GAAmB,QAAQ,QACrC,EAAO,GAAM,MAAO,IAAO,cCxC1B,YAAoB,EAAoC,CAC7D,GAAM,GAAQ,WAAW,GACzB,MAAO,IAA0B,GAC/B,EAAM,YAAY,IAAM,EAAK,EAAM,WAElC,KACC,EAAU,EAAM,UASf,aAA2C,CAChD,GAAM,GAAQ,WAAW,SACzB,MAAO,GACL,EAAU,OAAQ,eAAe,KAAK,GAAM,KAC5C,EAAU,OAAQ,cAAc,KAAK,GAAM,MAE1C,KACC,EAAU,EAAM,UAgBf,YACL,EAA6B,EACd,CACf,MAAO,GACJ,KACC,EAAU,GAAU,EAAS,IAAY,IC5CxC,YACL,EAAmB,EAAuB,CAAE,YAAa,eACnC,CACtB,MAAO,IAAK,MAAM,GAAG,IAAO,IACzB,KACC,EAAO,GAAO,EAAI,SAAW,KAC7B,GAAW,IAAM,IAchB,YACL,EAAmB,EACJ,CACf,MAAO,IAAQ,EAAK,GACjB,KACC,EAAU,GAAO,EAAI,QACrB,EAAY,IAYX,YACL,EAAmB,EACG,CACtB,GAAM,GAAM,GAAI,WAChB,MAAO,IAAQ,EAAK,GACjB,KACC,EAAU,GAAO,EAAI,QACrB,EAAI,GAAO,EAAI,gBAAgB,EAAK,aACpC,EAAY,ICxCX,aAA6C,CAClD,MAAO,CACL,EAAG,KAAK,IAAI,EAAG,SACf,EAAG,KAAK,IAAI,EAAG,UAWZ,aAA2D,CAChE,MAAO,GACL,EAAU,OAAQ,SAAU,CAAE,QAAS,KACvC,EAAU,OAAQ,SAAU,CAAE,QAAS,MAEtC,KACC,EAAI,IACJ,EAAU,OCzBT,aAAyC,CAC9C,MAAO,CACL,MAAQ,WACR,OAAQ,aAWL,aAAuD,CAC5D,MAAO,GAAU,OAAQ,SAAU,CAAE,QAAS,KAC3C,KACC,EAAI,IACJ,EAAU,OCTT,aAA+C,CACpD,MAAO,GAAc,CACnB,KACA,OAEC,KACC,EAAI,CAAC,CAAC,EAAQ,KAAW,EAAE,SAAQ,UACnC,EAAY,ICRX,YACL,EAAiB,CAAE,YAAW,WACR,CACtB,GAAM,GAAQ,EACX,KACC,EAAwB,SAItB,EAAU,EAAc,CAAC,EAAO,IACnC,KACC,EAAI,IAAM,GAAiB,KAI/B,MAAO,GAAc,CAAC,EAAS,EAAW,IACvC,KACC,EAAI,CAAC,CAAC,CAAE,UAAU,CAAE,SAAQ,QAAQ,CAAE,IAAG,QAAU,EACjD,OAAQ,CACN,EAAG,EAAO,EAAI,EACd,EAAG,EAAO,EAAI,EAAI,GAEpB,WCOD,YACL,EAAgB,CAAE,OACH,CAGf,GAAM,GAAM,EAAwB,EAAQ,WACzC,KACC,EAAI,CAAC,CAAE,UAAW,IAItB,MAAO,GACJ,KACC,GAAS,IAAM,EAAK,CAAE,QAAS,GAAM,SAAU,KAC/C,EAAI,GAAW,EAAO,YAAY,IAClC,GAAY,GACZ,MCFN,GAAM,IAAS,EAAW,aACpB,GAAiB,KAAK,MAAM,GAAO,aACzC,GAAO,KAAO,GAAG,GAAI,KAAI,GAAO,KAAM,QAW/B,aAAiC,CACtC,MAAO,IAUF,YAAiB,EAAqB,CAC3C,MAAO,IAAO,SAAS,SAAS,GAW3B,WACL,EAAkB,EACV,CACR,MAAO,OAAO,IAAU,YACpB,GAAO,aAAa,GAAK,QAAQ,IAAK,EAAM,YAC5C,GAAO,aAAa,GC7BnB,YACL,EAAS,EAAmB,SACP,CACrB,MAAO,GAAW,sBAAsB,KAAS,GAa5C,YACL,EAAS,EAAmB,SACL,CACvB,MAAO,GAAY,sBAAsB,KAAS,GC9GpD,OAAwB,SCajB,YAA0B,EAAyB,CACxD,MACE,GAAC,QAAD,CAAO,MAAM,gBAAgB,SAAU,GACrC,EAAC,MAAD,CAAK,MAAM,mCACT,EAAC,MAAD,CAAK,MAAM,kCAEb,EAAC,OAAD,CAAM,MAAM,wBACV,EAAC,OAAD,CAAM,wBAAuB,MCN9B,YAA+B,EAAyB,CAC7D,MACE,GAAC,SAAD,CACE,MAAM,uBACN,MAAO,EAAY,kBACnB,wBAAuB,IAAI,aCajC,YACE,EAA2C,EAC9B,CACb,GAAM,GAAS,EAAO,EAChB,EAAS,EAAO,EAGhB,EAAU,OAAO,KAAK,EAAS,OAClC,OAAO,GAAO,CAAC,EAAS,MAAM,IAC9B,IAAI,GAAO,CAAC,EAAC,MAAD,KAAM,GAAY,MAC9B,OACA,MAAM,EAAG,IAGN,EAAM,GAAI,KAAI,EAAS,UAC7B,MAAI,IAAQ,qBACV,EAAI,aAAa,IAAI,IAAK,OAAO,QAAQ,EAAS,OAC/C,OAAO,CAAC,CAAC,CAAE,KAAW,GACtB,OAAO,CAAC,EAAW,CAAC,KAAW,GAAG,KAAa,IAAQ,OAAQ,KAKlE,EAAC,IAAD,CAAG,KAAM,GAAG,IAAO,MAAM,yBAAyB,SAAU,IAC1D,EAAC,UAAD,CACE,MAAO,CAAC,4BAA6B,GAAG,EACpC,CAAC,uCACD,IACF,KAAK,KACP,gBAAe,EAAS,MAAM,QAAQ,IAErC,EAAS,GAAK,EAAC,MAAD,CAAK,MAAM,mCAC1B,EAAC,KAAD,CAAI,MAAM,2BAA2B,EAAS,OAC7C,EAAS,GAAK,EAAS,KAAK,OAAS,GACpC,EAAC,IAAD,CAAG,MAAM,4BACN,GAAS,EAAS,KAAM,MAG5B,EAAS,GAAK,EAAQ,OAAS,GAC9B,EAAC,IAAD,CAAG,MAAM,2BACN,EAAY,8BAA8B,KAAM,KAmBtD,YACL,EACa,CACb,GAAM,GAAY,EAAO,GAAG,MACtB,EAAO,CAAC,GAAG,GAGX,EAAS,EAAK,UAAU,GAAO,CAAC,EAAI,SAAS,SAAS,MACtD,CAAC,GAAW,EAAK,OAAO,EAAQ,GAGlC,EAAQ,EAAK,UAAU,GAAO,EAAI,MAAQ,GAC9C,AAAI,IAAU,IACZ,GAAQ,EAAK,QAGf,GAAM,GAAO,EAAK,MAAM,EAAG,GACrB,EAAO,EAAK,MAAM,GAGlB,EAAW,CACf,GAAqB,EAAS,EAAc,CAAE,EAAC,GAAU,IAAU,IACnE,GAAG,EAAK,IAAI,GAAW,GAAqB,EAAS,IACrD,GAAG,EAAK,OAAS,CACf,EAAC,UAAD,CAAS,MAAM,0BACb,EAAC,UAAD,CAAS,SAAU,IAChB,EAAK,OAAS,GAAK,EAAK,SAAW,EAChC,EAAY,0BACZ,EAAY,2BAA4B,EAAK,SAG/C,EAAK,IAAI,GAAW,GAAqB,EAAS,MAEtD,IAIN,MACE,GAAC,KAAD,CAAI,MAAM,0BACP,GCpHA,YAA2B,EAAiC,CACjE,MACE,GAAC,KAAD,CAAI,MAAM,oBACP,OAAO,QAAQ,GAAO,IAAI,CAAC,CAAC,EAAK,KAChC,EAAC,KAAD,CAAI,MAAO,oCAAoC,KAC5C,MAAO,IAAU,SAAW,GAAM,GAAS,KCN/C,YAAqB,EAAiC,CAC3D,MACE,GAAC,MAAD,CAAK,MAAM,0BACT,EAAC,MAAD,CAAK,MAAM,qBACR,ICUT,YAAuB,EAA+B,CACpD,GAAM,GAAS,KAGT,EAAM,GAAI,KAAI,MAAM,EAAQ,WAAY,EAAO,MACrD,MACE,GAAC,KAAD,CAAI,MAAM,oBACR,EAAC,IAAD,CAAG,KAAM,EAAI,WAAY,MAAM,oBAC5B,EAAQ,QAkBV,YACL,EAAqB,EACR,CACb,MACE,GAAC,MAAD,CAAK,MAAM,cACT,EAAC,SAAD,CACE,MAAM,sBACN,aAAY,EAAY,yBAEvB,EAAO,OAEV,EAAC,KAAD,CAAI,MAAM,oBACP,EAAS,IAAI,MCdf,YACL,EAAiB,EACO,CACxB,GAAM,GAAU,EAAM,IAAM,EAAc,CACxC,GAAmB,GACnB,GAA0B,MAEzB,KACC,EAAI,CAAC,CAAC,CAAE,IAAG,KAAK,KAAY,CAC1B,GAAM,CAAE,SAAU,GAAe,GACjC,MAAQ,CACN,EAAG,EAAI,EAAO,EAAI,EAAQ,EAC1B,EAAG,EAAI,EAAO,MAMtB,MAAO,IAAkB,GACtB,KACC,EAAU,GAAU,EACjB,KACC,EAAI,GAAW,EAAE,SAAQ,YACzB,GAAK,CAAC,CAAC,GAAU,QAcpB,YACL,EAAiB,EACkB,CACnC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,EAAM,UAAU,CAGd,KAAK,CAAE,UAAU,CACf,EAAG,MAAM,YAAY,iBAAkB,GAAG,EAAO,OACjD,EAAG,MAAM,YAAY,iBAAkB,GAAG,EAAO,QAInD,UAAW,CACT,EAAG,MAAM,eAAe,kBACxB,EAAG,MAAM,eAAe,qBAK5B,EACG,KACC,GAAa,IAAK,IAClB,EAAI,IAAM,EAAU,yBACpB,EAAI,CAAC,CAAE,OAAQ,IAEd,UAAU,CAGT,KAAK,EAAQ,CACX,AAAI,EACF,EAAG,MAAM,YAAY,iBAAkB,GAAG,CAAC,OAE3C,EAAG,MAAM,eAAe,mBAI5B,UAAW,CACT,EAAG,MAAM,eAAe,qBAKhC,GAAM,GAAQ,EAAW,uBAAwB,GAC3C,EAAQ,EAAU,EAAO,YAAa,CAAE,KAAM,KACpD,SACG,KACC,EAAU,CAAC,CAAE,YAAa,EAAS,EAAQ,GAC3C,EAAI,GAAM,EAAG,mBAEZ,UAAU,IAAM,EAAG,QAGjB,GAAgB,EAAI,GACxB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCpGpC,YAA+B,EAAgC,CAC7D,GAAM,GAAkB,GACxB,OAAW,KAAW,GAAY,eAAgB,GAAY,CAC5D,GAAI,GACA,EAAO,EAAQ,WAGnB,KAAQ,EAAQ,YAAY,KAAK,EAAK,cAAgB,CACpD,GAAM,GAAS,EAAK,UAAU,EAAM,OACpC,EAAO,EAAO,UAAU,EAAM,GAAG,QACjC,EAAQ,KAAK,IAGjB,MAAO,GAST,YAAc,EAAqB,EAA2B,CAC5D,EAAO,OAAO,GAAG,MAAM,KAAK,EAAO,aAqB9B,YACL,EAAiB,EAAwB,CAAE,UACR,CAGnC,GAAM,GAAc,GAAI,KACxB,OAAW,KAAU,IAAsB,GAAY,CACrD,GAAM,CAAC,CAAE,GAAM,EAAO,YAAa,MAAM,aACzC,EAAY,IAAI,CAAC,EAAI,GAAiB,CAAC,IACvC,EAAO,YAAY,EAAY,IAAI,CAAC,IAItC,MAAI,GAAY,OAAS,EAChB,EAGF,EAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAGlB,SACG,KACC,GAAU,EAAM,KAAK,GAAS,MAE7B,UAAU,GAAU,CACnB,EAAG,OAAS,CAAC,EAGb,OAAW,CAAC,EAAI,IAAe,GAAa,CAC1C,GAAM,GAAQ,EAAW,cAAe,GAClC,EAAQ,EAAW,gBAAgB,KAAO,GAChD,AAAK,EAGH,GAAK,EAAO,GAFZ,GAAK,EAAO,MAOf,EAAM,GAAG,CAAC,GAAG,GACjB,IAAI,CAAC,CAAC,CAAE,KACP,GAAgB,EAAY,KAG7B,KACC,EAAS,IAAM,EAAM,YACrB,QR9ER,GAAI,IAAW,EAaf,YAA2B,EAA0C,CACnE,GAAI,EAAG,mBAAoB,CACzB,GAAM,GAAU,EAAG,mBACnB,GAAI,EAAQ,UAAY,KACtB,MAAO,GAGJ,GAAI,EAAQ,UAAY,KAAO,CAAC,EAAQ,SAAS,OACpD,MAAO,IAAkB,IAqBxB,YACL,EACuB,CACvB,MAAO,IAAiB,GACrB,KACC,EAAI,CAAC,CAAE,WAEE,EACL,WAAY,AAFE,GAAsB,GAEhB,MAAQ,KAGhC,EAAwB,eAiBvB,YACL,EAAiB,EAC8B,CAC/C,GAAM,CAAE,QAAS,GAAU,WAAW,WACtC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GASlB,GARA,EAAM,UAAU,CAAC,CAAE,gBAAiB,CAClC,AAAI,GAAc,EAChB,EAAG,aAAa,WAAY,KAE5B,EAAG,gBAAgB,cAInB,WAAY,cAAe,CAC7B,GAAM,GAAS,EAAG,QAAQ,OAC1B,EAAO,GAAK,UAAU,EAAE,KACxB,EAAO,aACL,GAAsB,EAAO,IAC7B,GAKJ,GAAM,GAAY,EAAG,QAAQ,CAC3B,mCACA,mBACA,KAAK,OACP,GAAI,YAAqB,aAAa,CACpC,GAAM,GAAO,GAAkB,GAG/B,GAAI,MAAO,IAAS,aAClB,GAAU,UAAU,SAAS,aAC7B,GAAQ,0BACP,CACD,GAAM,GAAe,GAAoB,EAAM,EAAI,GAGnD,MAAO,IAAe,GACnB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,IAC5B,GAAU,GAAiB,GACxB,KACC,GAAU,EAAM,KAAK,GAAS,KAC9B,EAAI,CAAC,CAAE,QAAO,YAAa,GAAS,GACpC,IACA,EAAU,GAAU,EAAS,EAAe,OAQxD,MAAO,IAAe,GACnB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OSpI7B,YACL,EAAwB,CAAE,UAAS,UACd,CACrB,GAAI,GAAO,GACX,MAAO,GAGL,EACG,KACC,EAAI,GAAU,EAAO,QAAQ,wBAC7B,EAAO,GAAW,IAAO,GACzB,GAAe,CAAE,OAAQ,OAAQ,OAAQ,MAI7C,EACG,KACC,EAAO,GAAU,GAAU,CAAC,GAC5B,EAAI,IAAM,EAAO,EAAG,MACpB,EAAI,GAAW,EACb,OAAQ,EAAS,OAAS,aAiB7B,YACL,EAAwB,EACQ,CAChC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAAC,CAAE,SAAQ,YAAa,CACtC,AAAI,IAAW,OACb,EAAG,aAAa,OAAQ,IAExB,EAAG,gBAAgB,QACjB,GACF,EAAG,mBAIA,GAAa,EAAI,GACrB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OC3FpC,GAAM,IAAW,EAAE,SAgBZ,YACL,EACkC,CAClC,SAAG,YAAY,IACf,GAAS,YAAY,GAAY,IAG1B,EAAG,CAAE,IAAK,ICIZ,YACL,EACyB,CACzB,GAAM,GAAS,EAAY,iBAAkB,GAC7C,MAAO,GAAM,GAAG,EAAO,IAAI,GAAS,EAAU,EAAO,UAClD,KACC,GAAmB,CACjB,OAAQ,EAAW,aAAa,EAAM,YAIzC,KACC,EAAU,CACR,OAAQ,EAAW,aAAa,EAAO,GAAG,UAiB3C,YACL,EACoC,CACpC,GAAM,GAAY,EAAW,iBAAkB,GAC/C,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAc,CAAC,EAAO,GAAiB,KACpC,KACC,GAAU,EAAG,IACb,GAAU,EAAM,KAAK,GAAS,MAE7B,UAAU,CAGT,KAAK,CAAC,CAAE,WAAW,CACjB,GAAM,GAAS,GAAiB,GAC1B,CAAE,SAAU,GAAe,GAGjC,EAAG,MAAM,YAAY,mBAAoB,GAAG,EAAO,OACnD,EAAG,MAAM,YAAY,uBAAwB,GAAG,OAGhD,EAAU,SAAS,CACjB,SAAU,SACV,KAAM,EAAO,KAKjB,UAAW,CACT,EAAG,MAAM,eAAe,oBACxB,EAAG,MAAM,eAAe,2BAKzB,GAAiB,GACrB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCrE7B,YACL,EAAiB,CAAE,UAAS,UACI,CAChC,MAAO,GAGL,GAAG,EAAY,aAAc,GAC1B,IAAI,GAAS,GAAe,EAAO,CAAE,YAGxC,GAAG,EAAY,qBAAsB,GAClC,IAAI,GAAS,GAAe,IAG/B,GAAG,EAAY,UAAW,GACvB,IAAI,GAAS,GAAa,EAAO,CAAE,UAAS,YAG/C,GAAG,EAAY,cAAe,GAC3B,IAAI,GAAS,GAAiB,KCZ9B,YACL,EAAkB,CAAE,UACA,CACpB,MAAO,GACJ,KACC,EAAU,GAAW,EACnB,EAAG,IACH,EAAG,IAAO,KAAK,GAAM,OAEpB,KACC,EAAI,GAAW,EAAE,UAAS,eAiB7B,YACL,EAAiB,EACc,CAC/B,GAAM,GAAQ,EAAW,cAAe,GACxC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAAC,CAAE,UAAS,YAAa,CACvC,EAAM,YAAc,EACpB,AAAI,EACF,EAAG,aAAa,gBAAiB,QAEjC,EAAG,gBAAgB,mBAIhB,GAAY,EAAI,GACpB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OC7BpC,YAAkB,CAAE,aAAgD,CAClE,GAAI,CAAC,GAAQ,mBACX,MAAO,GAAG,IAGZ,GAAM,GAAa,EAChB,KACC,EAAI,CAAC,CAAE,OAAQ,CAAE,QAAU,GAC3B,GAAY,EAAG,GACf,EAAI,CAAC,CAAC,EAAG,KAAO,CAAC,EAAI,EAAG,IACxB,EAAwB,IAItB,EAAU,EAAc,CAAC,EAAW,IACvC,KACC,EAAO,CAAC,CAAC,CAAE,UAAU,CAAC,CAAE,MAAQ,KAAK,IAAI,EAAI,EAAO,GAAK,KACzD,EAAI,CAAC,CAAC,CAAE,CAAC,MAAgB,GACzB,KAIE,EAAU,GAAY,UAC5B,MAAO,GAAc,CAAC,EAAW,IAC9B,KACC,EAAI,CAAC,CAAC,CAAE,UAAU,KAAY,EAAO,EAAI,KAAO,CAAC,GACjD,IACA,EAAU,GAAU,EAAS,EAAU,EAAG,KAC1C,EAAU,KAgBT,YACL,EAAiB,EACG,CACpB,MAAO,GAAM,IAAM,CACjB,GAAM,GAAS,iBAAiB,GAChC,MAAO,GACL,EAAO,WAAa,UACpB,EAAO,WAAa,oBAGrB,KACC,GAAkB,GAAiB,GAAK,GAAS,IACjD,EAAI,CAAC,CAAC,EAAQ,CAAE,UAAU,KAAa,EACrC,OAAQ,EAAS,EAAS,EAC1B,SACA,YAEF,EAAqB,CAAC,EAAG,IACvB,EAAE,SAAW,EAAE,QACf,EAAE,SAAW,EAAE,QACf,EAAE,SAAW,EAAE,QAEjB,EAAY,IAeX,YACL,EAAiB,CAAE,UAAS,SACG,CAC/B,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SACG,KACC,EAAwB,UACxB,GAAkB,IAEjB,UAAU,CAAC,CAAC,CAAE,UAAU,CAAE,aAAc,CACvC,AAAI,EACF,EAAG,aAAa,gBAAiB,EAAS,SAAW,UAErD,EAAG,gBAAgB,mBAI3B,EAAM,UAAU,GAGT,EACJ,KACC,GAAU,EAAM,KAAK,GAAS,KAC9B,EAAI,GAAU,GAAE,IAAK,GAAO,OCrH7B,YACL,EAAiB,CAAE,YAAW,WACL,CACzB,MAAO,IAAgB,EAAI,CAAE,YAAW,YACrC,KACC,EAAI,CAAC,CAAE,OAAQ,CAAE,QAAU,CACzB,GAAM,CAAE,UAAW,GAAe,GAClC,MAAO,CACL,OAAQ,GAAK,KAGjB,EAAwB,WAevB,YACL,EAAiB,EACmB,CACpC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,EAAM,UAAU,CAAC,CAAE,YAAa,CAC9B,AAAI,EACF,EAAG,aAAa,gBAAiB,UAEjC,EAAG,gBAAgB,mBAIvB,GAAM,GAAU,GAAmB,cACnC,MAAI,OAAO,IAAY,YACd,EAGF,GAAiB,EAAS,GAC9B,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCvD7B,YACL,EAAiB,CAAE,YAAW,WACZ,CAGlB,GAAM,GAAU,EACb,KACC,EAAI,CAAC,CAAE,YAAa,GACpB,KAIE,EAAU,EACb,KACC,EAAU,IAAM,GAAiB,GAC9B,KACC,EAAI,CAAC,CAAE,YAAc,EACnB,IAAQ,EAAG,UACX,OAAQ,EAAG,UAAY,KAEzB,EAAwB,aAMhC,MAAO,GAAc,CAAC,EAAS,EAAS,IACrC,KACC,EAAI,CAAC,CAAC,EAAQ,CAAE,MAAK,UAAU,CAAE,OAAQ,CAAE,KAAK,KAAM,CAAE,cACtD,GAAS,KAAK,IAAI,EAAG,EACjB,KAAK,IAAI,EAAG,EAAS,EAAI,GACzB,KAAK,IAAI,EAAG,EAAS,EAAI,IAEtB,CACL,OAAQ,EAAM,EACd,SACA,OAAQ,EAAM,GAAU,KAG5B,EAAqB,CAAC,EAAG,IACvB,EAAE,SAAW,EAAE,QACf,EAAE,SAAW,EAAE,QACf,EAAE,SAAW,EAAE,SChDhB,YACL,EACqB,CACrB,GAAM,GAAU,SAAkB,cAAgB,CAChD,MAAO,EAAO,UAAU,GAAS,WAC/B,EAAM,aAAa,wBACnB,UAIJ,MAAO,GAAG,GAAG,GACV,KACC,GAAS,GAAS,EAAU,EAAO,UAChC,KACC,GAAM,KAGV,EAAU,EAAO,KAAK,IAAI,EAAG,EAAQ,SACrC,EAAI,GAAU,EACZ,MAAO,EAAO,QAAQ,GACtB,MAAO,CACL,OAAS,EAAM,aAAa,wBAC5B,QAAS,EAAM,aAAa,yBAC5B,OAAS,EAAM,aAAa,4BAGhC,EAAY,IAWX,YACL,EACgC,CAChC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,EAAM,UAAU,GAAW,CAGzB,OAAW,CAAC,EAAK,IAAU,QAAO,QAAQ,EAAQ,OAChD,AAAI,MAAO,IAAU,UACnB,SAAS,KAAK,aAAa,iBAAiB,IAAO,GAGvD,OAAS,GAAQ,EAAG,EAAQ,EAAO,OAAQ,IAAS,CAClD,GAAM,GAAQ,EAAO,GAAO,mBAC5B,AAAI,YAAiB,cACnB,GAAM,OAAS,EAAQ,QAAU,GAIrC,SAAS,YAAa,KAIxB,GAAM,GAAS,EAA8B,QAAS,GACtD,MAAO,IAAa,GACjB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCrHpC,OAAwB,SAiCxB,YAAiB,EAAyB,CACxC,EAAG,aAAa,kBAAmB,IACnC,GAAM,GAAO,EAAG,UAChB,SAAG,gBAAgB,mBACZ,EAYF,YACL,CAAE,UACI,CACN,AAAI,WAAY,eACd,GAAI,GAA8B,GAAc,CAC9C,GAAI,YAAY,iDAAkD,CAChE,KAAM,GACJ,EAAG,aAAa,wBAChB,GAAQ,EACN,EAAG,aAAa,6BAInB,GAAG,UAAW,GAAM,EAAW,KAAK,MAEtC,KACC,EAAI,GAAM,CAER,AADgB,EAAG,QACX,UAEV,GAAM,EAAY,sBAEjB,UAAU,GCKnB,YAAoB,EAA0B,CAC5C,GAAI,EAAK,OAAS,EAChB,MAAO,GAGT,GAAM,CAAC,EAAM,GAAQ,EAClB,KAAK,CAAC,EAAG,IAAM,EAAE,OAAS,EAAE,QAC5B,IAAI,GAAO,EAAI,QAAQ,SAAU,KAGhC,EAAQ,EACZ,GAAI,IAAS,EACX,EAAQ,EAAK,WAEb,MAAO,EAAK,WAAW,KAAW,EAAK,WAAW,IAChD,IAGJ,GAAM,GAAS,KACf,MAAO,GAAK,IAAI,GACd,EAAI,QAAQ,EAAK,MAAM,EAAG,GAAQ,EAAO,OA6BtC,YACL,CAAE,YAAW,YAAW,aAClB,CACN,GAAM,GAAS,KACf,GAAI,SAAS,WAAa,QACxB,OAGF,AAAI,qBAAuB,UACzB,SAAQ,kBAAoB,SAG5B,EAAU,OAAQ,gBACf,UAAU,IAAM,CACf,QAAQ,kBAAoB,UAKlC,GAAM,GAAU,GAAoC,kBACpD,AAAI,MAAO,IAAY,aACrB,GAAQ,KAAO,EAAQ,MAGzB,GAAM,GAAQ,GAAW,GAAI,KAAI,cAAe,EAAO,OACpD,KACC,EAAI,GAAW,GAAW,EAAY,MAAO,GAC1C,IAAI,GAAQ,EAAK,eAEpB,EAAU,GAAQ,EAAsB,SAAS,KAAM,SACpD,KACC,EAAO,GAAM,CAAC,EAAG,SAAW,CAAC,EAAG,SAChC,EAAU,GAAM,CAGd,GAAI,EAAG,iBAAkB,SAAS,CAChC,GAAM,GAAK,EAAG,OAAO,QAAQ,KAC7B,GAAI,GAAM,CAAC,EAAG,OAAQ,CACpB,GAAM,GAAM,GAAI,KAAI,EAAG,MAOvB,GAJA,EAAI,OAAS,GACb,EAAI,KAAO,GAIT,EAAI,WAAa,SAAS,UAC1B,EAAK,SAAS,EAAI,YAElB,SAAG,iBACI,EAAG,CACR,IAAK,GAAI,KAAI,EAAG,SAKxB,MAAO,QAIb,MAIE,EAAO,EAAyB,OAAQ,YAC3C,KACC,EAAO,GAAM,EAAG,QAAU,MAC1B,EAAI,GAAO,EACT,IAAK,GAAI,KAAI,SAAS,MACtB,OAAQ,EAAG,SAEb,MAIJ,EAAM,EAAO,GACV,KACC,EAAqB,CAAC,EAAG,IAAM,EAAE,IAAI,OAAS,EAAE,IAAI,MACpD,EAAI,CAAC,CAAE,SAAU,IAEhB,UAAU,GAGf,GAAM,GAAY,EACf,KACC,EAAwB,YACxB,EAAU,GAAO,GAAQ,EAAI,MAC1B,KACC,GAAW,IACT,IAAY,GACL,OAIb,MAIJ,EACG,KACC,GAAO,IAEN,UAAU,CAAC,CAAE,SAAU,CACtB,QAAQ,UAAU,GAAI,GAAI,GAAG,OAInC,GAAM,GAAM,GAAI,WAChB,EACG,KACC,EAAU,GAAO,EAAI,QACrB,EAAI,GAAO,EAAI,gBAAgB,EAAK,eAEnC,UAAU,GAGf,EACG,KACC,GAAK,IAEJ,UAAU,GAAe,CACxB,OAAW,KAAY,CAGrB,QACA,sBACA,oBACA,yBAGA,+BACA,gCACA,mCACA,2BACA,2BACA,GAAG,GAAQ,0BACP,CAAC,4BACD,IACH,CACD,GAAM,GAAS,GAAmB,GAC5B,EAAS,GAAmB,EAAU,GAC5C,AACE,MAAO,IAAW,aAClB,MAAO,IAAW,aAElB,EAAO,YAAY,MAM7B,EACG,KACC,GAAK,GACL,EAAI,IAAM,GAAoB,cAC9B,EAAU,GAAM,EAAG,GAAG,EAAY,SAAU,KAC5C,GAAU,GAAM,CACd,GAAM,GAAS,EAAE,UACjB,GAAI,EAAG,IAAK,CACV,OAAW,KAAQ,GAAG,oBACpB,EAAO,aAAa,EAAM,EAAG,aAAa,IAC5C,SAAG,YAAY,GAGR,GAAI,GAAW,GAAY,CAChC,EAAO,OAAS,IAAM,EAAS,iBAKjC,UAAO,YAAc,EAAG,YACxB,EAAG,YAAY,GACR,KAIV,YAGL,EAAM,EAAO,GACV,KACC,GAAO,IAEN,UAAU,CAAC,CAAE,MAAK,YAAa,CAC9B,AAAI,EAAI,MAAQ,CAAC,EACf,GAAgB,EAAI,MAEpB,OAAO,SAAS,EAAG,kBAAQ,IAAK,KAKxC,EACG,KACC,GAAU,GACV,GAAa,KACb,EAAwB,WAEvB,UAAU,CAAC,CAAE,YAAa,CACzB,QAAQ,aAAa,EAAQ,MAInC,EAAM,EAAO,GACV,KACC,GAAY,EAAG,GACf,EAAO,CAAC,CAAC,EAAG,KAAO,EAAE,IAAI,WAAa,EAAE,IAAI,UAC5C,EAAI,CAAC,CAAC,CAAE,KAAW,IAElB,UAAU,CAAC,CAAE,YAAa,CACzB,OAAO,SAAS,EAAG,kBAAQ,IAAK,KC/UxC,OAAuB,SCAvB,OAAuB,SAsChB,YACL,EAA2B,EACD,CAC1B,GAAM,GAAY,GAAI,QAAO,EAAO,UAAW,OACzC,EAAY,CAAC,EAAY,EAAc,IACpC,GAAG,4BAA+B,WAI3C,MAAO,AAAC,IAAkB,CACxB,EAAQ,EACL,QAAQ,gBAAiB,KACzB,OAGH,GAAM,GAAQ,GAAI,QAAO,MAAM,EAAO,cACpC,EACG,QAAQ,uBAAwB,QAChC,QAAQ,EAAW,QACnB,OAGL,MAAO,IACL,GACI,eAAW,GACX,GAED,QAAQ,EAAO,GACf,QAAQ,8BAA+B,OC5BzC,YAA0B,EAAuB,CACtD,MAAO,GACJ,MAAM,cACJ,IAAI,CAAC,EAAO,IAAU,EAAQ,EAC3B,EAAM,QAAQ,+BAAgC,MAC9C,GAEH,KAAK,IACP,QAAQ,kCAAmC,IAC3C,OCqCE,YACL,EAC+B,CAC/B,MAAO,GAAQ,OAAS,EAUnB,YACL,EAC+B,CAC/B,MAAO,GAAQ,OAAS,EAUnB,YACL,EACgC,CAChC,MAAO,GAAQ,OAAS,ECtE1B,YAA0B,CAAE,SAAQ,QAAkC,CAGpE,AAAI,EAAO,KAAK,SAAW,GAAK,EAAO,KAAK,KAAO,MACjD,GAAO,KAAO,CACZ,EAAY,wBAIZ,EAAO,YAAc,aACvB,GAAO,UAAY,EAAY,4BAQjC,GAAM,GAAyB,CAC7B,SANe,EAAY,0BAC1B,MAAM,WACN,OAAO,SAKR,YAAa,GAAQ,mBAIvB,MAAO,CAAE,SAAQ,OAAM,WAmBlB,YACL,EAAa,EACC,CACd,GAAM,GAAS,KACT,EAAS,GAAI,QAAO,GAGpB,EAAM,GAAI,GACV,EAAM,GAAY,EAAQ,CAAE,QAC/B,KACC,EAAI,GAAW,CACb,GAAI,GAAsB,GACxB,OAAW,KAAU,GAAQ,KAAK,MAChC,OAAW,KAAY,GACrB,EAAS,SAAW,GAAG,GAAI,KAAI,EAAS,SAAU,EAAO,QAE/D,MAAO,KAET,MAIJ,UAAK,GACF,KACC,EAAI,GAAS,EACX,KAAM,EACN,KAAM,GAAiB,OAGxB,UAAU,EAAI,KAAK,KAAK,IAGtB,CAAE,MAAK,OClGT,aAAsC,CAC3C,GAAM,GAAS,KACT,EAAY,GAChB,GAAI,KAAI,mBAAoB,EAAO,OAI/B,EAAW,EACd,KACC,EAAI,GAAY,CACd,GAAM,CAAC,CAAE,GAAW,EAAO,KAAK,MAAM,eACtC,MAAO,GAAS,KAAK,CAAC,CAAE,UAAS,aAC/B,IAAY,GAAW,EAAQ,SAAS,KACpC,EAAS,MAKrB,EAAc,CAAC,EAAW,IACvB,UAAU,CAAC,CAAC,EAAU,KAAa,CA7DxC,MAkEM,GAHA,AADc,EAAW,qBACnB,YAAY,GAAsB,EAAU,IAG9C,SAAS,aAAc,kBAAoB,KAAM,CACnD,GAAM,GAAS,MAAO,UAAP,cAAgB,UAAW,SACpC,EAAW,CAAC,EAAQ,QAAQ,SAAS,GAI3C,GADA,SAAS,aAAc,EAAU,gBAC7B,EACF,OAAW,KAAW,IAAqB,YACzC,EAAQ,OAAS,MCWtB,YACL,EAAsB,CAAE,OACC,CACzB,GAAM,GAAK,gCAAU,YAAa,GAG5B,CAAE,gBAAiB,KACzB,AAAI,EAAa,IAAI,MACnB,GAAU,SAAU,IAGtB,GAAM,GAAS,EACZ,KACC,EAAO,IACP,GAAK,GACL,EAAI,IAAM,EAAa,IAAI,MAAQ,KAIvC,EAAO,UAAU,GAAS,CACxB,AAAI,GACF,GAAG,MAAQ,KAIf,GAAM,GAAS,GAAkB,GAC3B,EAAS,EACb,EAAU,EAAI,SACd,EAAU,EAAI,SAAS,KAAK,GAAM,IAClC,GAEC,KACC,EAAI,IAAM,EAAG,EAAG,QAChB,EAAU,IACV,KAIJ,MAAO,GAAc,CAAC,EAAQ,IAC3B,KACC,EAAI,CAAC,CAAC,EAAO,KAAY,EAAE,QAAO,WAClC,EAAY,IAYX,YACL,EAAsB,CAAE,MAAK,OACyB,CACtD,GAAM,GAAQ,GAAI,GAGlB,SACG,KACC,EAAwB,SACxB,EAAI,CAAC,CAAE,WAAiC,EACtC,KAAM,EACN,KAAM,MAGP,UAAU,EAAI,KAAK,KAAK,IAG7B,EACG,KACC,EAAwB,UAEvB,UAAU,CAAC,CAAE,WAAY,CACxB,AAAI,EACF,IAAU,SAAU,GACpB,EAAG,YAAc,IAEjB,EAAG,YAAc,EAAY,wBAKrC,EAAU,EAAG,KAAO,SACjB,KACC,GAAU,EAAM,KAAK,GAAS,MAE7B,UAAU,IAAM,EAAG,SAGjB,GAAiB,EAAI,CAAE,MAAK,QAChC,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,KCjG3B,YACL,EAAiB,CAAE,OAAqB,CAAE,UACL,CACrC,GAAM,GAAQ,GAAI,GACZ,EAAY,GAAqB,EAAG,eACvC,KACC,EAAO,UAIL,EAAO,EAAW,wBAAyB,GAC3C,EAAO,EAAW,uBAAwB,GAG1C,EAAS,EACZ,KACC,EAAO,IACP,GAAK,IAIT,SACG,KACC,GAAe,GACf,GAAU,IAET,UAAU,CAAC,CAAC,CAAE,SAAS,CAAE,YAAa,CACrC,GAAI,EACF,OAAQ,EAAM,YAGP,GACH,EAAK,YAAc,EAAY,sBAC/B,UAGG,GACH,EAAK,YAAc,EAAY,qBAC/B,cAIA,EAAK,YAAc,EACjB,sBACA,GAAM,EAAM,aAIlB,GAAK,YAAc,EAAY,+BAKvC,EACG,KACC,EAAI,IAAM,EAAK,UAAY,IAC3B,EAAU,CAAC,CAAE,WAAY,EACvB,EAAG,GAAG,EAAM,MAAM,EAAG,KACrB,EAAG,GAAG,EAAM,MAAM,KACf,KACC,GAAY,GACZ,GAAQ,GACR,EAAU,CAAC,CAAC,KAAW,EAAG,GAAG,QAIlC,UAAU,GAAU,EAAK,YACxB,GAAuB,KAWtB,AAPS,EACb,KACC,EAAO,IACP,EAAI,CAAC,CAAE,UAAW,IAKnB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,KCxF3B,YACL,EAAkB,CAAE,UACK,CACzB,MAAO,GACJ,KACC,EAAI,CAAC,CAAE,WAAY,CACjB,GAAM,GAAM,KACZ,SAAI,KAAO,GACX,EAAI,aAAa,OAAO,KACxB,EAAI,aAAa,IAAI,IAAK,GACnB,CAAE,UAaV,YACL,EAAuB,EACa,CACpC,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAAC,CAAE,SAAU,CAC3B,EAAG,aAAa,sBAAuB,EAAG,MAC1C,EAAG,KAAO,GAAG,MAIf,EAAU,EAAI,SACX,UAAU,GAAM,EAAG,kBAGf,GAAiB,EAAI,GACzB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,KCpC3B,YACL,EAAiB,CAAE,OAAqB,CAAE,aACJ,CACtC,GAAM,GAAQ,GAAI,GAGZ,EAAS,GAAoB,gBAC7B,EAAS,EACb,EAAU,EAAO,WACjB,EAAU,EAAO,UAEhB,KACC,GAAU,IACV,EAAI,IAAM,EAAM,OAChB,KAIJ,SACG,KACC,GAAkB,GAClB,EAAI,CAAC,CAAC,CAAE,eAAe,KAAW,CAChC,GAAM,GAAQ,EAAM,MAAM,YAC1B,GAAI,kBAAa,SAAU,EAAM,EAAM,OAAS,GAAI,CAClD,GAAM,GAAO,EAAY,EAAY,OAAS,GAC9C,AAAI,EAAK,WAAW,EAAM,EAAM,OAAS,KACvC,GAAM,EAAM,OAAS,GAAK,OAE5B,GAAM,OAAS,EAEjB,MAAO,MAGR,UAAU,GAAS,EAAG,UAAY,EAChC,KAAK,IACL,QAAQ,MAAO,WAItB,EACG,KACC,EAAO,CAAC,CAAE,UAAW,IAAS,WAE7B,UAAU,GAAO,CAChB,OAAQ,EAAI,UAGL,aACH,AACE,EAAG,UAAU,QACb,EAAM,iBAAmB,EAAM,MAAM,QAErC,GAAM,MAAQ,EAAG,WACnB,SAYH,AAPS,EACb,KACC,EAAO,IACP,EAAI,CAAC,CAAE,UAAW,IAKnB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,IAAO,EAAE,IAAK,MC5CjB,YACL,EAAiB,CAAE,SAAQ,aACI,CAC/B,GAAM,GAAS,KACf,GAAI,CACF,GAAM,GAAM,gCAAU,SAAU,EAAO,OACjC,EAAS,GAAkB,EAAK,GAGhC,EAAS,GAAoB,eAAgB,GAC7C,EAAS,GAAoB,gBAAiB,GAG9C,CAAE,MAAK,OAAQ,EACrB,EACG,KACC,EAAO,IACP,GAAO,EAAI,KAAK,EAAO,MACvB,GAAK,IAEJ,UAAU,EAAI,KAAK,KAAK,IAG7B,EACG,KACC,EAAO,CAAC,CAAE,UAAW,IAAS,WAE7B,UAAU,GAAO,CAChB,GAAM,GAAS,KACf,OAAQ,EAAI,UAGL,QACH,GAAI,IAAW,EAAO,CACpB,GAAM,GAAU,GAAI,KACpB,OAAW,KAAU,GACnB,sBAAuB,GACtB,CACD,GAAM,GAAU,EAAO,kBACvB,EAAQ,IAAI,EAAQ,WAClB,EAAQ,aAAa,mBAKzB,GAAI,EAAQ,KAAM,CAChB,GAAM,CAAC,CAAC,IAAS,CAAC,GAAG,GAAS,KAAK,CAAC,CAAC,CAAE,GAAI,CAAC,CAAE,KAAO,EAAI,GACzD,EAAK,QAIP,EAAI,QAEN,UAGG,aACA,MACH,GAAU,SAAU,IACpB,EAAM,OACN,UAGG,cACA,YACH,GAAI,MAAO,IAAW,YACpB,EAAM,YACD,CACL,GAAM,GAAM,CAAC,EAAO,GAAG,EACrB,wDACA,IAEI,EAAI,KAAK,IAAI,EACjB,MAAK,IAAI,EAAG,EAAI,QAAQ,IAAW,EAAI,OACrC,GAAI,OAAS,UAAY,GAAK,IAE9B,EAAI,QACR,EAAI,GAAG,QAIT,EAAI,QACJ,cAIA,AAAI,IAAU,MACZ,EAAM,WAKlB,EACG,KACC,EAAO,CAAC,CAAE,UAAW,IAAS,WAE7B,UAAU,GAAO,CAChB,OAAQ,EAAI,UAGL,QACA,QACA,IACH,EAAM,QACN,EAAM,SAGN,EAAI,QACJ,SAKV,GAAM,GAAU,GAAiB,EAAO,GAClC,EAAU,GAAkB,EAAQ,EAAQ,CAAE,WACpD,MAAO,GAAM,EAAQ,GAClB,KACC,GAGE,GAAG,GAAqB,eAAgB,GACrC,IAAI,GAAS,GAAiB,EAAO,CAAE,YAG1C,GAAG,GAAqB,iBAAkB,GACvC,IAAI,GAAS,GAAmB,EAAO,EAAQ,CAAE,uBAKnD,EAAP,CACA,SAAG,OAAS,GACL,ICpKJ,YACL,EAAiB,CAAE,SAAQ,aACa,CACxC,MAAO,GAAc,CACnB,EACA,EACG,KACC,EAAU,MACV,EAAO,GAAO,CAAC,CAAC,EAAI,aAAa,IAAI,SAGxC,KACC,EAAI,CAAC,CAAC,EAAO,KAAS,GAAuB,EAAM,OAAQ,IACzD,EAAI,aAAa,IAAI,OAEvB,EAAI,GAAM,CA1FhB,MA2FQ,GAAM,GAAQ,GAAI,KAGZ,EAAK,SAAS,mBAAmB,EAAI,WAAW,WACtD,OAAS,GAAO,EAAG,WAAY,EAAM,EAAO,EAAG,WAC7C,GAAI,KAAK,gBAAL,cAAoB,aAAc,CACpC,GAAM,GAAW,EAAK,YAChB,EAAW,EAAG,GACpB,AAAI,EAAS,OAAS,EAAS,QAC7B,EAAM,IAAI,EAAmB,GAKnC,OAAW,CAAC,EAAM,IAAS,GAAO,CAChC,GAAM,CAAE,cAAe,EAAE,OAAQ,KAAM,GACvC,EAAK,YAAY,GAAG,MAAM,KAAK,IAIjC,MAAO,CAAE,IAAK,EAAI,YCfnB,YACL,EAAiB,CAAE,YAAW,SACT,CACrB,GAAM,GAAS,EAAG,cACZ,EACJ,EAAO,UACP,EAAO,cAAe,UAGxB,MAAO,GAAc,CAAC,EAAO,IAC1B,KACC,EAAI,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAE,OAAQ,CAAE,SACpC,GAAS,EACL,KAAK,IAAI,EAAQ,KAAK,IAAI,EAAG,EAAI,IACjC,EACG,CACL,SACA,OAAQ,GAAK,EAAS,KAG1B,EAAqB,CAAC,EAAG,IACvB,EAAE,SAAW,EAAE,QACf,EAAE,SAAW,EAAE,SA0BhB,YACL,EAAiB,EACe,CADf,QAAE,YAAF,EAAc,KAAd,EAAc,CAAZ,YAEnB,GAAM,GAAQ,EAAW,0BAA2B,GAC9C,CAAE,KAAM,GAAiB,GAC/B,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SACG,KACC,GAAU,EAAG,IACb,GAAe,IAEd,UAAU,CAGT,KAAK,CAAC,CAAE,UAAU,CAAE,OAAQ,IAAW,CACrC,EAAM,MAAM,OAAS,GAAG,EAAS,EAAI,MACrC,EAAG,MAAM,IAAY,GAAG,OAI1B,UAAW,CACT,EAAM,MAAM,OAAS,GACrB,EAAG,MAAM,IAAY,MAKtB,GAAa,EAAI,GACrB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCvH7B,YACL,EAAc,EACW,CACzB,GAAI,MAAO,IAAS,YAAa,CAC/B,GAAM,GAAM,gCAAgC,KAAQ,IACpD,MAAO,IAGL,GAAqB,GAAG,qBACrB,KACC,EAAI,GAAY,EACd,QAAS,EAAQ,YAEnB,GAAe,KAInB,GAAkB,GACf,KACC,EAAI,GAAS,EACX,MAAO,EAAK,iBACZ,MAAO,EAAK,eAEd,GAAe,MAGlB,KACC,EAAI,CAAC,CAAC,EAAS,KAAW,OAAK,GAAY,SAI1C,CACL,GAAM,GAAM,gCAAgC,IAC5C,MAAO,IAAkB,GACtB,KACC,EAAI,GAAS,EACX,aAAc,EAAK,gBAErB,GAAe,MClDhB,YACL,EAAc,EACW,CACzB,GAAM,GAAM,WAAW,qBAAwB,mBAAmB,KAClE,MAAO,IAA2B,GAC/B,KACC,EAAI,CAAC,CAAE,aAAY,iBAAmB,EACpC,MAAO,EACP,MAAO,KAET,GAAe,KCYd,YACL,EACyB,CACzB,GAAM,CAAC,GAAQ,EAAI,MAAM,sBAAwB,GACjD,OAAQ,EAAK,mBAGN,SACH,GAAM,CAAC,CAAE,EAAM,GAAQ,EAAI,MAAM,uCACjC,MAAO,IAA2B,EAAM,OAGrC,SACH,GAAM,CAAC,CAAE,EAAM,GAAQ,EAAI,MAAM,sCACjC,MAAO,IAA2B,EAAM,WAIxC,MAAO,ICtBb,GAAI,IAgBG,YACL,EACoB,CACpB,MAAO,SAAW,EAAM,IAAM,CAC5B,GAAM,GAAS,SAAsB,WAAY,gBACjD,MAAI,GACK,EAAG,GAEH,GAAiB,EAAG,MACxB,KACC,EAAI,GAAS,SAAS,WAAY,EAAO,oBAG9C,KACC,GAAW,IAAM,GACjB,EAAO,GAAS,OAAO,KAAK,GAAO,OAAS,GAC5C,EAAI,GAAU,EAAE,WAChB,EAAY,KAWX,YACL,EAC+B,CAC/B,GAAM,GAAQ,EAAW,uBAAwB,GACjD,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAAC,CAAE,WAAY,CAC7B,EAAM,YAAY,GAAkB,IACpC,EAAM,aAAa,gBAAiB,UAI/B,GAAY,GAChB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OCpC7B,YACL,EAAiB,CAAE,YAAW,WACZ,CAClB,MAAO,IAAiB,SAAS,MAC9B,KACC,EAAU,IAAM,GAAgB,EAAI,CAAE,UAAS,eAC/C,EAAI,CAAC,CAAE,OAAQ,CAAE,QACR,EACL,OAAQ,GAAK,MAGjB,EAAwB,WAevB,YACL,EAAiB,EACY,CAC7B,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAGd,KAAK,CAAE,UAAU,CACf,AAAI,EACF,EAAG,aAAa,gBAAiB,UAEjC,EAAG,gBAAgB,kBAIvB,UAAW,CACT,EAAG,gBAAgB,oBAMrB,IAAQ,0BACJ,EAAG,CAAE,OAAQ,KACb,GAAU,EAAI,IAEjB,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OChC7B,YACL,EAAiB,CAAE,YAAW,WACD,CAC7B,GAAM,GAAQ,GAAI,KAGZ,EAAU,EAA+B,cAAe,GAC9D,OAAW,KAAU,GAAS,CAC5B,GAAM,GAAK,mBAAmB,EAAO,KAAK,UAAU,IAC9C,EAAS,GAAmB,QAAQ,OAC1C,AAAI,MAAO,IAAW,aACpB,EAAM,IAAI,EAAQ,GAItB,GAAM,GAAU,EACb,KACC,EAAI,GAAU,GAAK,EAAO,SAgF9B,MAAO,AA5EY,IAAiB,SAAS,MAC1C,KACC,EAAwB,UAGxB,EAAU,GAAQ,EAAM,IAAM,CAC5B,GAAI,GAA4B,GAChC,MAAO,GAAG,CAAC,GAAG,GAAO,OAAO,CAAC,EAAO,CAAC,EAAQ,KAAY,CACvD,KAAO,EAAK,QAEN,AADS,EAAM,IAAI,EAAK,EAAK,OAAS,IACjC,SAAW,EAAO,SACzB,EAAK,MAOT,GAAI,GAAS,EAAO,UACpB,KAAO,CAAC,GAAU,EAAO,eACvB,EAAS,EAAO,cAChB,EAAS,EAAO,UAIlB,MAAO,GAAM,IACX,CAAC,GAAG,EAAO,CAAC,GAAG,EAAM,IAAS,UAC9B,IAED,GAAI,SAEN,KAGC,EAAI,GAAS,GAAI,KAAI,CAAC,GAAG,GAAO,KAAK,CAAC,CAAC,CAAE,GAAI,CAAC,CAAE,KAAO,EAAI,KAG3D,EAAU,GAAS,EAAc,CAAC,EAAW,IAC1C,KACC,GAAK,CAAC,CAAC,EAAM,GAAO,CAAC,CAAE,OAAQ,CAAE,KAAK,QAAQ,KAAY,CACxD,GAAM,GAAO,EAAI,EAAK,QAAU,KAAK,MAAM,EAAK,QAGhD,KAAO,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAE,GAAU,EAAK,GACxB,GAAI,EAAS,EAAS,GAAK,EACzB,EAAO,CAAC,GAAG,EAAM,EAAK,aAEtB,OAKJ,KAAO,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAE,GAAU,EAAK,EAAK,OAAS,GACtC,GAAI,EAAS,GAAU,GAAK,CAAC,EAC3B,EAAO,CAAC,EAAK,MAAQ,GAAG,OAExB,OAKJ,MAAO,CAAC,EAAM,IACb,CAAC,GAAI,CAAC,GAAG,KACZ,EAAqB,CAAC,EAAG,IACvB,EAAE,KAAO,EAAE,IACX,EAAE,KAAO,EAAE,SAUtB,KACC,EAAI,CAAC,CAAC,EAAM,KAAW,EACrB,KAAM,EAAK,IAAI,CAAC,CAAC,KAAU,GAC3B,KAAM,EAAK,IAAI,CAAC,CAAC,KAAU,MAI7B,EAAU,CAAE,KAAM,GAAI,KAAM,KAC5B,GAAY,EAAG,GACf,EAAI,CAAC,CAAC,EAAG,KAGH,EAAE,KAAK,OAAS,EAAE,KAAK,OAClB,CACL,KAAM,EAAE,KAAK,MAAM,KAAK,IAAI,EAAG,EAAE,KAAK,OAAS,GAAI,EAAE,KAAK,QAC1D,KAAM,IAKD,CACL,KAAM,EAAE,KAAK,MAAM,IACnB,KAAM,EAAE,KAAK,MAAM,EAAG,EAAE,KAAK,OAAS,EAAE,KAAK,WAiBlD,YACL,EAAiB,CAAE,YAAW,WACU,CACxC,MAAO,GAAM,IAAM,CACjB,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAAC,CAAE,OAAM,UAAW,CAGlC,OAAW,CAAC,IAAW,GACrB,EAAO,gBAAgB,iBACvB,EAAO,UAAU,OACf,wBAKJ,OAAW,CAAC,EAAO,CAAC,KAAY,GAAK,UACnC,EAAO,aAAa,gBAAiB,QACrC,EAAO,UAAU,OACf,uBACA,IAAU,EAAK,OAAS,KAM1B,GAAQ,wBACV,EACG,KACC,GAAU,EAAM,KAAK,GAAS,KAC9B,EAAwB,UACxB,GAAa,KACb,GAAe,IAEd,UAAU,CAAC,CAAC,CAAE,CAAE,WAAY,CAC3B,GAAM,GAAM,KAGN,EAAS,EAAK,EAAK,OAAS,GAClC,GAAI,GAAU,EAAO,OAAQ,CAC3B,GAAM,CAAC,GAAU,EACX,CAAE,QAAS,GAAI,KAAI,EAAO,MAChC,AAAI,EAAI,OAAS,GACf,GAAI,KAAO,EACX,QAAQ,aAAa,GAAI,GAAI,GAAG,UAKlC,GAAI,KAAO,GACX,QAAQ,aAAa,GAAI,GAAI,GAAG,OAKnC,GAAqB,EAAI,CAAE,YAAW,YAC1C,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,OC3N7B,YACL,EAAkB,CAAE,YAAW,SACR,CAGvB,GAAM,GAAa,EAChB,KACC,EAAI,CAAC,CAAE,OAAQ,CAAE,QAAU,GAC3B,GAAY,EAAG,GACf,EAAI,CAAC,CAAC,EAAG,KAAO,EAAI,GAAK,GACzB,KAIE,EAAU,EACb,KACC,EAAwB,WAI5B,MAAO,GAAc,CAAC,EAAS,IAC5B,KACC,EAAI,CAAC,CAAC,CAAE,UAAU,KAAgB,EAChC,OAAQ,CAAE,IAAU,MAEtB,EAAqB,CAAC,EAAG,IACvB,EAAE,SAAW,EAAE,SAehB,YACL,EAAiB,CAAE,YAAW,UAAS,SACL,CAClC,GAAM,GAAQ,GAAI,GAClB,SAAM,UAAU,CAGd,KAAK,CAAE,UAAU,CACf,AAAI,EACF,GAAG,aAAa,gBAAiB,UACjC,EAAG,aAAa,WAAY,MAC5B,EAAG,QAEH,GAAG,gBAAgB,iBACnB,EAAG,gBAAgB,cAKvB,UAAW,CACT,EAAG,MAAM,IAAM,GACf,EAAG,aAAa,gBAAiB,UACjC,EAAG,gBAAgB,eAKvB,EACG,KACC,GAAU,EAAM,KAAK,GAAQ,GAAI,GAAS,KAC1C,EAAwB,WAEvB,UAAU,CAAC,CAAE,YAAa,CACzB,EAAG,MAAM,IAAM,GAAG,EAAS,SAI1B,GAAe,EAAI,CAAE,YAAW,UAAS,UAC7C,KACC,EAAI,GAAS,EAAM,KAAK,IACxB,EAAS,IAAM,EAAM,YACrB,EAAI,GAAU,GAAE,IAAK,GAAO,KC9G3B,YACL,CAAE,YAAW,WACP,CACN,EACG,KACC,EAAU,IAAM,EAAG,GAAG,EACpB,mCAEF,EAAI,GAAM,CACR,EAAG,cAAgB,GACnB,EAAG,QAAU,KAEf,GAAS,GAAM,EAAU,EAAI,UAC1B,KACC,GAAU,IAAM,EAAG,aAAa,kBAChC,GAAM,KAGV,GAAe,IAEd,UAAU,CAAC,CAAC,EAAI,KAAY,CAC3B,EAAG,gBAAgB,iBACf,GACF,GAAG,QAAU,MC5BvB,aAAkC,CAChC,MAAO,qBAAqB,KAAK,UAAU,WAkBtC,YACL,CAAE,aACI,CACN,EACG,KACC,EAAU,IAAM,EAAG,GAAG,EAAY,yBAClC,EAAI,GAAM,EAAG,gBAAgB,sBAC7B,EAAO,IACP,GAAS,GAAM,EAAU,EAAI,cAC1B,KACC,GAAM,MAIT,UAAU,GAAM,CACf,GAAM,GAAM,EAAG,UAGf,AAAI,IAAQ,EACV,EAAG,UAAY,EAGN,EAAM,EAAG,eAAiB,EAAG,cACtC,GAAG,UAAY,EAAM,KClCxB,YACL,CAAE,YAAW,WACP,CACN,EAAc,CAAC,GAAY,UAAW,IACnC,KACC,EAAI,CAAC,CAAC,EAAQ,KAAY,GAAU,CAAC,GACrC,EAAU,GAAU,EAAG,GACpB,KACC,GAAM,EAAS,IAAM,OAGzB,GAAe,IAEd,UAAU,CAAC,CAAC,EAAQ,CAAE,OAAQ,CAAE,SAAU,CACzC,GAAI,EACF,SAAS,KAAK,aAAa,gBAAiB,QAC5C,SAAS,KAAK,MAAM,IAAM,IAAI,UACzB,CACL,GAAM,GAAQ,GAAK,SAAS,SAAS,KAAK,MAAM,IAAK,IACrD,SAAS,KAAK,gBAAgB,iBAC9B,SAAS,KAAK,MAAM,IAAM,GACtB,GACF,OAAO,SAAS,EAAG,MtLC/B,SAAS,gBAAgB,UAAU,OAAO,SAC1C,SAAS,gBAAgB,UAAU,IAAI,MAGvC,GAAM,IAAY,KACZ,GAAY,KACZ,GAAY,KACZ,GAAY,KAGZ,GAAY,KACZ,GAAY,GAAW,sBACvB,GAAY,GAAW,uBACvB,GAAY,KAGZ,GAAS,KACT,GAAS,SAAS,MAAM,UAAU,UACpC,gCAAU,QAAS,GACnB,GAAI,KAAI,2BAA4B,GAAO,OAE3C,GAGE,GAAS,GAAI,GACnB,GAAiB,CAAE,YAGnB,AAAI,GAAQ,uBACV,GAAoB,CAAE,aAAW,aAAW,eAnH9C,OAsHA,AAAI,QAAO,UAAP,eAAgB,YAAa,QAC/B,KAGF,EAAM,GAAW,IACd,KACC,GAAM,MAEL,UAAU,IAAM,CACf,GAAU,SAAU,IACpB,GAAU,SAAU,MAI1B,GACG,KACC,EAAO,CAAC,CAAE,UAAW,IAAS,WAE7B,UAAU,GAAO,CAChB,OAAQ,EAAI,UAGL,QACA,IACH,GAAM,GAAO,GAAmB,oBAChC,AAAI,MAAO,IAAS,aAClB,EAAK,QACP,UAGG,QACA,IACH,GAAM,GAAO,GAAmB,oBAChC,AAAI,MAAO,IAAS,aAClB,EAAK,QACP,SAKV,GAAmB,CAAE,aAAW,aAChC,GAAe,CAAE,eACjB,GAAgB,CAAE,aAAW,aAG7B,GAAM,IAAU,GAAY,GAAoB,UAAW,CAAE,eACvD,GAAQ,GACX,KACC,EAAI,IAAM,GAAoB,SAC9B,EAAU,GAAM,GAAU,EAAI,CAAE,aAAW,cAC3C,EAAY,IAIV,GAAW,EAGf,GAAG,GAAqB,UACrB,IAAI,GAAM,GAAY,EAAI,CAAE,aAG/B,GAAG,GAAqB,UACrB,IAAI,GAAM,GAAY,EAAI,CAAE,aAAW,WAAS,YAGnD,GAAG,GAAqB,WACrB,IAAI,GAAM,GAAa,IAG1B,GAAG,GAAqB,UACrB,IAAI,GAAM,GAAY,EAAI,CAAE,UAAQ,gBAGvC,GAAG,GAAqB,UACrB,IAAI,GAAM,GAAY,KAIrB,GAAW,EAAM,IAAM,EAG3B,GAAG,GAAqB,WACrB,IAAI,GAAM,GAAa,EAAI,CAAE,WAAS,aAGzC,GAAG,GAAqB,WACrB,IAAI,GAAM,GAAQ,oBACf,GAAoB,EAAI,CAAE,UAAQ,eAClC,GAIN,GAAG,GAAqB,gBACrB,IAAI,GAAM,GAAiB,EAAI,CAAE,aAAW,cAG/C,GAAG,GAAqB,WACrB,IAAI,GAAM,EAAG,aAAa,kBAAoB,aAC3C,GAAG,GAAS,IAAM,GAAa,EAAI,CAAE,aAAW,WAAS,YACzD,GAAG,GAAS,IAAM,GAAa,EAAI,CAAE,aAAW,WAAS,aAI/D,GAAG,GAAqB,QACrB,IAAI,GAAM,GAAU,EAAI,CAAE,aAAW,cAGxC,GAAG,GAAqB,OACrB,IAAI,GAAM,GAAqB,EAAI,CAAE,aAAW,cAGnD,GAAG,GAAqB,OACrB,IAAI,GAAM,GAAe,EAAI,CAAE,aAAW,WAAS,cAIlD,GAAa,GAChB,KACC,EAAU,IAAM,IAChB,GAAU,IACV,EAAY,IAIhB,GAAW,YAMX,OAAO,UAAa,GACpB,OAAO,UAAa,GACpB,OAAO,QAAa,GACpB,OAAO,UAAa,GACpB,OAAO,UAAa,GACpB,OAAO,QAAa,GACpB,OAAO,QAAa,GACpB,OAAO,OAAa,GACpB,OAAO,OAAa,GACpB,OAAO,WAAa", + "names": [] +} diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.ar.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.ar.min.js new file mode 100644 index 0000000000..248ddc5d14 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.ar.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ar=function(){this.pipeline.reset(),this.pipeline.add(e.ar.trimmer,e.ar.stopWordFilter,e.ar.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ar.stemmer))},e.ar.wordCharacters="ء-ٛٱـ",e.ar.trimmer=e.trimmerSupport.generateTrimmer(e.ar.wordCharacters),e.Pipeline.registerFunction(e.ar.trimmer,"trimmer-ar"),e.ar.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ف ك ب و س ل ن ا ي ت",pre2:"ال لل",pre3:"بال وال فال تال كال ولل",pre4:"فبال كبال وبال وكال"},e.suf={suf1:"ه ك ت ن ا ي",suf2:"نك نه ها وك يا اه ون ين تن تم نا وا ان كم كن ني نن ما هم هن تك ته ات يه",suf3:"تين كهم نيه نهم ونه وها يهم ونا ونك وني وهم تكم تنا تها تني تهم كما كها ناه نكم هنا تان يها",suf4:"كموه ناها ونني ونهم تكما تموه تكاه كماه ناكم ناهم نيها وننا"},e.patterns=JSON.parse('{"pt43":[{"pt":[{"c":"ا","l":1}]},{"pt":[{"c":"ا,ت,ن,ي","l":0}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"و","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ي","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ا","l":2},{"c":"ل","l":3,"m":3}]},{"pt":[{"c":"م","l":0}]}],"pt53":[{"pt":[{"c":"ت","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":3},{"c":"ل","l":3,"m":4},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":3}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ن","l":4}]},{"pt":[{"c":"ت","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"م","l":0},{"c":"و","l":3}]},{"pt":[{"c":"ا","l":1},{"c":"و","l":3}]},{"pt":[{"c":"و","l":1},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"ا","l":2},{"c":"ن","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":1},{"c":"ا","l":3}]},{"pt":[{"c":"ي,ت,ا,ن","l":0},{"c":"ت","l":1}],"mPt":[{"c":"ف","l":0,"m":2},{"c":"ع","l":1,"m":3},{"c":"ا","l":2},{"c":"ل","l":3,"m":4}]},{"pt":[{"c":"ت,ي,ا,ن","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":2},{"c":"ي","l":3}]},{"pt":[{"c":"ا,ي,ت,ن","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ء","l":4}]}],"pt63":[{"pt":[{"c":"ا","l":0},{"c":"ت","l":2},{"c":"ا","l":4}]},{"pt":[{"c":"ا,ت,ن,ي","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"و","l":3}]},{"pt":[{"c":"م","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ي","l":1},{"c":"ي","l":3},{"c":"ا","l":4},{"c":"ء","l":5}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ا","l":4}]}],"pt54":[{"pt":[{"c":"ت","l":0}]},{"pt":[{"c":"ا,ي,ت,ن","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"م","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":2}]}],"pt64":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":1}]}],"pt73":[{"pt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ا","l":5}]}],"pt75":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":5}]}]}'),e.execArray=["cleanWord","removeDiacritics","cleanAlef","removeStopWords","normalizeHamzaAndAlef","removeStartWaw","removePre432","removeEndTaa","wordCheck"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r=0)return!0},e.normalizeHamzaAndAlef=function(){return e.word=e.word.replace("ؤ","ء"),e.word=e.word.replace("ئ","ء"),e.word=e.word.replace(/([\u0627])\1+/gi,"ا"),!1},e.removeEndTaa=function(){return!(e.word.length>2)||(e.word=e.word.replace(/[\u0627]$/,""),e.word=e.word.replace("ة",""),!1)},e.removeStartWaw=function(){return e.word.length>3&&"و"==e.word[0]&&"و"==e.word[1]&&(e.word=e.word.slice(1)),!1},e.removePre432=function(){var r=e.word;if(e.word.length>=7){var t=new RegExp("^("+e.pre.pre4.split(" ").join("|")+")");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=6){var c=new RegExp("^("+e.pre.pre3.split(" ").join("|")+")");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=5){var l=new RegExp("^("+e.pre.pre2.split(" ").join("|")+")");e.word=e.word.replace(l,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.patternCheck=function(r){for(var t=0;t3){var t=new RegExp("^("+e.pre.pre1.split(" ").join("|")+")");e.word=e.word.replace(t,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.removeSuf1=function(){var r=e.word;if(0==e.sufRemoved&&e.word.length>3){var t=new RegExp("("+e.suf.suf1.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.removeSuf432=function(){var r=e.word;if(e.word.length>=6){var t=new RegExp("("+e.suf.suf4.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=5){var c=new RegExp("("+e.suf.suf3.split(" ").join("|")+")$");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=4){var l=new RegExp("("+e.suf.suf2.split(" ").join("|")+")$");e.word=e.word.replace(l,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.wordCheck=function(){for(var r=(e.word,[e.removeSuf432,e.removeSuf1,e.removePre1]),t=0,c=!1;e.word.length>=7&&!e.result&&t=f.limit)return;f.cursor++}for(;!f.out_grouping(w,97,248);){if(f.cursor>=f.limit)return;f.cursor++}d=f.cursor,d=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(c,32),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del();break;case 2:f.in_grouping_b(p,97,229)&&f.slice_del()}}function t(){var e,r=f.limit-f.cursor;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.find_among_b(l,4)?(f.bra=f.cursor,f.limit_backward=e,f.cursor=f.limit-r,f.cursor>f.limit_backward&&(f.cursor--,f.bra=f.cursor,f.slice_del())):f.limit_backward=e)}function s(){var e,r,i,n=f.limit-f.cursor;if(f.ket=f.cursor,f.eq_s_b(2,"st")&&(f.bra=f.cursor,f.eq_s_b(2,"ig")&&f.slice_del()),f.cursor=f.limit-n,f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(m,5),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del(),i=f.limit-f.cursor,t(),f.cursor=f.limit-i;break;case 2:f.slice_from("løs")}}function o(){var e;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.out_grouping_b(w,97,248)?(f.bra=f.cursor,u=f.slice_to(u),f.limit_backward=e,f.eq_v_b(u)&&f.slice_del()):f.limit_backward=e)}var a,d,u,c=[new r("hed",-1,1),new r("ethed",0,1),new r("ered",-1,1),new r("e",-1,1),new r("erede",3,1),new r("ende",3,1),new r("erende",5,1),new r("ene",3,1),new r("erne",3,1),new r("ere",3,1),new r("en",-1,1),new r("heden",10,1),new r("eren",10,1),new r("er",-1,1),new r("heder",13,1),new r("erer",13,1),new r("s",-1,2),new r("heds",16,1),new r("es",16,1),new r("endes",18,1),new r("erendes",19,1),new r("enes",18,1),new r("ernes",18,1),new r("eres",18,1),new r("ens",16,1),new r("hedens",24,1),new r("erens",24,1),new r("ers",16,1),new r("ets",16,1),new r("erets",28,1),new r("et",-1,1),new r("eret",30,1)],l=[new r("gd",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("elig",1,1),new r("els",-1,1),new r("løst",-1,2)],w=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],p=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16],f=new i;this.setCurrent=function(e){f.setCurrent(e)},this.getCurrent=function(){return f.getCurrent()},this.stem=function(){var r=f.cursor;return e(),f.limit_backward=r,f.cursor=f.limit,n(),f.cursor=f.limit,t(),f.cursor=f.limit,s(),f.cursor=f.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.da.stemmer,"stemmer-da"),e.da.stopWordFilter=e.generateStopWordFilter("ad af alle alt anden at blev blive bliver da de dem den denne der deres det dette dig din disse dog du efter eller en end er et for fra ham han hans har havde have hende hendes her hos hun hvad hvis hvor i ikke ind jeg jer jo kunne man mange med meget men mig min mine mit mod ned noget nogle nu når og også om op os over på selv sig sin sine sit skal skulle som sådan thi til ud under var vi vil ville vor være været".split(" ")),e.Pipeline.registerFunction(e.da.stopWordFilter,"stopWordFilter-da")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.de.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.de.min.js new file mode 100644 index 0000000000..f3b5c108c9 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.de.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `German` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.de=function(){this.pipeline.reset(),this.pipeline.add(e.de.trimmer,e.de.stopWordFilter,e.de.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.de.stemmer))},e.de.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.de.trimmer=e.trimmerSupport.generateTrimmer(e.de.wordCharacters),e.Pipeline.registerFunction(e.de.trimmer,"trimmer-de"),e.de.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!v.eq_s(1,e)||(v.ket=v.cursor,!v.in_grouping(p,97,252)))&&(v.slice_from(r),v.cursor=n,!0)}function i(){for(var r,n,i,s,t=v.cursor;;)if(r=v.cursor,v.bra=r,v.eq_s(1,"ß"))v.ket=v.cursor,v.slice_from("ss");else{if(r>=v.limit)break;v.cursor=r+1}for(v.cursor=t;;)for(n=v.cursor;;){if(i=v.cursor,v.in_grouping(p,97,252)){if(s=v.cursor,v.bra=s,e("u","U",i))break;if(v.cursor=s,e("y","Y",i))break}if(i>=v.limit)return void(v.cursor=n);v.cursor=i+1}}function s(){for(;!v.in_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}for(;!v.out_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}return!1}function t(){m=v.limit,l=m;var e=v.cursor+3;0<=e&&e<=v.limit&&(d=e,s()||(m=v.cursor,m=v.limit)return;v.cursor++}}}function c(){return m<=v.cursor}function u(){return l<=v.cursor}function a(){var e,r,n,i,s=v.limit-v.cursor;if(v.ket=v.cursor,(e=v.find_among_b(w,7))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:v.slice_del(),v.ket=v.cursor,v.eq_s_b(1,"s")&&(v.bra=v.cursor,v.eq_s_b(3,"nis")&&v.slice_del());break;case 3:v.in_grouping_b(g,98,116)&&v.slice_del()}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(f,4))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:if(v.in_grouping_b(k,98,116)){var t=v.cursor-3;v.limit_backward<=t&&t<=v.limit&&(v.cursor=t,v.slice_del())}}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(_,8))&&(v.bra=v.cursor,u()))switch(e){case 1:v.slice_del(),v.ket=v.cursor,v.eq_s_b(2,"ig")&&(v.bra=v.cursor,r=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-r,u()&&v.slice_del()));break;case 2:n=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-n,v.slice_del());break;case 3:if(v.slice_del(),v.ket=v.cursor,i=v.limit-v.cursor,!v.eq_s_b(2,"er")&&(v.cursor=v.limit-i,!v.eq_s_b(2,"en")))break;v.bra=v.cursor,c()&&v.slice_del();break;case 4:v.slice_del(),v.ket=v.cursor,e=v.find_among_b(b,2),e&&(v.bra=v.cursor,u()&&1==e&&v.slice_del())}}var d,l,m,h=[new r("",-1,6),new r("U",0,2),new r("Y",0,1),new r("ä",0,3),new r("ö",0,4),new r("ü",0,5)],w=[new r("e",-1,2),new r("em",-1,1),new r("en",-1,2),new r("ern",-1,1),new r("er",-1,1),new r("s",-1,3),new r("es",5,2)],f=[new r("en",-1,1),new r("er",-1,1),new r("st",-1,2),new r("est",2,1)],b=[new r("ig",-1,1),new r("lich",-1,1)],_=[new r("end",-1,1),new r("ig",-1,2),new r("ung",-1,1),new r("lich",-1,3),new r("isch",-1,2),new r("ik",-1,2),new r("heit",-1,3),new r("keit",-1,4)],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8],g=[117,30,5],k=[117,30,4],v=new n;this.setCurrent=function(e){v.setCurrent(e)},this.getCurrent=function(){return v.getCurrent()},this.stem=function(){var e=v.cursor;return i(),v.cursor=e,t(),v.limit_backward=e,v.cursor=v.limit,a(),v.cursor=v.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.de.stemmer,"stemmer-de"),e.de.stopWordFilter=e.generateStopWordFilter("aber alle allem allen aller alles als also am an ander andere anderem anderen anderer anderes anderm andern anderr anders auch auf aus bei bin bis bist da damit dann das dasselbe dazu daß dein deine deinem deinen deiner deines dem demselben den denn denselben der derer derselbe derselben des desselben dessen dich die dies diese dieselbe dieselben diesem diesen dieser dieses dir doch dort du durch ein eine einem einen einer eines einig einige einigem einigen einiger einiges einmal er es etwas euch euer eure eurem euren eurer eures für gegen gewesen hab habe haben hat hatte hatten hier hin hinter ich ihm ihn ihnen ihr ihre ihrem ihren ihrer ihres im in indem ins ist jede jedem jeden jeder jedes jene jenem jenen jener jenes jetzt kann kein keine keinem keinen keiner keines können könnte machen man manche manchem manchen mancher manches mein meine meinem meinen meiner meines mich mir mit muss musste nach nicht nichts noch nun nur ob oder ohne sehr sein seine seinem seinen seiner seines selbst sich sie sind so solche solchem solchen solcher solches soll sollte sondern sonst um und uns unse unsem unsen unser unses unter viel vom von vor war waren warst was weg weil weiter welche welchem welchen welcher welches wenn werde werden wie wieder will wir wird wirst wo wollen wollte während würde würden zu zum zur zwar zwischen über".split(" ")),e.Pipeline.registerFunction(e.de.stopWordFilter,"stopWordFilter-de")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.du.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.du.min.js new file mode 100644 index 0000000000..49a0f3f0ac --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.du.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Dutch` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");console.warn('[Lunr Languages] Please use the "nl" instead of the "du". The "nl" code is the standard code for Dutch language, and "du" will be removed in the next major versions.'),e.du=function(){this.pipeline.reset(),this.pipeline.add(e.du.trimmer,e.du.stopWordFilter,e.du.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.du.stemmer))},e.du.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.du.trimmer=e.trimmerSupport.generateTrimmer(e.du.wordCharacters),e.Pipeline.registerFunction(e.du.trimmer,"trimmer-du"),e.du.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e,r,i,o=C.cursor;;){if(C.bra=C.cursor,e=C.find_among(b,11))switch(C.ket=C.cursor,e){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(r=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=r);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=r;else if(n(r))break}else if(n(r))break}function n(e){return C.cursor=e,e>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,f=_,t()||(_=C.cursor,_<3&&(_=3),t()||(f=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var e;;)if(C.bra=C.cursor,e=C.find_among(p,3))switch(C.ket=C.cursor,e){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return f<=C.cursor}function a(){var e=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-e,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var e;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.slice_del(),w=!0,a())))}function m(){var e;u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.eq_s_b(3,"gem")||(C.cursor=C.limit-e,C.slice_del(),a())))}function d(){var e,r,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,e=C.find_among_b(h,5))switch(C.bra=C.cursor,e){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(z,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(r=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-r,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,e=C.find_among_b(k,6))switch(C.bra=C.cursor,e){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(j,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var f,_,w,b=[new r("",-1,6),new r("á",0,1),new r("ä",0,1),new r("é",0,2),new r("ë",0,2),new r("í",0,3),new r("ï",0,3),new r("ó",0,4),new r("ö",0,4),new r("ú",0,5),new r("ü",0,5)],p=[new r("",-1,3),new r("I",0,2),new r("Y",0,1)],g=[new r("dd",-1,-1),new r("kk",-1,-1),new r("tt",-1,-1)],h=[new r("ene",-1,2),new r("se",-1,3),new r("en",-1,2),new r("heden",2,1),new r("s",-1,3)],k=[new r("end",-1,1),new r("ig",-1,2),new r("ing",-1,1),new r("lijk",-1,3),new r("baar",-1,4),new r("bar",-1,5)],v=[new r("aa",-1,-1),new r("ee",-1,-1),new r("oo",-1,-1),new r("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(e){C.setCurrent(e)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var r=C.cursor;return e(),C.cursor=r,o(),C.limit_backward=r,C.cursor=C.limit,d(),C.cursor=C.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.du.stemmer,"stemmer-du"),e.du.stopWordFilter=e.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),e.Pipeline.registerFunction(e.du.stopWordFilter,"stopWordFilter-du")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.es.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.es.min.js new file mode 100644 index 0000000000..2989d34265 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.es.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Spanish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,s){"function"==typeof define&&define.amd?define(s):"object"==typeof exports?module.exports=s():s()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.es=function(){this.pipeline.reset(),this.pipeline.add(e.es.trimmer,e.es.stopWordFilter,e.es.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.es.stemmer))},e.es.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.es.trimmer=e.trimmerSupport.generateTrimmer(e.es.wordCharacters),e.Pipeline.registerFunction(e.es.trimmer,"trimmer-es"),e.es.stemmer=function(){var s=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(){if(A.out_grouping(x,97,252)){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}return!0}function n(){if(A.in_grouping(x,97,252)){var s=A.cursor;if(e()){if(A.cursor=s,!A.in_grouping(x,97,252))return!0;for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}}return!1}return!0}function i(){var s,r=A.cursor;if(n()){if(A.cursor=r,!A.out_grouping(x,97,252))return;if(s=A.cursor,e()){if(A.cursor=s,!A.in_grouping(x,97,252)||A.cursor>=A.limit)return;A.cursor++}}g=A.cursor}function a(){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}return!0}function t(){var e=A.cursor;g=A.limit,p=g,v=g,i(),A.cursor=e,a()&&(p=A.cursor,a()&&(v=A.cursor))}function o(){for(var e;;){if(A.bra=A.cursor,e=A.find_among(k,6))switch(A.ket=A.cursor,e){case 1:A.slice_from("a");continue;case 2:A.slice_from("e");continue;case 3:A.slice_from("i");continue;case 4:A.slice_from("o");continue;case 5:A.slice_from("u");continue;case 6:if(A.cursor>=A.limit)break;A.cursor++;continue}break}}function u(){return g<=A.cursor}function w(){return p<=A.cursor}function c(){return v<=A.cursor}function m(){var e;if(A.ket=A.cursor,A.find_among_b(y,13)&&(A.bra=A.cursor,(e=A.find_among_b(q,11))&&u()))switch(e){case 1:A.bra=A.cursor,A.slice_from("iendo");break;case 2:A.bra=A.cursor,A.slice_from("ando");break;case 3:A.bra=A.cursor,A.slice_from("ar");break;case 4:A.bra=A.cursor,A.slice_from("er");break;case 5:A.bra=A.cursor,A.slice_from("ir");break;case 6:A.slice_del();break;case 7:A.eq_s_b(1,"u")&&A.slice_del()}}function l(e,s){if(!c())return!0;A.slice_del(),A.ket=A.cursor;var r=A.find_among_b(e,s);return r&&(A.bra=A.cursor,1==r&&c()&&A.slice_del()),!1}function d(e){return!c()||(A.slice_del(),A.ket=A.cursor,A.eq_s_b(2,e)&&(A.bra=A.cursor,c()&&A.slice_del()),!1)}function b(){var e;if(A.ket=A.cursor,e=A.find_among_b(S,46)){switch(A.bra=A.cursor,e){case 1:if(!c())return!1;A.slice_del();break;case 2:if(d("ic"))return!1;break;case 3:if(!c())return!1;A.slice_from("log");break;case 4:if(!c())return!1;A.slice_from("u");break;case 5:if(!c())return!1;A.slice_from("ente");break;case 6:if(!w())return!1;A.slice_del(),A.ket=A.cursor,e=A.find_among_b(C,4),e&&(A.bra=A.cursor,c()&&(A.slice_del(),1==e&&(A.ket=A.cursor,A.eq_s_b(2,"at")&&(A.bra=A.cursor,c()&&A.slice_del()))));break;case 7:if(l(P,3))return!1;break;case 8:if(l(F,3))return!1;break;case 9:if(d("at"))return!1}return!0}return!1}function f(){var e,s;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(W,12),A.limit_backward=s,e)){if(A.bra=A.cursor,1==e){if(!A.eq_s_b(1,"u"))return!1;A.slice_del()}return!0}return!1}function _(){var e,s,r,n;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(L,96),A.limit_backward=s,e))switch(A.bra=A.cursor,e){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"u")?(n=A.limit-A.cursor,A.eq_s_b(1,"g")?A.cursor=A.limit-n:A.cursor=A.limit-r):A.cursor=A.limit-r,A.bra=A.cursor;case 2:A.slice_del()}}function h(){var e,s;if(A.ket=A.cursor,e=A.find_among_b(z,8))switch(A.bra=A.cursor,e){case 1:u()&&A.slice_del();break;case 2:u()&&(A.slice_del(),A.ket=A.cursor,A.eq_s_b(1,"u")&&(A.bra=A.cursor,s=A.limit-A.cursor,A.eq_s_b(1,"g")&&(A.cursor=A.limit-s,u()&&A.slice_del())))}}var v,p,g,k=[new s("",-1,6),new s("á",0,1),new s("é",0,2),new s("í",0,3),new s("ó",0,4),new s("ú",0,5)],y=[new s("la",-1,-1),new s("sela",0,-1),new s("le",-1,-1),new s("me",-1,-1),new s("se",-1,-1),new s("lo",-1,-1),new s("selo",5,-1),new s("las",-1,-1),new s("selas",7,-1),new s("les",-1,-1),new s("los",-1,-1),new s("selos",10,-1),new s("nos",-1,-1)],q=[new s("ando",-1,6),new s("iendo",-1,6),new s("yendo",-1,7),new s("ándo",-1,2),new s("iéndo",-1,1),new s("ar",-1,6),new s("er",-1,6),new s("ir",-1,6),new s("ár",-1,3),new s("ér",-1,4),new s("ír",-1,5)],C=[new s("ic",-1,-1),new s("ad",-1,-1),new s("os",-1,-1),new s("iv",-1,1)],P=[new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,1)],F=[new s("ic",-1,1),new s("abil",-1,1),new s("iv",-1,1)],S=[new s("ica",-1,1),new s("ancia",-1,2),new s("encia",-1,5),new s("adora",-1,2),new s("osa",-1,1),new s("ista",-1,1),new s("iva",-1,9),new s("anza",-1,1),new s("logía",-1,3),new s("idad",-1,8),new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,2),new s("mente",-1,7),new s("amente",13,6),new s("ación",-1,2),new s("ución",-1,4),new s("ico",-1,1),new s("ismo",-1,1),new s("oso",-1,1),new s("amiento",-1,1),new s("imiento",-1,1),new s("ivo",-1,9),new s("ador",-1,2),new s("icas",-1,1),new s("ancias",-1,2),new s("encias",-1,5),new s("adoras",-1,2),new s("osas",-1,1),new s("istas",-1,1),new s("ivas",-1,9),new s("anzas",-1,1),new s("logías",-1,3),new s("idades",-1,8),new s("ables",-1,1),new s("ibles",-1,1),new s("aciones",-1,2),new s("uciones",-1,4),new s("adores",-1,2),new s("antes",-1,2),new s("icos",-1,1),new s("ismos",-1,1),new s("osos",-1,1),new s("amientos",-1,1),new s("imientos",-1,1),new s("ivos",-1,9)],W=[new s("ya",-1,1),new s("ye",-1,1),new s("yan",-1,1),new s("yen",-1,1),new s("yeron",-1,1),new s("yendo",-1,1),new s("yo",-1,1),new s("yas",-1,1),new s("yes",-1,1),new s("yais",-1,1),new s("yamos",-1,1),new s("yó",-1,1)],L=[new s("aba",-1,2),new s("ada",-1,2),new s("ida",-1,2),new s("ara",-1,2),new s("iera",-1,2),new s("ía",-1,2),new s("aría",5,2),new s("ería",5,2),new s("iría",5,2),new s("ad",-1,2),new s("ed",-1,2),new s("id",-1,2),new s("ase",-1,2),new s("iese",-1,2),new s("aste",-1,2),new s("iste",-1,2),new s("an",-1,2),new s("aban",16,2),new s("aran",16,2),new s("ieran",16,2),new s("ían",16,2),new s("arían",20,2),new s("erían",20,2),new s("irían",20,2),new s("en",-1,1),new s("asen",24,2),new s("iesen",24,2),new s("aron",-1,2),new s("ieron",-1,2),new s("arán",-1,2),new s("erán",-1,2),new s("irán",-1,2),new s("ado",-1,2),new s("ido",-1,2),new s("ando",-1,2),new s("iendo",-1,2),new s("ar",-1,2),new s("er",-1,2),new s("ir",-1,2),new s("as",-1,2),new s("abas",39,2),new s("adas",39,2),new s("idas",39,2),new s("aras",39,2),new s("ieras",39,2),new s("ías",39,2),new s("arías",45,2),new s("erías",45,2),new s("irías",45,2),new s("es",-1,1),new s("ases",49,2),new s("ieses",49,2),new s("abais",-1,2),new s("arais",-1,2),new s("ierais",-1,2),new s("íais",-1,2),new s("aríais",55,2),new s("eríais",55,2),new s("iríais",55,2),new s("aseis",-1,2),new s("ieseis",-1,2),new s("asteis",-1,2),new s("isteis",-1,2),new s("áis",-1,2),new s("éis",-1,1),new s("aréis",64,2),new s("eréis",64,2),new s("iréis",64,2),new s("ados",-1,2),new s("idos",-1,2),new s("amos",-1,2),new s("ábamos",70,2),new s("áramos",70,2),new s("iéramos",70,2),new s("íamos",70,2),new s("aríamos",74,2),new s("eríamos",74,2),new s("iríamos",74,2),new s("emos",-1,1),new s("aremos",78,2),new s("eremos",78,2),new s("iremos",78,2),new s("ásemos",78,2),new s("iésemos",78,2),new s("imos",-1,2),new s("arás",-1,2),new s("erás",-1,2),new s("irás",-1,2),new s("ís",-1,2),new s("ará",-1,2),new s("erá",-1,2),new s("irá",-1,2),new s("aré",-1,2),new s("eré",-1,2),new s("iré",-1,2),new s("ió",-1,2)],z=[new s("a",-1,1),new s("e",-1,2),new s("o",-1,1),new s("os",-1,1),new s("á",-1,1),new s("é",-1,2),new s("í",-1,1),new s("ó",-1,1)],x=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10],A=new r;this.setCurrent=function(e){A.setCurrent(e)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return t(),A.limit_backward=e,A.cursor=A.limit,m(),A.cursor=A.limit,b()||(A.cursor=A.limit,f()||(A.cursor=A.limit,_())),A.cursor=A.limit,h(),A.cursor=A.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.es.stemmer,"stemmer-es"),e.es.stopWordFilter=e.generateStopWordFilter("a al algo algunas algunos ante antes como con contra cual cuando de del desde donde durante e el ella ellas ellos en entre era erais eran eras eres es esa esas ese eso esos esta estaba estabais estaban estabas estad estada estadas estado estados estamos estando estar estaremos estará estarán estarás estaré estaréis estaría estaríais estaríamos estarían estarías estas este estemos esto estos estoy estuve estuviera estuvierais estuvieran estuvieras estuvieron estuviese estuvieseis estuviesen estuvieses estuvimos estuviste estuvisteis estuviéramos estuviésemos estuvo está estábamos estáis están estás esté estéis estén estés fue fuera fuerais fueran fueras fueron fuese fueseis fuesen fueses fui fuimos fuiste fuisteis fuéramos fuésemos ha habida habidas habido habidos habiendo habremos habrá habrán habrás habré habréis habría habríais habríamos habrían habrías habéis había habíais habíamos habían habías han has hasta hay haya hayamos hayan hayas hayáis he hemos hube hubiera hubierais hubieran hubieras hubieron hubiese hubieseis hubiesen hubieses hubimos hubiste hubisteis hubiéramos hubiésemos hubo la las le les lo los me mi mis mucho muchos muy más mí mía mías mío míos nada ni no nos nosotras nosotros nuestra nuestras nuestro nuestros o os otra otras otro otros para pero poco por porque que quien quienes qué se sea seamos sean seas seremos será serán serás seré seréis sería seríais seríamos serían serías seáis sido siendo sin sobre sois somos son soy su sus suya suyas suyo suyos sí también tanto te tendremos tendrá tendrán tendrás tendré tendréis tendría tendríais tendríamos tendrían tendrías tened tenemos tenga tengamos tengan tengas tengo tengáis tenida tenidas tenido tenidos teniendo tenéis tenía teníais teníamos tenían tenías ti tiene tienen tienes todo todos tu tus tuve tuviera tuvierais tuvieran tuvieras tuvieron tuviese tuvieseis tuviesen tuvieses tuvimos tuviste tuvisteis tuviéramos tuviésemos tuvo tuya tuyas tuyo tuyos tú un una uno unos vosotras vosotros vuestra vuestras vuestro vuestros y ya yo él éramos".split(" ")),e.Pipeline.registerFunction(e.es.stopWordFilter,"stopWordFilter-es")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.fi.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.fi.min.js new file mode 100644 index 0000000000..29f5dfcea8 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.fi.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Finnish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(i,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(i.lunr)}(this,function(){return function(i){if(void 0===i)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===i.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");i.fi=function(){this.pipeline.reset(),this.pipeline.add(i.fi.trimmer,i.fi.stopWordFilter,i.fi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(i.fi.stemmer))},i.fi.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",i.fi.trimmer=i.trimmerSupport.generateTrimmer(i.fi.wordCharacters),i.Pipeline.registerFunction(i.fi.trimmer,"trimmer-fi"),i.fi.stemmer=function(){var e=i.stemmerSupport.Among,r=i.stemmerSupport.SnowballProgram,n=new function(){function i(){f=A.limit,d=f,n()||(f=A.cursor,n()||(d=A.cursor))}function n(){for(var i;;){if(i=A.cursor,A.in_grouping(W,97,246))break;if(A.cursor=i,i>=A.limit)return!0;A.cursor++}for(A.cursor=i;!A.out_grouping(W,97,246);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}function t(){return d<=A.cursor}function s(){var i,e;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(h,10)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.in_grouping_b(x,97,246))return;break;case 2:if(!t())return}A.slice_del()}else A.limit_backward=e}function o(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(v,9))switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"k")||(A.cursor=A.limit-r,A.slice_del());break;case 2:A.slice_del(),A.ket=A.cursor,A.eq_s_b(3,"kse")&&(A.bra=A.cursor,A.slice_from("ksi"));break;case 3:A.slice_del();break;case 4:A.find_among_b(p,6)&&A.slice_del();break;case 5:A.find_among_b(g,6)&&A.slice_del();break;case 6:A.find_among_b(j,2)&&A.slice_del()}else A.limit_backward=e}function l(){return A.find_among_b(q,7)}function a(){return A.eq_s_b(1,"i")&&A.in_grouping_b(L,97,246)}function u(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(C,30)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.eq_s_b(1,"a"))return;break;case 2:case 9:if(!A.eq_s_b(1,"e"))return;break;case 3:if(!A.eq_s_b(1,"i"))return;break;case 4:if(!A.eq_s_b(1,"o"))return;break;case 5:if(!A.eq_s_b(1,"ä"))return;break;case 6:if(!A.eq_s_b(1,"ö"))return;break;case 7:if(r=A.limit-A.cursor,!l()&&(A.cursor=A.limit-r,!A.eq_s_b(2,"ie"))){A.cursor=A.limit-r;break}if(A.cursor=A.limit-r,A.cursor<=A.limit_backward){A.cursor=A.limit-r;break}A.cursor--,A.bra=A.cursor;break;case 8:if(!A.in_grouping_b(W,97,246)||!A.out_grouping_b(W,97,246))return}A.slice_del(),k=!0}else A.limit_backward=e}function c(){var i,e,r;if(A.cursor>=d)if(e=A.limit_backward,A.limit_backward=d,A.ket=A.cursor,i=A.find_among_b(P,14)){if(A.bra=A.cursor,A.limit_backward=e,1==i){if(r=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-r}A.slice_del()}else A.limit_backward=e}function m(){var i;A.cursor>=f&&(i=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.find_among_b(F,2)?(A.bra=A.cursor,A.limit_backward=i,A.slice_del()):A.limit_backward=i)}function w(){var i,e,r,n,t,s;if(A.cursor>=f){if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.eq_s_b(1,"t")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.in_grouping_b(W,97,246)&&(A.cursor=A.limit-r,A.slice_del(),A.limit_backward=e,n=A.limit-A.cursor,A.cursor>=d&&(A.cursor=d,t=A.limit_backward,A.limit_backward=A.cursor,A.cursor=A.limit-n,A.ket=A.cursor,i=A.find_among_b(S,2))))){if(A.bra=A.cursor,A.limit_backward=t,1==i){if(s=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-s}return void A.slice_del()}A.limit_backward=e}}function _(){var i,e,r,n;if(A.cursor>=f){for(i=A.limit_backward,A.limit_backward=f,e=A.limit-A.cursor,l()&&(A.cursor=A.limit-e,A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.in_grouping_b(y,97,228)&&(A.bra=A.cursor,A.out_grouping_b(W,97,246)&&A.slice_del()),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"j")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.eq_s_b(1,"o")?A.slice_del():(A.cursor=A.limit-r,A.eq_s_b(1,"u")&&A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"o")&&(A.bra=A.cursor,A.eq_s_b(1,"j")&&A.slice_del()),A.cursor=A.limit-e,A.limit_backward=i;;){if(n=A.limit-A.cursor,A.out_grouping_b(W,97,246)){A.cursor=A.limit-n;break}if(A.cursor=A.limit-n,A.cursor<=A.limit_backward)return;A.cursor--}A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,b=A.slice_to(),A.eq_v_b(b)&&A.slice_del())}}var k,b,d,f,h=[new e("pa",-1,1),new e("sti",-1,2),new e("kaan",-1,1),new e("han",-1,1),new e("kin",-1,1),new e("hän",-1,1),new e("kään",-1,1),new e("ko",-1,1),new e("pä",-1,1),new e("kö",-1,1)],p=[new e("lla",-1,-1),new e("na",-1,-1),new e("ssa",-1,-1),new e("ta",-1,-1),new e("lta",3,-1),new e("sta",3,-1)],g=[new e("llä",-1,-1),new e("nä",-1,-1),new e("ssä",-1,-1),new e("tä",-1,-1),new e("ltä",3,-1),new e("stä",3,-1)],j=[new e("lle",-1,-1),new e("ine",-1,-1)],v=[new e("nsa",-1,3),new e("mme",-1,3),new e("nne",-1,3),new e("ni",-1,2),new e("si",-1,1),new e("an",-1,4),new e("en",-1,6),new e("än",-1,5),new e("nsä",-1,3)],q=[new e("aa",-1,-1),new e("ee",-1,-1),new e("ii",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1),new e("ää",-1,-1),new e("öö",-1,-1)],C=[new e("a",-1,8),new e("lla",0,-1),new e("na",0,-1),new e("ssa",0,-1),new e("ta",0,-1),new e("lta",4,-1),new e("sta",4,-1),new e("tta",4,9),new e("lle",-1,-1),new e("ine",-1,-1),new e("ksi",-1,-1),new e("n",-1,7),new e("han",11,1),new e("den",11,-1,a),new e("seen",11,-1,l),new e("hen",11,2),new e("tten",11,-1,a),new e("hin",11,3),new e("siin",11,-1,a),new e("hon",11,4),new e("hän",11,5),new e("hön",11,6),new e("ä",-1,8),new e("llä",22,-1),new e("nä",22,-1),new e("ssä",22,-1),new e("tä",22,-1),new e("ltä",26,-1),new e("stä",26,-1),new e("ttä",26,9)],P=[new e("eja",-1,-1),new e("mma",-1,1),new e("imma",1,-1),new e("mpa",-1,1),new e("impa",3,-1),new e("mmi",-1,1),new e("immi",5,-1),new e("mpi",-1,1),new e("impi",7,-1),new e("ejä",-1,-1),new e("mmä",-1,1),new e("immä",10,-1),new e("mpä",-1,1),new e("impä",12,-1)],F=[new e("i",-1,-1),new e("j",-1,-1)],S=[new e("mma",-1,1),new e("imma",0,-1)],y=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8],W=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],x=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],A=new r;this.setCurrent=function(i){A.setCurrent(i)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return i(),k=!1,A.limit_backward=e,A.cursor=A.limit,s(),A.cursor=A.limit,o(),A.cursor=A.limit,u(),A.cursor=A.limit,c(),A.cursor=A.limit,k?(m(),A.cursor=A.limit):(A.cursor=A.limit,w(),A.cursor=A.limit),_(),!0}};return function(i){return"function"==typeof i.update?i.update(function(i){return n.setCurrent(i),n.stem(),n.getCurrent()}):(n.setCurrent(i),n.stem(),n.getCurrent())}}(),i.Pipeline.registerFunction(i.fi.stemmer,"stemmer-fi"),i.fi.stopWordFilter=i.generateStopWordFilter("ei eivät emme en et ette että he heidän heidät heihin heille heillä heiltä heissä heistä heitä hän häneen hänelle hänellä häneltä hänen hänessä hänestä hänet häntä itse ja johon joiden joihin joiksi joilla joille joilta joina joissa joista joita joka joksi jolla jolle jolta jona jonka jos jossa josta jota jotka kanssa keiden keihin keiksi keille keillä keiltä keinä keissä keistä keitä keneen keneksi kenelle kenellä keneltä kenen kenenä kenessä kenestä kenet ketkä ketkä ketä koska kuin kuka kun me meidän meidät meihin meille meillä meiltä meissä meistä meitä mihin miksi mikä mille millä miltä minkä minkä minua minulla minulle minulta minun minussa minusta minut minuun minä minä missä mistä mitkä mitä mukaan mutta ne niiden niihin niiksi niille niillä niiltä niin niin niinä niissä niistä niitä noiden noihin noiksi noilla noille noilta noin noina noissa noista noita nuo nyt näiden näihin näiksi näille näillä näiltä näinä näissä näistä näitä nämä ole olemme olen olet olette oli olimme olin olisi olisimme olisin olisit olisitte olisivat olit olitte olivat olla olleet ollut on ovat poikki se sekä sen siihen siinä siitä siksi sille sillä sillä siltä sinua sinulla sinulle sinulta sinun sinussa sinusta sinut sinuun sinä sinä sitä tai te teidän teidät teihin teille teillä teiltä teissä teistä teitä tuo tuohon tuoksi tuolla tuolle tuolta tuon tuona tuossa tuosta tuota tähän täksi tälle tällä tältä tämä tämän tänä tässä tästä tätä vaan vai vaikka yli".split(" ")),i.Pipeline.registerFunction(i.fi.stopWordFilter,"stopWordFilter-fi")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.fr.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.fr.min.js new file mode 100644 index 0000000000..68cd0094ae --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.fr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `French` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.fr=function(){this.pipeline.reset(),this.pipeline.add(e.fr.trimmer,e.fr.stopWordFilter,e.fr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.fr.stemmer))},e.fr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.fr.trimmer=e.trimmerSupport.generateTrimmer(e.fr.wordCharacters),e.Pipeline.registerFunction(e.fr.trimmer,"trimmer-fr"),e.fr.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,s){return!(!W.eq_s(1,e)||(W.ket=W.cursor,!W.in_grouping(F,97,251)))&&(W.slice_from(r),W.cursor=s,!0)}function i(e,r,s){return!!W.eq_s(1,e)&&(W.ket=W.cursor,W.slice_from(r),W.cursor=s,!0)}function n(){for(var r,s;;){if(r=W.cursor,W.in_grouping(F,97,251)){if(W.bra=W.cursor,s=W.cursor,e("u","U",r))continue;if(W.cursor=s,e("i","I",r))continue;if(W.cursor=s,i("y","Y",r))continue}if(W.cursor=r,W.bra=r,!e("y","Y",r)){if(W.cursor=r,W.eq_s(1,"q")&&(W.bra=W.cursor,i("u","U",r)))continue;if(W.cursor=r,r>=W.limit)return;W.cursor++}}}function t(){for(;!W.in_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}for(;!W.out_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}return!1}function u(){var e=W.cursor;if(q=W.limit,g=q,p=q,W.in_grouping(F,97,251)&&W.in_grouping(F,97,251)&&W.cursor=W.limit){W.cursor=q;break}W.cursor++}while(!W.in_grouping(F,97,251))}q=W.cursor,W.cursor=e,t()||(g=W.cursor,t()||(p=W.cursor))}function o(){for(var e,r;;){if(r=W.cursor,W.bra=r,!(e=W.find_among(h,4)))break;switch(W.ket=W.cursor,e){case 1:W.slice_from("i");break;case 2:W.slice_from("u");break;case 3:W.slice_from("y");break;case 4:if(W.cursor>=W.limit)return;W.cursor++}}}function c(){return q<=W.cursor}function a(){return g<=W.cursor}function l(){return p<=W.cursor}function w(){var e,r;if(W.ket=W.cursor,e=W.find_among_b(C,43)){switch(W.bra=W.cursor,e){case 1:if(!l())return!1;W.slice_del();break;case 2:if(!l())return!1;W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")&&(W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU"));break;case 3:if(!l())return!1;W.slice_from("log");break;case 4:if(!l())return!1;W.slice_from("u");break;case 5:if(!l())return!1;W.slice_from("ent");break;case 6:if(!c())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(z,6))switch(W.bra=W.cursor,e){case 1:l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&W.slice_del()));break;case 2:l()?W.slice_del():a()&&W.slice_from("eux");break;case 3:l()&&W.slice_del();break;case 4:c()&&W.slice_from("i")}break;case 7:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(y,3))switch(W.bra=W.cursor,e){case 1:l()?W.slice_del():W.slice_from("abl");break;case 2:l()?W.slice_del():W.slice_from("iqU");break;case 3:l()&&W.slice_del()}break;case 8:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")))){W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU");break}break;case 9:W.slice_from("eau");break;case 10:if(!a())return!1;W.slice_from("al");break;case 11:if(l())W.slice_del();else{if(!a())return!1;W.slice_from("eux")}break;case 12:if(!a()||!W.out_grouping_b(F,97,251))return!1;W.slice_del();break;case 13:return c()&&W.slice_from("ant"),!1;case 14:return c()&&W.slice_from("ent"),!1;case 15:return r=W.limit-W.cursor,W.in_grouping_b(F,97,251)&&c()&&(W.cursor=W.limit-r,W.slice_del()),!1}return!0}return!1}function f(){var e,r;if(W.cursor=q){if(s=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,e=W.find_among_b(P,7))switch(W.bra=W.cursor,e){case 1:if(l()){if(i=W.limit-W.cursor,!W.eq_s_b(1,"s")&&(W.cursor=W.limit-i,!W.eq_s_b(1,"t")))break;W.slice_del()}break;case 2:W.slice_from("i");break;case 3:W.slice_del();break;case 4:W.eq_s_b(2,"gu")&&W.slice_del()}W.limit_backward=s}}function b(){var e=W.limit-W.cursor;W.find_among_b(U,5)&&(W.cursor=W.limit-e,W.ket=W.cursor,W.cursor>W.limit_backward&&(W.cursor--,W.bra=W.cursor,W.slice_del()))}function d(){for(var e,r=1;W.out_grouping_b(F,97,251);)r--;if(r<=0){if(W.ket=W.cursor,e=W.limit-W.cursor,!W.eq_s_b(1,"é")&&(W.cursor=W.limit-e,!W.eq_s_b(1,"è")))return;W.bra=W.cursor,W.slice_from("e")}}function k(){if(!w()&&(W.cursor=W.limit,!f()&&(W.cursor=W.limit,!m())))return W.cursor=W.limit,void _();W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"Y")?(W.bra=W.cursor,W.slice_from("i")):(W.cursor=W.limit,W.eq_s_b(1,"ç")&&(W.bra=W.cursor,W.slice_from("c")))}var p,g,q,v=[new r("col",-1,-1),new r("par",-1,-1),new r("tap",-1,-1)],h=[new r("",-1,4),new r("I",0,1),new r("U",0,2),new r("Y",0,3)],z=[new r("iqU",-1,3),new r("abl",-1,3),new r("Ièr",-1,4),new r("ièr",-1,4),new r("eus",-1,2),new r("iv",-1,1)],y=[new r("ic",-1,2),new r("abil",-1,1),new r("iv",-1,3)],C=[new r("iqUe",-1,1),new r("atrice",-1,2),new r("ance",-1,1),new r("ence",-1,5),new r("logie",-1,3),new r("able",-1,1),new r("isme",-1,1),new r("euse",-1,11),new r("iste",-1,1),new r("ive",-1,8),new r("if",-1,8),new r("usion",-1,4),new r("ation",-1,2),new r("ution",-1,4),new r("ateur",-1,2),new r("iqUes",-1,1),new r("atrices",-1,2),new r("ances",-1,1),new r("ences",-1,5),new r("logies",-1,3),new r("ables",-1,1),new r("ismes",-1,1),new r("euses",-1,11),new r("istes",-1,1),new r("ives",-1,8),new r("ifs",-1,8),new r("usions",-1,4),new r("ations",-1,2),new r("utions",-1,4),new r("ateurs",-1,2),new r("ments",-1,15),new r("ements",30,6),new r("issements",31,12),new r("ités",-1,7),new r("ment",-1,15),new r("ement",34,6),new r("issement",35,12),new r("amment",34,13),new r("emment",34,14),new r("aux",-1,10),new r("eaux",39,9),new r("eux",-1,1),new r("ité",-1,7)],x=[new r("ira",-1,1),new r("ie",-1,1),new r("isse",-1,1),new r("issante",-1,1),new r("i",-1,1),new r("irai",4,1),new r("ir",-1,1),new r("iras",-1,1),new r("ies",-1,1),new r("îmes",-1,1),new r("isses",-1,1),new r("issantes",-1,1),new r("îtes",-1,1),new r("is",-1,1),new r("irais",13,1),new r("issais",13,1),new r("irions",-1,1),new r("issions",-1,1),new r("irons",-1,1),new r("issons",-1,1),new r("issants",-1,1),new r("it",-1,1),new r("irait",21,1),new r("issait",21,1),new r("issant",-1,1),new r("iraIent",-1,1),new r("issaIent",-1,1),new r("irent",-1,1),new r("issent",-1,1),new r("iront",-1,1),new r("ît",-1,1),new r("iriez",-1,1),new r("issiez",-1,1),new r("irez",-1,1),new r("issez",-1,1)],I=[new r("a",-1,3),new r("era",0,2),new r("asse",-1,3),new r("ante",-1,3),new r("ée",-1,2),new r("ai",-1,3),new r("erai",5,2),new r("er",-1,2),new r("as",-1,3),new r("eras",8,2),new r("âmes",-1,3),new r("asses",-1,3),new r("antes",-1,3),new r("âtes",-1,3),new r("ées",-1,2),new r("ais",-1,3),new r("erais",15,2),new r("ions",-1,1),new r("erions",17,2),new r("assions",17,3),new r("erons",-1,2),new r("ants",-1,3),new r("és",-1,2),new r("ait",-1,3),new r("erait",23,2),new r("ant",-1,3),new r("aIent",-1,3),new r("eraIent",26,2),new r("èrent",-1,2),new r("assent",-1,3),new r("eront",-1,2),new r("ât",-1,3),new r("ez",-1,2),new r("iez",32,2),new r("eriez",33,2),new r("assiez",33,3),new r("erez",32,2),new r("é",-1,2)],P=[new r("e",-1,3),new r("Ière",0,2),new r("ière",0,2),new r("ion",-1,1),new r("Ier",-1,2),new r("ier",-1,2),new r("ë",-1,4)],U=[new r("ell",-1,-1),new r("eill",-1,-1),new r("enn",-1,-1),new r("onn",-1,-1),new r("ett",-1,-1)],F=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],S=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],W=new s;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){var e=W.cursor;return n(),W.cursor=e,u(),W.limit_backward=e,W.cursor=W.limit,k(),W.cursor=W.limit,b(),W.cursor=W.limit,d(),W.cursor=W.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.fr.stemmer,"stemmer-fr"),e.fr.stopWordFilter=e.generateStopWordFilter("ai aie aient aies ait as au aura aurai auraient aurais aurait auras aurez auriez aurions aurons auront aux avaient avais avait avec avez aviez avions avons ayant ayez ayons c ce ceci celà ces cet cette d dans de des du elle en es est et eu eue eues eurent eus eusse eussent eusses eussiez eussions eut eux eûmes eût eûtes furent fus fusse fussent fusses fussiez fussions fut fûmes fût fûtes ici il ils j je l la le les leur leurs lui m ma mais me mes moi mon même n ne nos notre nous on ont ou par pas pour qu que quel quelle quelles quels qui s sa sans se sera serai seraient serais serait seras serez seriez serions serons seront ses soi soient sois soit sommes son sont soyez soyons suis sur t ta te tes toi ton tu un une vos votre vous y à étaient étais était étant étiez étions été étée étées étés êtes".split(" ")),e.Pipeline.registerFunction(e.fr.stopWordFilter,"stopWordFilter-fr")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.hi.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.hi.min.js new file mode 100644 index 0000000000..7dbc41402c --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.hi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hi=function(){this.pipeline.reset(),this.pipeline.add(e.hi.trimmer,e.hi.stopWordFilter,e.hi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hi.stemmer))},e.hi.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.hi.trimmer=e.trimmerSupport.generateTrimmer(e.hi.wordCharacters),e.Pipeline.registerFunction(e.hi.trimmer,"trimmer-hi"),e.hi.stopWordFilter=e.generateStopWordFilter("अत अपना अपनी अपने अभी अंदर आदि आप इत्यादि इन इनका इन्हीं इन्हें इन्हों इस इसका इसकी इसके इसमें इसी इसे उन उनका उनकी उनके उनको उन्हीं उन्हें उन्हों उस उसके उसी उसे एक एवं एस ऐसे और कई कर करता करते करना करने करें कहते कहा का काफ़ी कि कितना किन्हें किन्हों किया किर किस किसी किसे की कुछ कुल के को कोई कौन कौनसा गया घर जब जहाँ जा जितना जिन जिन्हें जिन्हों जिस जिसे जीधर जैसा जैसे जो तक तब तरह तिन तिन्हें तिन्हों तिस तिसे तो था थी थे दबारा दिया दुसरा दूसरे दो द्वारा न नके नहीं ना निहायत नीचे ने पर पहले पूरा पे फिर बनी बही बहुत बाद बाला बिलकुल भी भीतर मगर मानो मे में यदि यह यहाँ यही या यिह ये रखें रहा रहे ऱ्वासा लिए लिये लेकिन व वग़ैरह वर्ग वह वहाँ वहीं वाले वुह वे वो सकता सकते सबसे सभी साथ साबुत साभ सारा से सो संग ही हुआ हुई हुए है हैं हो होता होती होते होना होने".split(" ")),e.hi.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.hi.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var t=i.toString().toLowerCase().replace(/^\s+/,"");return r.cut(t).split("|")},e.Pipeline.registerFunction(e.hi.stemmer,"stemmer-hi"),e.Pipeline.registerFunction(e.hi.stopWordFilter,"stopWordFilter-hi")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.hu.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.hu.min.js new file mode 100644 index 0000000000..ed9d909f73 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.hu.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Hungarian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hu=function(){this.pipeline.reset(),this.pipeline.add(e.hu.trimmer,e.hu.stopWordFilter,e.hu.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hu.stemmer))},e.hu.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.hu.trimmer=e.trimmerSupport.generateTrimmer(e.hu.wordCharacters),e.Pipeline.registerFunction(e.hu.trimmer,"trimmer-hu"),e.hu.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,n=L.cursor;if(d=L.limit,L.in_grouping(W,97,252))for(;;){if(e=L.cursor,L.out_grouping(W,97,252))return L.cursor=e,L.find_among(g,8)||(L.cursor=e,e=L.limit)return void(d=e);L.cursor++}if(L.cursor=n,L.out_grouping(W,97,252)){for(;!L.in_grouping(W,97,252);){if(L.cursor>=L.limit)return;L.cursor++}d=L.cursor}}function i(){return d<=L.cursor}function a(){var e;if(L.ket=L.cursor,(e=L.find_among_b(h,2))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e")}}function t(){var e=L.limit-L.cursor;return!!L.find_among_b(p,23)&&(L.cursor=L.limit-e,!0)}function s(){if(L.cursor>L.limit_backward){L.cursor--,L.ket=L.cursor;var e=L.cursor-1;L.limit_backward<=e&&e<=L.limit&&(L.cursor=e,L.bra=e,L.slice_del())}}function c(){var e;if(L.ket=L.cursor,(e=L.find_among_b(_,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function o(){L.ket=L.cursor,L.find_among_b(v,44)&&(L.bra=L.cursor,i()&&(L.slice_del(),a()))}function w(){var e;if(L.ket=L.cursor,(e=L.find_among_b(z,3))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("e");break;case 2:case 3:L.slice_from("a")}}function l(){var e;if(L.ket=L.cursor,(e=L.find_among_b(y,6))&&(L.bra=L.cursor,i()))switch(e){case 1:case 2:L.slice_del();break;case 3:L.slice_from("a");break;case 4:L.slice_from("e")}}function u(){var e;if(L.ket=L.cursor,(e=L.find_among_b(j,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function m(){var e;if(L.ket=L.cursor,(e=L.find_among_b(C,7))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e");break;case 3:case 4:case 5:case 6:case 7:L.slice_del()}}function k(){var e;if(L.ket=L.cursor,(e=L.find_among_b(P,12))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 9:L.slice_del();break;case 2:case 5:case 8:L.slice_from("e");break;case 3:case 6:L.slice_from("a")}}function f(){var e;if(L.ket=L.cursor,(e=L.find_among_b(F,31))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 8:case 9:case 12:case 13:case 16:case 17:case 18:L.slice_del();break;case 2:case 5:case 10:case 14:case 19:L.slice_from("a");break;case 3:case 6:case 11:case 15:case 20:L.slice_from("e")}}function b(){var e;if(L.ket=L.cursor,(e=L.find_among_b(S,42))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 5:case 6:case 9:case 10:case 11:case 14:case 15:case 16:case 17:case 20:case 21:case 24:case 25:case 26:case 29:L.slice_del();break;case 2:case 7:case 12:case 18:case 22:case 27:L.slice_from("a");break;case 3:case 8:case 13:case 19:case 23:case 28:L.slice_from("e")}}var d,g=[new n("cs",-1,-1),new n("dzs",-1,-1),new n("gy",-1,-1),new n("ly",-1,-1),new n("ny",-1,-1),new n("sz",-1,-1),new n("ty",-1,-1),new n("zs",-1,-1)],h=[new n("á",-1,1),new n("é",-1,2)],p=[new n("bb",-1,-1),new n("cc",-1,-1),new n("dd",-1,-1),new n("ff",-1,-1),new n("gg",-1,-1),new n("jj",-1,-1),new n("kk",-1,-1),new n("ll",-1,-1),new n("mm",-1,-1),new n("nn",-1,-1),new n("pp",-1,-1),new n("rr",-1,-1),new n("ccs",-1,-1),new n("ss",-1,-1),new n("zzs",-1,-1),new n("tt",-1,-1),new n("vv",-1,-1),new n("ggy",-1,-1),new n("lly",-1,-1),new n("nny",-1,-1),new n("tty",-1,-1),new n("ssz",-1,-1),new n("zz",-1,-1)],_=[new n("al",-1,1),new n("el",-1,2)],v=[new n("ba",-1,-1),new n("ra",-1,-1),new n("be",-1,-1),new n("re",-1,-1),new n("ig",-1,-1),new n("nak",-1,-1),new n("nek",-1,-1),new n("val",-1,-1),new n("vel",-1,-1),new n("ul",-1,-1),new n("nál",-1,-1),new n("nél",-1,-1),new n("ból",-1,-1),new n("ról",-1,-1),new n("tól",-1,-1),new n("bõl",-1,-1),new n("rõl",-1,-1),new n("tõl",-1,-1),new n("ül",-1,-1),new n("n",-1,-1),new n("an",19,-1),new n("ban",20,-1),new n("en",19,-1),new n("ben",22,-1),new n("képpen",22,-1),new n("on",19,-1),new n("ön",19,-1),new n("képp",-1,-1),new n("kor",-1,-1),new n("t",-1,-1),new n("at",29,-1),new n("et",29,-1),new n("ként",29,-1),new n("anként",32,-1),new n("enként",32,-1),new n("onként",32,-1),new n("ot",29,-1),new n("ért",29,-1),new n("öt",29,-1),new n("hez",-1,-1),new n("hoz",-1,-1),new n("höz",-1,-1),new n("vá",-1,-1),new n("vé",-1,-1)],z=[new n("án",-1,2),new n("én",-1,1),new n("ánként",-1,3)],y=[new n("stul",-1,2),new n("astul",0,1),new n("ástul",0,3),new n("stül",-1,2),new n("estül",3,1),new n("éstül",3,4)],j=[new n("á",-1,1),new n("é",-1,2)],C=[new n("k",-1,7),new n("ak",0,4),new n("ek",0,6),new n("ok",0,5),new n("ák",0,1),new n("ék",0,2),new n("ök",0,3)],P=[new n("éi",-1,7),new n("áéi",0,6),new n("ééi",0,5),new n("é",-1,9),new n("ké",3,4),new n("aké",4,1),new n("eké",4,1),new n("oké",4,1),new n("áké",4,3),new n("éké",4,2),new n("öké",4,1),new n("éé",3,8)],F=[new n("a",-1,18),new n("ja",0,17),new n("d",-1,16),new n("ad",2,13),new n("ed",2,13),new n("od",2,13),new n("ád",2,14),new n("éd",2,15),new n("öd",2,13),new n("e",-1,18),new n("je",9,17),new n("nk",-1,4),new n("unk",11,1),new n("ánk",11,2),new n("énk",11,3),new n("ünk",11,1),new n("uk",-1,8),new n("juk",16,7),new n("ájuk",17,5),new n("ük",-1,8),new n("jük",19,7),new n("éjük",20,6),new n("m",-1,12),new n("am",22,9),new n("em",22,9),new n("om",22,9),new n("ám",22,10),new n("ém",22,11),new n("o",-1,18),new n("á",-1,19),new n("é",-1,20)],S=[new n("id",-1,10),new n("aid",0,9),new n("jaid",1,6),new n("eid",0,9),new n("jeid",3,6),new n("áid",0,7),new n("éid",0,8),new n("i",-1,15),new n("ai",7,14),new n("jai",8,11),new n("ei",7,14),new n("jei",10,11),new n("ái",7,12),new n("éi",7,13),new n("itek",-1,24),new n("eitek",14,21),new n("jeitek",15,20),new n("éitek",14,23),new n("ik",-1,29),new n("aik",18,26),new n("jaik",19,25),new n("eik",18,26),new n("jeik",21,25),new n("áik",18,27),new n("éik",18,28),new n("ink",-1,20),new n("aink",25,17),new n("jaink",26,16),new n("eink",25,17),new n("jeink",28,16),new n("áink",25,18),new n("éink",25,19),new n("aitok",-1,21),new n("jaitok",32,20),new n("áitok",-1,22),new n("im",-1,5),new n("aim",35,4),new n("jaim",36,1),new n("eim",35,4),new n("jeim",38,1),new n("áim",35,2),new n("éim",35,3)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,52,14],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var n=L.cursor;return e(),L.limit_backward=n,L.cursor=L.limit,c(),L.cursor=L.limit,o(),L.cursor=L.limit,w(),L.cursor=L.limit,l(),L.cursor=L.limit,u(),L.cursor=L.limit,k(),L.cursor=L.limit,f(),L.cursor=L.limit,b(),L.cursor=L.limit,m(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.hu.stemmer,"stemmer-hu"),e.hu.stopWordFilter=e.generateStopWordFilter("a abban ahhoz ahogy ahol aki akik akkor alatt amely amelyek amelyekben amelyeket amelyet amelynek ami amikor amit amolyan amíg annak arra arról az azok azon azonban azt aztán azután azzal azért be belül benne bár cikk cikkek cikkeket csak de e ebben eddig egy egyes egyetlen egyik egyre egyéb egész ehhez ekkor el ellen elsõ elég elõ elõször elõtt emilyen ennek erre ez ezek ezen ezt ezzel ezért fel felé hanem hiszen hogy hogyan igen ill ill. illetve ilyen ilyenkor ismét ison itt jobban jó jól kell kellett keressünk keresztül ki kívül között közül legalább legyen lehet lehetett lenne lenni lesz lett maga magát majd majd meg mellett mely melyek mert mi mikor milyen minden mindenki mindent mindig mint mintha mit mivel miért most már más másik még míg nagy nagyobb nagyon ne nekem neki nem nincs néha néhány nélkül olyan ott pedig persze rá s saját sem semmi sok sokat sokkal szemben szerint szinte számára talán tehát teljes tovább továbbá több ugyanis utolsó után utána vagy vagyis vagyok valaki valami valamint való van vannak vele vissza viszont volna volt voltak voltam voltunk által általában át én éppen és így õ õk õket össze úgy új újabb újra".split(" ")),e.Pipeline.registerFunction(e.hu.stopWordFilter,"stopWordFilter-hu")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.it.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.it.min.js new file mode 100644 index 0000000000..344b6a3c0c --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.it.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Italian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.it=function(){this.pipeline.reset(),this.pipeline.add(e.it.trimmer,e.it.stopWordFilter,e.it.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.it.stemmer))},e.it.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.it.trimmer=e.trimmerSupport.generateTrimmer(e.it.wordCharacters),e.Pipeline.registerFunction(e.it.trimmer,"trimmer-it"),e.it.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!x.eq_s(1,e)||(x.ket=x.cursor,!x.in_grouping(L,97,249)))&&(x.slice_from(r),x.cursor=n,!0)}function i(){for(var r,n,i,o,t=x.cursor;;){if(x.bra=x.cursor,r=x.find_among(h,7))switch(x.ket=x.cursor,r){case 1:x.slice_from("à");continue;case 2:x.slice_from("è");continue;case 3:x.slice_from("ì");continue;case 4:x.slice_from("ò");continue;case 5:x.slice_from("ù");continue;case 6:x.slice_from("qU");continue;case 7:if(x.cursor>=x.limit)break;x.cursor++;continue}break}for(x.cursor=t;;)for(n=x.cursor;;){if(i=x.cursor,x.in_grouping(L,97,249)){if(x.bra=x.cursor,o=x.cursor,e("u","U",i))break;if(x.cursor=o,e("i","I",i))break}if(x.cursor=i,x.cursor>=x.limit)return void(x.cursor=n);x.cursor++}}function o(e){if(x.cursor=e,!x.in_grouping(L,97,249))return!1;for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function t(){if(x.in_grouping(L,97,249)){var e=x.cursor;if(x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return o(e);x.cursor++}return!0}return o(e)}return!1}function s(){var e,r=x.cursor;if(!t()){if(x.cursor=r,!x.out_grouping(L,97,249))return;if(e=x.cursor,x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return x.cursor=e,void(x.in_grouping(L,97,249)&&x.cursor=x.limit)return;x.cursor++}k=x.cursor}function a(){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function u(){var e=x.cursor;k=x.limit,p=k,g=k,s(),x.cursor=e,a()&&(p=x.cursor,a()&&(g=x.cursor))}function c(){for(var e;;){if(x.bra=x.cursor,!(e=x.find_among(q,3)))break;switch(x.ket=x.cursor,e){case 1:x.slice_from("i");break;case 2:x.slice_from("u");break;case 3:if(x.cursor>=x.limit)return;x.cursor++}}}function w(){return k<=x.cursor}function l(){return p<=x.cursor}function m(){return g<=x.cursor}function f(){var e;if(x.ket=x.cursor,x.find_among_b(C,37)&&(x.bra=x.cursor,(e=x.find_among_b(z,5))&&w()))switch(e){case 1:x.slice_del();break;case 2:x.slice_from("e")}}function v(){var e;if(x.ket=x.cursor,!(e=x.find_among_b(S,51)))return!1;switch(x.bra=x.cursor,e){case 1:if(!m())return!1;x.slice_del();break;case 2:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del());break;case 3:if(!m())return!1;x.slice_from("log");break;case 4:if(!m())return!1;x.slice_from("u");break;case 5:if(!m())return!1;x.slice_from("ente");break;case 6:if(!w())return!1;x.slice_del();break;case 7:if(!l())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(P,4),e&&(x.bra=x.cursor,m()&&(x.slice_del(),1==e&&(x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&x.slice_del()))));break;case 8:if(!m())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(F,3),e&&(x.bra=x.cursor,1==e&&m()&&x.slice_del());break;case 9:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del())))}return!0}function b(){var e,r;x.cursor>=k&&(r=x.limit_backward,x.limit_backward=k,x.ket=x.cursor,e=x.find_among_b(W,87),e&&(x.bra=x.cursor,1==e&&x.slice_del()),x.limit_backward=r)}function d(){var e=x.limit-x.cursor;if(x.ket=x.cursor,x.in_grouping_b(y,97,242)&&(x.bra=x.cursor,w()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(1,"i")&&(x.bra=x.cursor,w()))))return void x.slice_del();x.cursor=x.limit-e}function _(){d(),x.ket=x.cursor,x.eq_s_b(1,"h")&&(x.bra=x.cursor,x.in_grouping_b(U,99,103)&&w()&&x.slice_del())}var g,p,k,h=[new r("",-1,7),new r("qu",0,6),new r("á",0,1),new r("é",0,2),new r("í",0,3),new r("ó",0,4),new r("ú",0,5)],q=[new r("",-1,3),new r("I",0,1),new r("U",0,2)],C=[new r("la",-1,-1),new r("cela",0,-1),new r("gliela",0,-1),new r("mela",0,-1),new r("tela",0,-1),new r("vela",0,-1),new r("le",-1,-1),new r("cele",6,-1),new r("gliele",6,-1),new r("mele",6,-1),new r("tele",6,-1),new r("vele",6,-1),new r("ne",-1,-1),new r("cene",12,-1),new r("gliene",12,-1),new r("mene",12,-1),new r("sene",12,-1),new r("tene",12,-1),new r("vene",12,-1),new r("ci",-1,-1),new r("li",-1,-1),new r("celi",20,-1),new r("glieli",20,-1),new r("meli",20,-1),new r("teli",20,-1),new r("veli",20,-1),new r("gli",20,-1),new r("mi",-1,-1),new r("si",-1,-1),new r("ti",-1,-1),new r("vi",-1,-1),new r("lo",-1,-1),new r("celo",31,-1),new r("glielo",31,-1),new r("melo",31,-1),new r("telo",31,-1),new r("velo",31,-1)],z=[new r("ando",-1,1),new r("endo",-1,1),new r("ar",-1,2),new r("er",-1,2),new r("ir",-1,2)],P=[new r("ic",-1,-1),new r("abil",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],F=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],S=[new r("ica",-1,1),new r("logia",-1,3),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,9),new r("anza",-1,1),new r("enza",-1,5),new r("ice",-1,1),new r("atrice",7,1),new r("iche",-1,1),new r("logie",-1,3),new r("abile",-1,1),new r("ibile",-1,1),new r("usione",-1,4),new r("azione",-1,2),new r("uzione",-1,4),new r("atore",-1,2),new r("ose",-1,1),new r("ante",-1,1),new r("mente",-1,1),new r("amente",19,7),new r("iste",-1,1),new r("ive",-1,9),new r("anze",-1,1),new r("enze",-1,5),new r("ici",-1,1),new r("atrici",25,1),new r("ichi",-1,1),new r("abili",-1,1),new r("ibili",-1,1),new r("ismi",-1,1),new r("usioni",-1,4),new r("azioni",-1,2),new r("uzioni",-1,4),new r("atori",-1,2),new r("osi",-1,1),new r("anti",-1,1),new r("amenti",-1,6),new r("imenti",-1,6),new r("isti",-1,1),new r("ivi",-1,9),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,6),new r("imento",-1,6),new r("ivo",-1,9),new r("ità",-1,8),new r("istà",-1,1),new r("istè",-1,1),new r("istì",-1,1)],W=[new r("isca",-1,1),new r("enda",-1,1),new r("ata",-1,1),new r("ita",-1,1),new r("uta",-1,1),new r("ava",-1,1),new r("eva",-1,1),new r("iva",-1,1),new r("erebbe",-1,1),new r("irebbe",-1,1),new r("isce",-1,1),new r("ende",-1,1),new r("are",-1,1),new r("ere",-1,1),new r("ire",-1,1),new r("asse",-1,1),new r("ate",-1,1),new r("avate",16,1),new r("evate",16,1),new r("ivate",16,1),new r("ete",-1,1),new r("erete",20,1),new r("irete",20,1),new r("ite",-1,1),new r("ereste",-1,1),new r("ireste",-1,1),new r("ute",-1,1),new r("erai",-1,1),new r("irai",-1,1),new r("isci",-1,1),new r("endi",-1,1),new r("erei",-1,1),new r("irei",-1,1),new r("assi",-1,1),new r("ati",-1,1),new r("iti",-1,1),new r("eresti",-1,1),new r("iresti",-1,1),new r("uti",-1,1),new r("avi",-1,1),new r("evi",-1,1),new r("ivi",-1,1),new r("isco",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("Yamo",-1,1),new r("iamo",-1,1),new r("avamo",-1,1),new r("evamo",-1,1),new r("ivamo",-1,1),new r("eremo",-1,1),new r("iremo",-1,1),new r("assimo",-1,1),new r("ammo",-1,1),new r("emmo",-1,1),new r("eremmo",54,1),new r("iremmo",54,1),new r("immo",-1,1),new r("ano",-1,1),new r("iscano",58,1),new r("avano",58,1),new r("evano",58,1),new r("ivano",58,1),new r("eranno",-1,1),new r("iranno",-1,1),new r("ono",-1,1),new r("iscono",65,1),new r("arono",65,1),new r("erono",65,1),new r("irono",65,1),new r("erebbero",-1,1),new r("irebbero",-1,1),new r("assero",-1,1),new r("essero",-1,1),new r("issero",-1,1),new r("ato",-1,1),new r("ito",-1,1),new r("uto",-1,1),new r("avo",-1,1),new r("evo",-1,1),new r("ivo",-1,1),new r("ar",-1,1),new r("ir",-1,1),new r("erà",-1,1),new r("irà",-1,1),new r("erò",-1,1),new r("irò",-1,1)],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1],y=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2],U=[17],x=new n;this.setCurrent=function(e){x.setCurrent(e)},this.getCurrent=function(){return x.getCurrent()},this.stem=function(){var e=x.cursor;return i(),x.cursor=e,u(),x.limit_backward=e,x.cursor=x.limit,f(),x.cursor=x.limit,v()||(x.cursor=x.limit,b()),x.cursor=x.limit,_(),x.cursor=x.limit_backward,c(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.it.stemmer,"stemmer-it"),e.it.stopWordFilter=e.generateStopWordFilter("a abbia abbiamo abbiano abbiate ad agl agli ai al all alla alle allo anche avemmo avendo avesse avessero avessi avessimo aveste avesti avete aveva avevamo avevano avevate avevi avevo avrai avranno avrebbe avrebbero avrei avremmo avremo avreste avresti avrete avrà avrò avuta avute avuti avuto c che chi ci coi col come con contro cui da dagl dagli dai dal dall dalla dalle dallo degl degli dei del dell della delle dello di dov dove e ebbe ebbero ebbi ed era erano eravamo eravate eri ero essendo faccia facciamo facciano facciate faccio facemmo facendo facesse facessero facessi facessimo faceste facesti faceva facevamo facevano facevate facevi facevo fai fanno farai faranno farebbe farebbero farei faremmo faremo fareste faresti farete farà farò fece fecero feci fosse fossero fossi fossimo foste fosti fu fui fummo furono gli ha hai hanno ho i il in io l la le lei li lo loro lui ma mi mia mie miei mio ne negl negli nei nel nell nella nelle nello noi non nostra nostre nostri nostro o per perché più quale quanta quante quanti quanto quella quelle quelli quello questa queste questi questo sarai saranno sarebbe sarebbero sarei saremmo saremo sareste saresti sarete sarà sarò se sei si sia siamo siano siate siete sono sta stai stando stanno starai staranno starebbe starebbero starei staremmo staremo stareste staresti starete starà starò stava stavamo stavano stavate stavi stavo stemmo stesse stessero stessi stessimo steste stesti stette stettero stetti stia stiamo stiano stiate sto su sua sue sugl sugli sui sul sull sulla sulle sullo suo suoi ti tra tu tua tue tuo tuoi tutti tutto un una uno vi voi vostra vostre vostri vostro è".split(" ")),e.Pipeline.registerFunction(e.it.stopWordFilter,"stopWordFilter-it")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.ja.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.ja.min.js new file mode 100644 index 0000000000..5f254ebe91 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.ja.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.ja=function(){this.pipeline.reset(),this.pipeline.add(e.ja.trimmer,e.ja.stopWordFilter,e.ja.stemmer),r?this.tokenizer=e.ja.tokenizer:(e.tokenizer&&(e.tokenizer=e.ja.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.ja.tokenizer))};var t=new e.TinySegmenter;e.ja.tokenizer=function(i){var n,o,s,p,a,u,m,l,c,f;if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t.toLowerCase()):t.toLowerCase()});for(o=i.toString().toLowerCase().replace(/^\s+/,""),n=o.length-1;n>=0;n--)if(/\S/.test(o.charAt(n))){o=o.substring(0,n+1);break}for(a=[],s=o.length,c=0,l=0;c<=s;c++)if(u=o.charAt(c),m=c-l,u.match(/\s/)||c==s){if(m>0)for(p=t.segment(o.slice(l,c)).filter(function(e){return!!e}),f=l,n=0;n=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(e=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=e);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=e;else if(n(e))break}else if(n(e))break}function n(r){return C.cursor=r,r>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,d=_,t()||(_=C.cursor,_<3&&(_=3),t()||(d=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var r;;)if(C.bra=C.cursor,r=C.find_among(p,3))switch(C.ket=C.cursor,r){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return d<=C.cursor}function a(){var r=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-r,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var r;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.slice_del(),w=!0,a())))}function m(){var r;u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.eq_s_b(3,"gem")||(C.cursor=C.limit-r,C.slice_del(),a())))}function f(){var r,e,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,r=C.find_among_b(h,5))switch(C.bra=C.cursor,r){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(j,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(e=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-e,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,r=C.find_among_b(k,6))switch(C.bra=C.cursor,r){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(z,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var d,_,w,b=[new e("",-1,6),new e("á",0,1),new e("ä",0,1),new e("é",0,2),new e("ë",0,2),new e("í",0,3),new e("ï",0,3),new e("ó",0,4),new e("ö",0,4),new e("ú",0,5),new e("ü",0,5)],p=[new e("",-1,3),new e("I",0,2),new e("Y",0,1)],g=[new e("dd",-1,-1),new e("kk",-1,-1),new e("tt",-1,-1)],h=[new e("ene",-1,2),new e("se",-1,3),new e("en",-1,2),new e("heden",2,1),new e("s",-1,3)],k=[new e("end",-1,1),new e("ig",-1,2),new e("ing",-1,1),new e("lijk",-1,3),new e("baar",-1,4),new e("bar",-1,5)],v=[new e("aa",-1,-1),new e("ee",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(r){C.setCurrent(r)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var e=C.cursor;return r(),C.cursor=e,o(),C.limit_backward=e,C.cursor=C.limit,f(),C.cursor=C.limit_backward,s(),!0}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.nl.stemmer,"stemmer-nl"),r.nl.stopWordFilter=r.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),r.Pipeline.registerFunction(r.nl.stopWordFilter,"stopWordFilter-nl")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.no.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.no.min.js new file mode 100644 index 0000000000..92bc7e4e89 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.no.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Norwegian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.no=function(){this.pipeline.reset(),this.pipeline.add(e.no.trimmer,e.no.stopWordFilter,e.no.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.no.stemmer))},e.no.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.no.trimmer=e.trimmerSupport.generateTrimmer(e.no.wordCharacters),e.Pipeline.registerFunction(e.no.trimmer,"trimmer-no"),e.no.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,r=w.cursor+3;if(a=w.limit,0<=r||r<=w.limit){for(s=r;;){if(e=w.cursor,w.in_grouping(d,97,248)){w.cursor=e;break}if(e>=w.limit)return;w.cursor=e+1}for(;!w.out_grouping(d,97,248);){if(w.cursor>=w.limit)return;w.cursor++}a=w.cursor,a=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(m,29),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:n=w.limit-w.cursor,w.in_grouping_b(c,98,122)?w.slice_del():(w.cursor=w.limit-n,w.eq_s_b(1,"k")&&w.out_grouping_b(d,97,248)&&w.slice_del());break;case 3:w.slice_from("er")}}function t(){var e,r=w.limit-w.cursor;w.cursor>=a&&(e=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,w.find_among_b(u,2)?(w.bra=w.cursor,w.limit_backward=e,w.cursor=w.limit-r,w.cursor>w.limit_backward&&(w.cursor--,w.bra=w.cursor,w.slice_del())):w.limit_backward=e)}function o(){var e,r;w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(l,11),e?(w.bra=w.cursor,w.limit_backward=r,1==e&&w.slice_del()):w.limit_backward=r)}var s,a,m=[new r("a",-1,1),new r("e",-1,1),new r("ede",1,1),new r("ande",1,1),new r("ende",1,1),new r("ane",1,1),new r("ene",1,1),new r("hetene",6,1),new r("erte",1,3),new r("en",-1,1),new r("heten",9,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",12,1),new r("s",-1,2),new r("as",14,1),new r("es",14,1),new r("edes",16,1),new r("endes",16,1),new r("enes",16,1),new r("hetenes",19,1),new r("ens",14,1),new r("hetens",21,1),new r("ers",14,1),new r("ets",14,1),new r("et",-1,1),new r("het",25,1),new r("ert",-1,3),new r("ast",-1,1)],u=[new r("dt",-1,-1),new r("vt",-1,-1)],l=[new r("leg",-1,1),new r("eleg",0,1),new r("ig",-1,1),new r("eig",2,1),new r("lig",2,1),new r("elig",4,1),new r("els",-1,1),new r("lov",-1,1),new r("elov",7,1),new r("slov",7,1),new r("hetslov",9,1)],d=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],c=[119,125,149,1],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,i(),w.cursor=w.limit,t(),w.cursor=w.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.no.stemmer,"stemmer-no"),e.no.stopWordFilter=e.generateStopWordFilter("alle at av bare begge ble blei bli blir blitt både båe da de deg dei deim deira deires dem den denne der dere deres det dette di din disse ditt du dykk dykkar då eg ein eit eitt eller elles en enn er et ett etter for fordi fra før ha hadde han hans har hennar henne hennes her hjå ho hoe honom hoss hossen hun hva hvem hver hvilke hvilken hvis hvor hvordan hvorfor i ikke ikkje ikkje ingen ingi inkje inn inni ja jeg kan kom korleis korso kun kunne kva kvar kvarhelst kven kvi kvifor man mange me med medan meg meget mellom men mi min mine mitt mot mykje ned no noe noen noka noko nokon nokor nokre nå når og også om opp oss over på samme seg selv si si sia sidan siden sin sine sitt sjøl skal skulle slik so som som somme somt så sånn til um upp ut uten var vart varte ved vere verte vi vil ville vore vors vort vår være være vært å".split(" ")),e.Pipeline.registerFunction(e.no.stopWordFilter,"stopWordFilter-no")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.pt.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.pt.min.js new file mode 100644 index 0000000000..6c16996d65 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.pt.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Portuguese` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.pt=function(){this.pipeline.reset(),this.pipeline.add(e.pt.trimmer,e.pt.stopWordFilter,e.pt.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.pt.stemmer))},e.pt.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.pt.trimmer=e.trimmerSupport.generateTrimmer(e.pt.wordCharacters),e.Pipeline.registerFunction(e.pt.trimmer,"trimmer-pt"),e.pt.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(k,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("a~");continue;case 2:z.slice_from("o~");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function n(){if(z.out_grouping(y,97,250)){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!0;z.cursor++}return!1}return!0}function i(){if(z.in_grouping(y,97,250))for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return g=z.cursor,!0}function o(){var e,r,s=z.cursor;if(z.in_grouping(y,97,250))if(e=z.cursor,n()){if(z.cursor=e,i())return}else g=z.cursor;if(z.cursor=s,z.out_grouping(y,97,250)){if(r=z.cursor,n()){if(z.cursor=r,!z.in_grouping(y,97,250)||z.cursor>=z.limit)return;z.cursor++}g=z.cursor}}function t(){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return!0}function a(){var e=z.cursor;g=z.limit,b=g,h=g,o(),z.cursor=e,t()&&(b=z.cursor,t()&&(h=z.cursor))}function u(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(q,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("ã");continue;case 2:z.slice_from("õ");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function w(){return g<=z.cursor}function m(){return b<=z.cursor}function c(){return h<=z.cursor}function l(){var e;if(z.ket=z.cursor,!(e=z.find_among_b(F,45)))return!1;switch(z.bra=z.cursor,e){case 1:if(!c())return!1;z.slice_del();break;case 2:if(!c())return!1;z.slice_from("log");break;case 3:if(!c())return!1;z.slice_from("u");break;case 4:if(!c())return!1;z.slice_from("ente");break;case 5:if(!m())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(j,4),e&&(z.bra=z.cursor,c()&&(z.slice_del(),1==e&&(z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del()))));break;case 6:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(C,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 7:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(P,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 8:if(!c())return!1;z.slice_del(),z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del());break;case 9:if(!w()||!z.eq_s_b(1,"e"))return!1;z.slice_from("ir")}return!0}function f(){var e,r;if(z.cursor>=g){if(r=z.limit_backward,z.limit_backward=g,z.ket=z.cursor,e=z.find_among_b(S,120))return z.bra=z.cursor,1==e&&z.slice_del(),z.limit_backward=r,!0;z.limit_backward=r}return!1}function d(){var e;z.ket=z.cursor,(e=z.find_among_b(W,7))&&(z.bra=z.cursor,1==e&&w()&&z.slice_del())}function v(e,r){if(z.eq_s_b(1,e)){z.bra=z.cursor;var s=z.limit-z.cursor;if(z.eq_s_b(1,r))return z.cursor=z.limit-s,w()&&z.slice_del(),!1}return!0}function p(){var e;if(z.ket=z.cursor,e=z.find_among_b(L,4))switch(z.bra=z.cursor,e){case 1:w()&&(z.slice_del(),z.ket=z.cursor,z.limit-z.cursor,v("u","g")&&v("i","c"));break;case 2:z.slice_from("c")}}function _(){if(!l()&&(z.cursor=z.limit,!f()))return z.cursor=z.limit,void d();z.cursor=z.limit,z.ket=z.cursor,z.eq_s_b(1,"i")&&(z.bra=z.cursor,z.eq_s_b(1,"c")&&(z.cursor=z.limit,w()&&z.slice_del()))}var h,b,g,k=[new r("",-1,3),new r("ã",0,1),new r("õ",0,2)],q=[new r("",-1,3),new r("a~",0,1),new r("o~",0,2)],j=[new r("ic",-1,-1),new r("ad",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],C=[new r("ante",-1,1),new r("avel",-1,1),new r("ível",-1,1)],P=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],F=[new r("ica",-1,1),new r("ância",-1,1),new r("ência",-1,4),new r("ira",-1,9),new r("adora",-1,1),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,8),new r("eza",-1,1),new r("logía",-1,2),new r("idade",-1,7),new r("ante",-1,1),new r("mente",-1,6),new r("amente",12,5),new r("ável",-1,1),new r("ível",-1,1),new r("ución",-1,3),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,1),new r("imento",-1,1),new r("ivo",-1,8),new r("aça~o",-1,1),new r("ador",-1,1),new r("icas",-1,1),new r("ências",-1,4),new r("iras",-1,9),new r("adoras",-1,1),new r("osas",-1,1),new r("istas",-1,1),new r("ivas",-1,8),new r("ezas",-1,1),new r("logías",-1,2),new r("idades",-1,7),new r("uciones",-1,3),new r("adores",-1,1),new r("antes",-1,1),new r("aço~es",-1,1),new r("icos",-1,1),new r("ismos",-1,1),new r("osos",-1,1),new r("amentos",-1,1),new r("imentos",-1,1),new r("ivos",-1,8)],S=[new r("ada",-1,1),new r("ida",-1,1),new r("ia",-1,1),new r("aria",2,1),new r("eria",2,1),new r("iria",2,1),new r("ara",-1,1),new r("era",-1,1),new r("ira",-1,1),new r("ava",-1,1),new r("asse",-1,1),new r("esse",-1,1),new r("isse",-1,1),new r("aste",-1,1),new r("este",-1,1),new r("iste",-1,1),new r("ei",-1,1),new r("arei",16,1),new r("erei",16,1),new r("irei",16,1),new r("am",-1,1),new r("iam",20,1),new r("ariam",21,1),new r("eriam",21,1),new r("iriam",21,1),new r("aram",20,1),new r("eram",20,1),new r("iram",20,1),new r("avam",20,1),new r("em",-1,1),new r("arem",29,1),new r("erem",29,1),new r("irem",29,1),new r("assem",29,1),new r("essem",29,1),new r("issem",29,1),new r("ado",-1,1),new r("ido",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("indo",-1,1),new r("ara~o",-1,1),new r("era~o",-1,1),new r("ira~o",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("ir",-1,1),new r("as",-1,1),new r("adas",47,1),new r("idas",47,1),new r("ias",47,1),new r("arias",50,1),new r("erias",50,1),new r("irias",50,1),new r("aras",47,1),new r("eras",47,1),new r("iras",47,1),new r("avas",47,1),new r("es",-1,1),new r("ardes",58,1),new r("erdes",58,1),new r("irdes",58,1),new r("ares",58,1),new r("eres",58,1),new r("ires",58,1),new r("asses",58,1),new r("esses",58,1),new r("isses",58,1),new r("astes",58,1),new r("estes",58,1),new r("istes",58,1),new r("is",-1,1),new r("ais",71,1),new r("eis",71,1),new r("areis",73,1),new r("ereis",73,1),new r("ireis",73,1),new r("áreis",73,1),new r("éreis",73,1),new r("íreis",73,1),new r("ásseis",73,1),new r("ésseis",73,1),new r("ísseis",73,1),new r("áveis",73,1),new r("íeis",73,1),new r("aríeis",84,1),new r("eríeis",84,1),new r("iríeis",84,1),new r("ados",-1,1),new r("idos",-1,1),new r("amos",-1,1),new r("áramos",90,1),new r("éramos",90,1),new r("íramos",90,1),new r("ávamos",90,1),new r("íamos",90,1),new r("aríamos",95,1),new r("eríamos",95,1),new r("iríamos",95,1),new r("emos",-1,1),new r("aremos",99,1),new r("eremos",99,1),new r("iremos",99,1),new r("ássemos",99,1),new r("êssemos",99,1),new r("íssemos",99,1),new r("imos",-1,1),new r("armos",-1,1),new r("ermos",-1,1),new r("irmos",-1,1),new r("ámos",-1,1),new r("arás",-1,1),new r("erás",-1,1),new r("irás",-1,1),new r("eu",-1,1),new r("iu",-1,1),new r("ou",-1,1),new r("ará",-1,1),new r("erá",-1,1),new r("irá",-1,1)],W=[new r("a",-1,1),new r("i",-1,1),new r("o",-1,1),new r("os",-1,1),new r("á",-1,1),new r("í",-1,1),new r("ó",-1,1)],L=[new r("e",-1,1),new r("ç",-1,2),new r("é",-1,1),new r("ê",-1,1)],y=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2],z=new s;this.setCurrent=function(e){z.setCurrent(e)},this.getCurrent=function(){return z.getCurrent()},this.stem=function(){var r=z.cursor;return e(),z.cursor=r,a(),z.limit_backward=r,z.cursor=z.limit,_(),z.cursor=z.limit,p(),z.cursor=z.limit_backward,u(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.pt.stemmer,"stemmer-pt"),e.pt.stopWordFilter=e.generateStopWordFilter("a ao aos aquela aquelas aquele aqueles aquilo as até com como da das de dela delas dele deles depois do dos e ela elas ele eles em entre era eram essa essas esse esses esta estamos estas estava estavam este esteja estejam estejamos estes esteve estive estivemos estiver estivera estiveram estiverem estivermos estivesse estivessem estivéramos estivéssemos estou está estávamos estão eu foi fomos for fora foram forem formos fosse fossem fui fôramos fôssemos haja hajam hajamos havemos hei houve houvemos houver houvera houveram houverei houverem houveremos houveria houveriam houvermos houverá houverão houveríamos houvesse houvessem houvéramos houvéssemos há hão isso isto já lhe lhes mais mas me mesmo meu meus minha minhas muito na nas nem no nos nossa nossas nosso nossos num numa não nós o os ou para pela pelas pelo pelos por qual quando que quem se seja sejam sejamos sem serei seremos seria seriam será serão seríamos seu seus somos sou sua suas são só também te tem temos tenha tenham tenhamos tenho terei teremos teria teriam terá terão teríamos teu teus teve tinha tinham tive tivemos tiver tivera tiveram tiverem tivermos tivesse tivessem tivéramos tivéssemos tu tua tuas tém tínhamos um uma você vocês vos à às éramos".split(" ")),e.Pipeline.registerFunction(e.pt.stopWordFilter,"stopWordFilter-pt")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.ro.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.ro.min.js new file mode 100644 index 0000000000..7277140181 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.ro.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Romanian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ro=function(){this.pipeline.reset(),this.pipeline.add(e.ro.trimmer,e.ro.stopWordFilter,e.ro.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ro.stemmer))},e.ro.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.ro.trimmer=e.trimmerSupport.generateTrimmer(e.ro.wordCharacters),e.Pipeline.registerFunction(e.ro.trimmer,"trimmer-ro"),e.ro.stemmer=function(){var i=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(e,i){L.eq_s(1,e)&&(L.ket=L.cursor,L.in_grouping(W,97,259)&&L.slice_from(i))}function n(){for(var i,r;;){if(i=L.cursor,L.in_grouping(W,97,259)&&(r=L.cursor,L.bra=r,e("u","U"),L.cursor=r,e("i","I")),L.cursor=i,L.cursor>=L.limit)break;L.cursor++}}function t(){if(L.out_grouping(W,97,259)){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}return!0}function a(){if(L.in_grouping(W,97,259))for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}function o(){var e,i,r=L.cursor;if(L.in_grouping(W,97,259)){if(e=L.cursor,!t())return void(h=L.cursor);if(L.cursor=e,!a())return void(h=L.cursor)}L.cursor=r,L.out_grouping(W,97,259)&&(i=L.cursor,t()&&(L.cursor=i,L.in_grouping(W,97,259)&&L.cursor=L.limit)return!1;L.cursor++}for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}return!0}function c(){var e=L.cursor;h=L.limit,k=h,g=h,o(),L.cursor=e,u()&&(k=L.cursor,u()&&(g=L.cursor))}function s(){for(var e;;){if(L.bra=L.cursor,e=L.find_among(z,3))switch(L.ket=L.cursor,e){case 1:L.slice_from("i");continue;case 2:L.slice_from("u");continue;case 3:if(L.cursor>=L.limit)break;L.cursor++;continue}break}}function w(){return h<=L.cursor}function m(){return k<=L.cursor}function l(){return g<=L.cursor}function f(){var e,i;if(L.ket=L.cursor,(e=L.find_among_b(C,16))&&(L.bra=L.cursor,m()))switch(e){case 1:L.slice_del();break;case 2:L.slice_from("a");break;case 3:L.slice_from("e");break;case 4:L.slice_from("i");break;case 5:i=L.limit-L.cursor,L.eq_s_b(2,"ab")||(L.cursor=L.limit-i,L.slice_from("i"));break;case 6:L.slice_from("at");break;case 7:L.slice_from("aţi")}}function p(){var e,i=L.limit-L.cursor;if(L.ket=L.cursor,(e=L.find_among_b(P,46))&&(L.bra=L.cursor,m())){switch(e){case 1:L.slice_from("abil");break;case 2:L.slice_from("ibil");break;case 3:L.slice_from("iv");break;case 4:L.slice_from("ic");break;case 5:L.slice_from("at");break;case 6:L.slice_from("it")}return _=!0,L.cursor=L.limit-i,!0}return!1}function d(){var e,i;for(_=!1;;)if(i=L.limit-L.cursor,!p()){L.cursor=L.limit-i;break}if(L.ket=L.cursor,(e=L.find_among_b(F,62))&&(L.bra=L.cursor,l())){switch(e){case 1:L.slice_del();break;case 2:L.eq_s_b(1,"ţ")&&(L.bra=L.cursor,L.slice_from("t"));break;case 3:L.slice_from("ist")}_=!0}}function b(){var e,i,r;if(L.cursor>=h){if(i=L.limit_backward,L.limit_backward=h,L.ket=L.cursor,e=L.find_among_b(q,94))switch(L.bra=L.cursor,e){case 1:if(r=L.limit-L.cursor,!L.out_grouping_b(W,97,259)&&(L.cursor=L.limit-r,!L.eq_s_b(1,"u")))break;case 2:L.slice_del()}L.limit_backward=i}}function v(){var e;L.ket=L.cursor,(e=L.find_among_b(S,5))&&(L.bra=L.cursor,w()&&1==e&&L.slice_del())}var _,g,k,h,z=[new i("",-1,3),new i("I",0,1),new i("U",0,2)],C=[new i("ea",-1,3),new i("aţia",-1,7),new i("aua",-1,2),new i("iua",-1,4),new i("aţie",-1,7),new i("ele",-1,3),new i("ile",-1,5),new i("iile",6,4),new i("iei",-1,4),new i("atei",-1,6),new i("ii",-1,4),new i("ului",-1,1),new i("ul",-1,1),new i("elor",-1,3),new i("ilor",-1,4),new i("iilor",14,4)],P=[new i("icala",-1,4),new i("iciva",-1,4),new i("ativa",-1,5),new i("itiva",-1,6),new i("icale",-1,4),new i("aţiune",-1,5),new i("iţiune",-1,6),new i("atoare",-1,5),new i("itoare",-1,6),new i("ătoare",-1,5),new i("icitate",-1,4),new i("abilitate",-1,1),new i("ibilitate",-1,2),new i("ivitate",-1,3),new i("icive",-1,4),new i("ative",-1,5),new i("itive",-1,6),new i("icali",-1,4),new i("atori",-1,5),new i("icatori",18,4),new i("itori",-1,6),new i("ători",-1,5),new i("icitati",-1,4),new i("abilitati",-1,1),new i("ivitati",-1,3),new i("icivi",-1,4),new i("ativi",-1,5),new i("itivi",-1,6),new i("icităi",-1,4),new i("abilităi",-1,1),new i("ivităi",-1,3),new i("icităţi",-1,4),new i("abilităţi",-1,1),new i("ivităţi",-1,3),new i("ical",-1,4),new i("ator",-1,5),new i("icator",35,4),new i("itor",-1,6),new i("ător",-1,5),new i("iciv",-1,4),new i("ativ",-1,5),new i("itiv",-1,6),new i("icală",-1,4),new i("icivă",-1,4),new i("ativă",-1,5),new i("itivă",-1,6)],F=[new i("ica",-1,1),new i("abila",-1,1),new i("ibila",-1,1),new i("oasa",-1,1),new i("ata",-1,1),new i("ita",-1,1),new i("anta",-1,1),new i("ista",-1,3),new i("uta",-1,1),new i("iva",-1,1),new i("ic",-1,1),new i("ice",-1,1),new i("abile",-1,1),new i("ibile",-1,1),new i("isme",-1,3),new i("iune",-1,2),new i("oase",-1,1),new i("ate",-1,1),new i("itate",17,1),new i("ite",-1,1),new i("ante",-1,1),new i("iste",-1,3),new i("ute",-1,1),new i("ive",-1,1),new i("ici",-1,1),new i("abili",-1,1),new i("ibili",-1,1),new i("iuni",-1,2),new i("atori",-1,1),new i("osi",-1,1),new i("ati",-1,1),new i("itati",30,1),new i("iti",-1,1),new i("anti",-1,1),new i("isti",-1,3),new i("uti",-1,1),new i("işti",-1,3),new i("ivi",-1,1),new i("ităi",-1,1),new i("oşi",-1,1),new i("ităţi",-1,1),new i("abil",-1,1),new i("ibil",-1,1),new i("ism",-1,3),new i("ator",-1,1),new i("os",-1,1),new i("at",-1,1),new i("it",-1,1),new i("ant",-1,1),new i("ist",-1,3),new i("ut",-1,1),new i("iv",-1,1),new i("ică",-1,1),new i("abilă",-1,1),new i("ibilă",-1,1),new i("oasă",-1,1),new i("ată",-1,1),new i("ită",-1,1),new i("antă",-1,1),new i("istă",-1,3),new i("ută",-1,1),new i("ivă",-1,1)],q=[new i("ea",-1,1),new i("ia",-1,1),new i("esc",-1,1),new i("ăsc",-1,1),new i("ind",-1,1),new i("ând",-1,1),new i("are",-1,1),new i("ere",-1,1),new i("ire",-1,1),new i("âre",-1,1),new i("se",-1,2),new i("ase",10,1),new i("sese",10,2),new i("ise",10,1),new i("use",10,1),new i("âse",10,1),new i("eşte",-1,1),new i("ăşte",-1,1),new i("eze",-1,1),new i("ai",-1,1),new i("eai",19,1),new i("iai",19,1),new i("sei",-1,2),new i("eşti",-1,1),new i("ăşti",-1,1),new i("ui",-1,1),new i("ezi",-1,1),new i("âi",-1,1),new i("aşi",-1,1),new i("seşi",-1,2),new i("aseşi",29,1),new i("seseşi",29,2),new i("iseşi",29,1),new i("useşi",29,1),new i("âseşi",29,1),new i("işi",-1,1),new i("uşi",-1,1),new i("âşi",-1,1),new i("aţi",-1,2),new i("eaţi",38,1),new i("iaţi",38,1),new i("eţi",-1,2),new i("iţi",-1,2),new i("âţi",-1,2),new i("arăţi",-1,1),new i("serăţi",-1,2),new i("aserăţi",45,1),new i("seserăţi",45,2),new i("iserăţi",45,1),new i("userăţi",45,1),new i("âserăţi",45,1),new i("irăţi",-1,1),new i("urăţi",-1,1),new i("ârăţi",-1,1),new i("am",-1,1),new i("eam",54,1),new i("iam",54,1),new i("em",-1,2),new i("asem",57,1),new i("sesem",57,2),new i("isem",57,1),new i("usem",57,1),new i("âsem",57,1),new i("im",-1,2),new i("âm",-1,2),new i("ăm",-1,2),new i("arăm",65,1),new i("serăm",65,2),new i("aserăm",67,1),new i("seserăm",67,2),new i("iserăm",67,1),new i("userăm",67,1),new i("âserăm",67,1),new i("irăm",65,1),new i("urăm",65,1),new i("ârăm",65,1),new i("au",-1,1),new i("eau",76,1),new i("iau",76,1),new i("indu",-1,1),new i("ându",-1,1),new i("ez",-1,1),new i("ească",-1,1),new i("ară",-1,1),new i("seră",-1,2),new i("aseră",84,1),new i("seseră",84,2),new i("iseră",84,1),new i("useră",84,1),new i("âseră",84,1),new i("iră",-1,1),new i("ură",-1,1),new i("âră",-1,1),new i("ează",-1,1)],S=[new i("a",-1,1),new i("e",-1,1),new i("ie",1,1),new i("i",-1,1),new i("ă",-1,1)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var e=L.cursor;return n(),L.cursor=e,c(),L.limit_backward=e,L.cursor=L.limit,f(),L.cursor=L.limit,d(),L.cursor=L.limit,_||(L.cursor=L.limit,b(),L.cursor=L.limit),v(),L.cursor=L.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.ro.stemmer,"stemmer-ro"),e.ro.stopWordFilter=e.generateStopWordFilter("acea aceasta această aceea acei aceia acel acela acele acelea acest acesta aceste acestea aceşti aceştia acolo acord acum ai aia aibă aici al ale alea altceva altcineva am ar are asemenea asta astea astăzi asupra au avea avem aveţi azi aş aşadar aţi bine bucur bună ca care caut ce cel ceva chiar cinci cine cineva contra cu cum cumva curând curînd când cât câte câtva câţi cînd cît cîte cîtva cîţi că căci cărei căror cărui către da dacă dar datorită dată dau de deci deja deoarece departe deşi din dinaintea dintr- dintre doi doilea două drept după dă ea ei el ele eram este eu eşti face fata fi fie fiecare fii fim fiu fiţi frumos fără graţie halbă iar ieri la le li lor lui lângă lîngă mai mea mei mele mereu meu mi mie mine mult multă mulţi mulţumesc mâine mîine mă ne nevoie nici nicăieri nimeni nimeri nimic nişte noastre noastră noi noroc nostru nouă noştri nu opt ori oricare orice oricine oricum oricând oricât oricînd oricît oriunde patra patru patrulea pe pentru peste pic poate pot prea prima primul prin puţin puţina puţină până pînă rog sa sale sau se spate spre sub sunt suntem sunteţi sută sînt sîntem sînteţi să săi său ta tale te timp tine toate toată tot totuşi toţi trei treia treilea tu tăi tău un una unde undeva unei uneia unele uneori unii unor unora unu unui unuia unul vi voastre voastră voi vostru vouă voştri vreme vreo vreun vă zece zero zi zice îi îl îmi împotriva în înainte înaintea încotro încât încît între întrucât întrucît îţi ăla ălea ăsta ăstea ăştia şapte şase şi ştiu ţi ţie".split(" ")),e.Pipeline.registerFunction(e.ro.stopWordFilter,"stopWordFilter-ro")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.ru.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.ru.min.js new file mode 100644 index 0000000000..186cc485c2 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.ru.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Russian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ru=function(){this.pipeline.reset(),this.pipeline.add(e.ru.trimmer,e.ru.stopWordFilter,e.ru.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ru.stemmer))},e.ru.wordCharacters="Ѐ-҄҇-ԯᴫᵸⷠ-ⷿꙀ-ꚟ︮︯",e.ru.trimmer=e.trimmerSupport.generateTrimmer(e.ru.wordCharacters),e.Pipeline.registerFunction(e.ru.trimmer,"trimmer-ru"),e.ru.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,t=new function(){function e(){for(;!W.in_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function t(){for(;!W.out_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function w(){b=W.limit,_=b,e()&&(b=W.cursor,t()&&e()&&t()&&(_=W.cursor))}function i(){return _<=W.cursor}function u(e,n){var r,t;if(W.ket=W.cursor,r=W.find_among_b(e,n)){switch(W.bra=W.cursor,r){case 1:if(t=W.limit-W.cursor,!W.eq_s_b(1,"а")&&(W.cursor=W.limit-t,!W.eq_s_b(1,"я")))return!1;case 2:W.slice_del()}return!0}return!1}function o(){return u(h,9)}function s(e,n){var r;return W.ket=W.cursor,!!(r=W.find_among_b(e,n))&&(W.bra=W.cursor,1==r&&W.slice_del(),!0)}function c(){return s(g,26)}function m(){return!!c()&&(u(C,8),!0)}function f(){return s(k,2)}function l(){return u(P,46)}function a(){s(v,36)}function p(){var e;W.ket=W.cursor,(e=W.find_among_b(F,2))&&(W.bra=W.cursor,i()&&1==e&&W.slice_del())}function d(){var e;if(W.ket=W.cursor,e=W.find_among_b(q,4))switch(W.bra=W.cursor,e){case 1:if(W.slice_del(),W.ket=W.cursor,!W.eq_s_b(1,"н"))break;W.bra=W.cursor;case 2:if(!W.eq_s_b(1,"н"))break;case 3:W.slice_del()}}var _,b,h=[new n("в",-1,1),new n("ив",0,2),new n("ыв",0,2),new n("вши",-1,1),new n("ивши",3,2),new n("ывши",3,2),new n("вшись",-1,1),new n("ившись",6,2),new n("ывшись",6,2)],g=[new n("ее",-1,1),new n("ие",-1,1),new n("ое",-1,1),new n("ые",-1,1),new n("ими",-1,1),new n("ыми",-1,1),new n("ей",-1,1),new n("ий",-1,1),new n("ой",-1,1),new n("ый",-1,1),new n("ем",-1,1),new n("им",-1,1),new n("ом",-1,1),new n("ым",-1,1),new n("его",-1,1),new n("ого",-1,1),new n("ему",-1,1),new n("ому",-1,1),new n("их",-1,1),new n("ых",-1,1),new n("ею",-1,1),new n("ою",-1,1),new n("ую",-1,1),new n("юю",-1,1),new n("ая",-1,1),new n("яя",-1,1)],C=[new n("ем",-1,1),new n("нн",-1,1),new n("вш",-1,1),new n("ивш",2,2),new n("ывш",2,2),new n("щ",-1,1),new n("ющ",5,1),new n("ующ",6,2)],k=[new n("сь",-1,1),new n("ся",-1,1)],P=[new n("ла",-1,1),new n("ила",0,2),new n("ыла",0,2),new n("на",-1,1),new n("ена",3,2),new n("ете",-1,1),new n("ите",-1,2),new n("йте",-1,1),new n("ейте",7,2),new n("уйте",7,2),new n("ли",-1,1),new n("или",10,2),new n("ыли",10,2),new n("й",-1,1),new n("ей",13,2),new n("уй",13,2),new n("л",-1,1),new n("ил",16,2),new n("ыл",16,2),new n("ем",-1,1),new n("им",-1,2),new n("ым",-1,2),new n("н",-1,1),new n("ен",22,2),new n("ло",-1,1),new n("ило",24,2),new n("ыло",24,2),new n("но",-1,1),new n("ено",27,2),new n("нно",27,1),new n("ет",-1,1),new n("ует",30,2),new n("ит",-1,2),new n("ыт",-1,2),new n("ют",-1,1),new n("уют",34,2),new n("ят",-1,2),new n("ны",-1,1),new n("ены",37,2),new n("ть",-1,1),new n("ить",39,2),new n("ыть",39,2),new n("ешь",-1,1),new n("ишь",-1,2),new n("ю",-1,2),new n("ую",44,2)],v=[new n("а",-1,1),new n("ев",-1,1),new n("ов",-1,1),new n("е",-1,1),new n("ие",3,1),new n("ье",3,1),new n("и",-1,1),new n("еи",6,1),new n("ии",6,1),new n("ами",6,1),new n("ями",6,1),new n("иями",10,1),new n("й",-1,1),new n("ей",12,1),new n("ией",13,1),new n("ий",12,1),new n("ой",12,1),new n("ам",-1,1),new n("ем",-1,1),new n("ием",18,1),new n("ом",-1,1),new n("ям",-1,1),new n("иям",21,1),new n("о",-1,1),new n("у",-1,1),new n("ах",-1,1),new n("ях",-1,1),new n("иях",26,1),new n("ы",-1,1),new n("ь",-1,1),new n("ю",-1,1),new n("ию",30,1),new n("ью",30,1),new n("я",-1,1),new n("ия",33,1),new n("ья",33,1)],F=[new n("ост",-1,1),new n("ость",-1,1)],q=[new n("ейше",-1,1),new n("н",-1,2),new n("ейш",-1,1),new n("ь",-1,3)],S=[33,65,8,232],W=new r;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){return w(),W.cursor=W.limit,!(W.cursor=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},in_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},out_grouping:function(t,i,s){if(this.cursors||e>3]&1<<(7&e)))return this.cursor++,!0}return!1},out_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e>s||e>3]&1<<(7&e)))return this.cursor--,!0}return!1},eq_s:function(t,i){if(this.limit-this.cursor>1),f=0,l=o0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n+_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n+_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},find_among_b:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit_backward,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o=0;m--){if(n-l==u){f=-1;break}if(f=r.charCodeAt(n-1-l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n-_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n-_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},replace_s:function(t,i,s){var e=s.length-(i-t),n=r.substring(0,t),u=r.substring(i);return r=n+s+u,this.limit+=e,this.cursor>=i?this.cursor+=e:this.cursor>t&&(this.cursor=t),e},slice_check:function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>r.length)throw"faulty slice operation"},slice_from:function(r){this.slice_check(),this.replace_s(this.bra,this.ket,r)},slice_del:function(){this.slice_from("")},insert:function(r,t,i){var s=this.replace_s(r,t,i);r<=this.bra&&(this.bra+=s),r<=this.ket&&(this.ket+=s)},slice_to:function(){return this.slice_check(),r.substring(this.bra,this.ket)},eq_v_b:function(r){return this.eq_s_b(r.length,r)}}}},r.trimmerSupport={generateTrimmer:function(r){var t=new RegExp("^[^"+r+"]+"),i=new RegExp("[^"+r+"]+$");return function(r){return"function"==typeof r.update?r.update(function(r){return r.replace(t,"").replace(i,"")}):r.replace(t,"").replace(i,"")}}}}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.sv.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.sv.min.js new file mode 100644 index 0000000000..3e5eb64000 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.sv.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Swedish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sv=function(){this.pipeline.reset(),this.pipeline.add(e.sv.trimmer,e.sv.stopWordFilter,e.sv.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sv.stemmer))},e.sv.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.sv.trimmer=e.trimmerSupport.generateTrimmer(e.sv.wordCharacters),e.Pipeline.registerFunction(e.sv.trimmer,"trimmer-sv"),e.sv.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,t=new function(){function e(){var e,r=w.cursor+3;if(o=w.limit,0<=r||r<=w.limit){for(a=r;;){if(e=w.cursor,w.in_grouping(l,97,246)){w.cursor=e;break}if(w.cursor=e,w.cursor>=w.limit)return;w.cursor++}for(;!w.out_grouping(l,97,246);){if(w.cursor>=w.limit)return;w.cursor++}o=w.cursor,o=o&&(w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(u,37),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.in_grouping_b(d,98,121)&&w.slice_del()}}function i(){var e=w.limit_backward;w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.find_among_b(c,7)&&(w.cursor=w.limit,w.ket=w.cursor,w.cursor>w.limit_backward&&(w.bra=--w.cursor,w.slice_del())),w.limit_backward=e)}function s(){var e,r;if(w.cursor>=o){if(r=w.limit_backward,w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(m,5))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.slice_from("lös");break;case 3:w.slice_from("full")}w.limit_backward=r}}var a,o,u=[new r("a",-1,1),new r("arna",0,1),new r("erna",0,1),new r("heterna",2,1),new r("orna",0,1),new r("ad",-1,1),new r("e",-1,1),new r("ade",6,1),new r("ande",6,1),new r("arne",6,1),new r("are",6,1),new r("aste",6,1),new r("en",-1,1),new r("anden",12,1),new r("aren",12,1),new r("heten",12,1),new r("ern",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",18,1),new r("or",-1,1),new r("s",-1,2),new r("as",21,1),new r("arnas",22,1),new r("ernas",22,1),new r("ornas",22,1),new r("es",21,1),new r("ades",26,1),new r("andes",26,1),new r("ens",21,1),new r("arens",29,1),new r("hetens",29,1),new r("erns",21,1),new r("at",-1,1),new r("andet",-1,1),new r("het",-1,1),new r("ast",-1,1)],c=[new r("dd",-1,-1),new r("gd",-1,-1),new r("nn",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1),new r("tt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("els",-1,1),new r("fullt",-1,3),new r("löst",-1,2)],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32],d=[119,127,149],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,t(),w.cursor=w.limit,i(),w.cursor=w.limit,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.sv.stemmer,"stemmer-sv"),e.sv.stopWordFilter=e.generateStopWordFilter("alla allt att av blev bli blir blivit de dem den denna deras dess dessa det detta dig din dina ditt du där då efter ej eller en er era ert ett från för ha hade han hans har henne hennes hon honom hur här i icke ingen inom inte jag ju kan kunde man med mellan men mig min mina mitt mot mycket ni nu när någon något några och om oss på samma sedan sig sin sina sitta själv skulle som så sådan sådana sådant till under upp ut utan vad var vara varför varit varje vars vart vem vi vid vilka vilkas vilken vilket vår våra vårt än är åt över".split(" ")),e.Pipeline.registerFunction(e.sv.stopWordFilter,"stopWordFilter-sv")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.th.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.th.min.js new file mode 100644 index 0000000000..dee3aac6e5 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.th.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.th=function(){this.pipeline.reset(),this.pipeline.add(e.th.trimmer),r?this.tokenizer=e.th.tokenizer:(e.tokenizer&&(e.tokenizer=e.th.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.th.tokenizer))},e.th.wordCharacters="[฀-๿]",e.th.trimmer=e.trimmerSupport.generateTrimmer(e.th.wordCharacters),e.Pipeline.registerFunction(e.th.trimmer,"trimmer-th");var t=e.wordcut;t.init(),e.th.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t):t});var n=i.toString().replace(/^\s+/,"");return t.cut(n).split("|")}}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.tr.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.tr.min.js new file mode 100644 index 0000000000..563f6ec1f5 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.tr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Turkish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(r,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.tr=function(){this.pipeline.reset(),this.pipeline.add(r.tr.trimmer,r.tr.stopWordFilter,r.tr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.tr.stemmer))},r.tr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.tr.trimmer=r.trimmerSupport.generateTrimmer(r.tr.wordCharacters),r.Pipeline.registerFunction(r.tr.trimmer,"trimmer-tr"),r.tr.stemmer=function(){var i=r.stemmerSupport.Among,e=r.stemmerSupport.SnowballProgram,n=new function(){function r(r,i,e){for(;;){var n=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(r,i,e)){Dr.cursor=Dr.limit-n;break}if(Dr.cursor=Dr.limit-n,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function n(){var i,e;i=Dr.limit-Dr.cursor,r(Wr,97,305);for(var n=0;nDr.limit_backward&&(Dr.cursor--,e=Dr.limit-Dr.cursor,i()))?(Dr.cursor=Dr.limit-e,!0):(Dr.cursor=Dr.limit-n,r()?(Dr.cursor=Dr.limit-n,!1):(Dr.cursor=Dr.limit-n,!(Dr.cursor<=Dr.limit_backward)&&(Dr.cursor--,!!i()&&(Dr.cursor=Dr.limit-n,!0))))}function u(r){return t(r,function(){return Dr.in_grouping_b(Wr,97,305)})}function o(){return u(function(){return Dr.eq_s_b(1,"n")})}function s(){return u(function(){return Dr.eq_s_b(1,"s")})}function c(){return u(function(){return Dr.eq_s_b(1,"y")})}function l(){return t(function(){return Dr.in_grouping_b(Lr,105,305)},function(){return Dr.out_grouping_b(Wr,97,305)})}function a(){return Dr.find_among_b(ur,10)&&l()}function m(){return n()&&Dr.in_grouping_b(Lr,105,305)&&s()}function d(){return Dr.find_among_b(or,2)}function f(){return n()&&Dr.in_grouping_b(Lr,105,305)&&c()}function b(){return n()&&Dr.find_among_b(sr,4)}function w(){return n()&&Dr.find_among_b(cr,4)&&o()}function _(){return n()&&Dr.find_among_b(lr,2)&&c()}function k(){return n()&&Dr.find_among_b(ar,2)}function p(){return n()&&Dr.find_among_b(mr,4)}function g(){return n()&&Dr.find_among_b(dr,2)}function y(){return n()&&Dr.find_among_b(fr,4)}function z(){return n()&&Dr.find_among_b(br,2)}function v(){return n()&&Dr.find_among_b(wr,2)&&c()}function h(){return Dr.eq_s_b(2,"ki")}function q(){return n()&&Dr.find_among_b(_r,2)&&o()}function C(){return n()&&Dr.find_among_b(kr,4)&&c()}function P(){return n()&&Dr.find_among_b(pr,4)}function F(){return n()&&Dr.find_among_b(gr,4)&&c()}function S(){return Dr.find_among_b(yr,4)}function W(){return n()&&Dr.find_among_b(zr,2)}function L(){return n()&&Dr.find_among_b(vr,4)}function x(){return n()&&Dr.find_among_b(hr,8)}function A(){return Dr.find_among_b(qr,2)}function E(){return n()&&Dr.find_among_b(Cr,32)&&c()}function j(){return Dr.find_among_b(Pr,8)&&c()}function T(){return n()&&Dr.find_among_b(Fr,4)&&c()}function Z(){return Dr.eq_s_b(3,"ken")&&c()}function B(){var r=Dr.limit-Dr.cursor;return!(T()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,Z()))))}function D(){if(A()){var r=Dr.limit-Dr.cursor;if(S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T())return!1}return!0}function G(){if(W()){Dr.bra=Dr.cursor,Dr.slice_del();var r=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,x()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,T()||(Dr.cursor=Dr.limit-r)))),nr=!1,!1}return!0}function H(){if(!L())return!0;var r=Dr.limit-Dr.cursor;return!E()&&(Dr.cursor=Dr.limit-r,!j())}function I(){var r,i=Dr.limit-Dr.cursor;return!(S()||(Dr.cursor=Dr.limit-i,F()||(Dr.cursor=Dr.limit-i,P()||(Dr.cursor=Dr.limit-i,C()))))||(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,T()||(Dr.cursor=Dr.limit-r),!1)}function J(){var r,i=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,nr=!0,B()&&(Dr.cursor=Dr.limit-i,D()&&(Dr.cursor=Dr.limit-i,G()&&(Dr.cursor=Dr.limit-i,H()&&(Dr.cursor=Dr.limit-i,I()))))){if(Dr.cursor=Dr.limit-i,!x())return;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T()||(Dr.cursor=Dr.limit-r)}Dr.bra=Dr.cursor,Dr.slice_del()}function K(){var r,i,e,n;if(Dr.ket=Dr.cursor,h()){if(r=Dr.limit-Dr.cursor,p())return Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,a()&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))),!0;if(Dr.cursor=Dr.limit-r,w()){if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,e=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-e,!m()&&(Dr.cursor=Dr.limit-e,!K())))return!0;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}return!0}if(Dr.cursor=Dr.limit-r,g()){if(n=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-n,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-n,!K())return!1;return!0}}return!1}function M(r){if(Dr.ket=Dr.cursor,!g()&&(Dr.cursor=Dr.limit-r,!k()))return!1;var i=Dr.limit-Dr.cursor;if(d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-i,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-i,!K())return!1;return!0}function N(r){if(Dr.ket=Dr.cursor,!z()&&(Dr.cursor=Dr.limit-r,!b()))return!1;var i=Dr.limit-Dr.cursor;return!(!m()&&(Dr.cursor=Dr.limit-i,!d()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)}function O(){var r,i=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,!(!w()&&(Dr.cursor=Dr.limit-i,!v()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,!(!W()||(Dr.bra=Dr.cursor,Dr.slice_del(),!K()))||(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!(a()||(Dr.cursor=Dr.limit-r,m()||(Dr.cursor=Dr.limit-r,K())))||(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)))}function Q(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,!p()&&(Dr.cursor=Dr.limit-e,!f()&&(Dr.cursor=Dr.limit-e,!_())))return!1;if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,a())Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()||(Dr.cursor=Dr.limit-i);else if(Dr.cursor=Dr.limit-r,!W())return!0;return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,K(),!0}function R(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,W())return Dr.bra=Dr.cursor,Dr.slice_del(),void K();if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,q())if(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-r,!m())){if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!W())return;if(Dr.bra=Dr.cursor,Dr.slice_del(),!K())return}Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}else if(Dr.cursor=Dr.limit-e,!M(e)&&(Dr.cursor=Dr.limit-e,!N(e))){if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,y())return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,i=Dr.limit-Dr.cursor,void(a()?(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())):(Dr.cursor=Dr.limit-i,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,K())));if(Dr.cursor=Dr.limit-e,!O()){if(Dr.cursor=Dr.limit-e,d())return Dr.bra=Dr.cursor,void Dr.slice_del();Dr.cursor=Dr.limit-e,K()||(Dr.cursor=Dr.limit-e,Q()||(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,(a()||(Dr.cursor=Dr.limit-e,m()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))))}}}function U(){var r;if(Dr.ket=Dr.cursor,r=Dr.find_among_b(Sr,4))switch(Dr.bra=Dr.cursor,r){case 1:Dr.slice_from("p");break;case 2:Dr.slice_from("ç");break;case 3:Dr.slice_from("t");break;case 4:Dr.slice_from("k")}}function V(){for(;;){var r=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(Wr,97,305)){Dr.cursor=Dr.limit-r;break}if(Dr.cursor=Dr.limit-r,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function X(r,i,e){if(Dr.cursor=Dr.limit-r,V()){var n=Dr.limit-Dr.cursor;if(!Dr.eq_s_b(1,i)&&(Dr.cursor=Dr.limit-n,!Dr.eq_s_b(1,e)))return!0;Dr.cursor=Dr.limit-r;var t=Dr.cursor;return Dr.insert(Dr.cursor,Dr.cursor,e),Dr.cursor=t,!1}return!0}function Y(){var r=Dr.limit-Dr.cursor;(Dr.eq_s_b(1,"d")||(Dr.cursor=Dr.limit-r,Dr.eq_s_b(1,"g")))&&X(r,"a","ı")&&X(r,"e","i")&&X(r,"o","u")&&X(r,"ö","ü")}function $(){for(var r,i=Dr.cursor,e=2;;){for(r=Dr.cursor;!Dr.in_grouping(Wr,97,305);){if(Dr.cursor>=Dr.limit)return Dr.cursor=r,!(e>0)&&(Dr.cursor=i,!0);Dr.cursor++}e--}}function rr(r,i,e){for(;!Dr.eq_s(i,e);){if(Dr.cursor>=Dr.limit)return!0;Dr.cursor++}return(tr=i)!=Dr.limit||(Dr.cursor=r,!1)}function ir(){var r=Dr.cursor;return!rr(r,2,"ad")||(Dr.cursor=r,!rr(r,5,"soyad"))}function er(){var r=Dr.cursor;return!ir()&&(Dr.limit_backward=r,Dr.cursor=Dr.limit,Y(),Dr.cursor=Dr.limit,U(),!0)}var nr,tr,ur=[new i("m",-1,-1),new i("n",-1,-1),new i("miz",-1,-1),new i("niz",-1,-1),new i("muz",-1,-1),new i("nuz",-1,-1),new i("müz",-1,-1),new i("nüz",-1,-1),new i("mız",-1,-1),new i("nız",-1,-1)],or=[new i("leri",-1,-1),new i("ları",-1,-1)],sr=[new i("ni",-1,-1),new i("nu",-1,-1),new i("nü",-1,-1),new i("nı",-1,-1)],cr=[new i("in",-1,-1),new i("un",-1,-1),new i("ün",-1,-1),new i("ın",-1,-1)],lr=[new i("a",-1,-1),new i("e",-1,-1)],ar=[new i("na",-1,-1),new i("ne",-1,-1)],mr=[new i("da",-1,-1),new i("ta",-1,-1),new i("de",-1,-1),new i("te",-1,-1)],dr=[new i("nda",-1,-1),new i("nde",-1,-1)],fr=[new i("dan",-1,-1),new i("tan",-1,-1),new i("den",-1,-1),new i("ten",-1,-1)],br=[new i("ndan",-1,-1),new i("nden",-1,-1)],wr=[new i("la",-1,-1),new i("le",-1,-1)],_r=[new i("ca",-1,-1),new i("ce",-1,-1)],kr=[new i("im",-1,-1),new i("um",-1,-1),new i("üm",-1,-1),new i("ım",-1,-1)],pr=[new i("sin",-1,-1),new i("sun",-1,-1),new i("sün",-1,-1),new i("sın",-1,-1)],gr=[new i("iz",-1,-1),new i("uz",-1,-1),new i("üz",-1,-1),new i("ız",-1,-1)],yr=[new i("siniz",-1,-1),new i("sunuz",-1,-1),new i("sünüz",-1,-1),new i("sınız",-1,-1)],zr=[new i("lar",-1,-1),new i("ler",-1,-1)],vr=[new i("niz",-1,-1),new i("nuz",-1,-1),new i("nüz",-1,-1),new i("nız",-1,-1)],hr=[new i("dir",-1,-1),new i("tir",-1,-1),new i("dur",-1,-1),new i("tur",-1,-1),new i("dür",-1,-1),new i("tür",-1,-1),new i("dır",-1,-1),new i("tır",-1,-1)],qr=[new i("casına",-1,-1),new i("cesine",-1,-1)],Cr=[new i("di",-1,-1),new i("ti",-1,-1),new i("dik",-1,-1),new i("tik",-1,-1),new i("duk",-1,-1),new i("tuk",-1,-1),new i("dük",-1,-1),new i("tük",-1,-1),new i("dık",-1,-1),new i("tık",-1,-1),new i("dim",-1,-1),new i("tim",-1,-1),new i("dum",-1,-1),new i("tum",-1,-1),new i("düm",-1,-1),new i("tüm",-1,-1),new i("dım",-1,-1),new i("tım",-1,-1),new i("din",-1,-1),new i("tin",-1,-1),new i("dun",-1,-1),new i("tun",-1,-1),new i("dün",-1,-1),new i("tün",-1,-1),new i("dın",-1,-1),new i("tın",-1,-1),new i("du",-1,-1),new i("tu",-1,-1),new i("dü",-1,-1),new i("tü",-1,-1),new i("dı",-1,-1),new i("tı",-1,-1)],Pr=[new i("sa",-1,-1),new i("se",-1,-1),new i("sak",-1,-1),new i("sek",-1,-1),new i("sam",-1,-1),new i("sem",-1,-1),new i("san",-1,-1),new i("sen",-1,-1)],Fr=[new i("miş",-1,-1),new i("muş",-1,-1),new i("müş",-1,-1),new i("mış",-1,-1)],Sr=[new i("b",-1,1),new i("c",-1,2),new i("d",-1,3),new i("ğ",-1,4)],Wr=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],Lr=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],xr=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Ar=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Er=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],jr=[17],Tr=[65],Zr=[65],Br=[["a",xr,97,305],["e",Ar,101,252],["ı",Er,97,305],["i",jr,101,105],["o",Tr,111,117],["ö",Zr,246,252],["u",Tr,111,117]],Dr=new e;this.setCurrent=function(r){Dr.setCurrent(r)},this.getCurrent=function(){return Dr.getCurrent()},this.stem=function(){return!!($()&&(Dr.limit_backward=Dr.cursor,Dr.cursor=Dr.limit,J(),Dr.cursor=Dr.limit,nr&&(R(),Dr.cursor=Dr.limit_backward,er())))}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.tr.stemmer,"stemmer-tr"),r.tr.stopWordFilter=r.generateStopWordFilter("acaba altmış altı ama ancak arada aslında ayrıca bana bazı belki ben benden beni benim beri beş bile bin bir biri birkaç birkez birçok birşey birşeyi biz bizden bize bizi bizim bu buna bunda bundan bunlar bunları bunların bunu bunun burada böyle böylece da daha dahi de defa değil diye diğer doksan dokuz dolayı dolayısıyla dört edecek eden ederek edilecek ediliyor edilmesi ediyor elli en etmesi etti ettiği ettiğini eğer gibi göre halen hangi hatta hem henüz hep hepsi her herhangi herkesin hiç hiçbir iki ile ilgili ise itibaren itibariyle için işte kadar karşın katrilyon kendi kendilerine kendini kendisi kendisine kendisini kez ki kim kimden kime kimi kimse kırk milyar milyon mu mü mı nasıl ne neden nedenle nerde nerede nereye niye niçin o olan olarak oldu olduklarını olduğu olduğunu olmadı olmadığı olmak olması olmayan olmaz olsa olsun olup olur olursa oluyor on ona ondan onlar onlardan onları onların onu onun otuz oysa pek rağmen sadece sanki sekiz seksen sen senden seni senin siz sizden sizi sizin tarafından trilyon tüm var vardı ve veya ya yani yapacak yapmak yaptı yaptıkları yaptığı yaptığını yapılan yapılması yapıyor yedi yerine yetmiş yine yirmi yoksa yüz zaten çok çünkü öyle üzere üç şey şeyden şeyi şeyler şu şuna şunda şundan şunları şunu şöyle".split(" ")),r.Pipeline.registerFunction(r.tr.stopWordFilter,"stopWordFilter-tr")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.vi.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.vi.min.js new file mode 100644 index 0000000000..22aed28c49 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.vi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.vi=function(){this.pipeline.reset(),this.pipeline.add(e.vi.stopWordFilter,e.vi.trimmer)},e.vi.wordCharacters="[A-Za-ẓ̀͐́͑̉̃̓ÂâÊêÔôĂ-ăĐ-đƠ-ơƯ-ư]",e.vi.trimmer=e.trimmerSupport.generateTrimmer(e.vi.wordCharacters),e.Pipeline.registerFunction(e.vi.trimmer,"trimmer-vi"),e.vi.stopWordFilter=e.generateStopWordFilter("là cái nhưng mà".split(" "))}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/min/lunr.zh.min.js b/3.25.0/assets/javascripts/lunr/min/lunr.zh.min.js new file mode 100644 index 0000000000..7727bbe24d --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/min/lunr.zh.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r(require("nodejieba")):r()(e.lunr)}(this,function(e){return function(r,t){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var i="2"==r.version[0];r.zh=function(){this.pipeline.reset(),this.pipeline.add(r.zh.trimmer,r.zh.stopWordFilter,r.zh.stemmer),i?this.tokenizer=r.zh.tokenizer:(r.tokenizer&&(r.tokenizer=r.zh.tokenizer),this.tokenizerFn&&(this.tokenizerFn=r.zh.tokenizer))},r.zh.tokenizer=function(n){if(!arguments.length||null==n||void 0==n)return[];if(Array.isArray(n))return n.map(function(e){return i?new r.Token(e.toLowerCase()):e.toLowerCase()});t&&e.load(t);var o=n.toString().trim().toLowerCase(),s=[];e.cut(o,!0).forEach(function(e){s=s.concat(e.split(" "))}),s=s.filter(function(e){return!!e});var u=0;return s.map(function(e,t){if(i){var n=o.indexOf(e,u),s={};return s.position=[n,e.length],s.index=t,u=n,new r.Token(e,s)}return e})},r.zh.wordCharacters="\\w一-龥",r.zh.trimmer=r.trimmerSupport.generateTrimmer(r.zh.wordCharacters),r.Pipeline.registerFunction(r.zh.trimmer,"trimmer-zh"),r.zh.stemmer=function(){return function(e){return e}}(),r.Pipeline.registerFunction(r.zh.stemmer,"stemmer-zh"),r.zh.stopWordFilter=r.generateStopWordFilter("的 一 不 在 人 有 是 为 以 于 上 他 而 后 之 来 及 了 因 下 可 到 由 这 与 也 此 但 并 个 其 已 无 小 我 们 起 最 再 今 去 好 只 又 或 很 亦 某 把 那 你 乃 它 吧 被 比 别 趁 当 从 到 得 打 凡 儿 尔 该 各 给 跟 和 何 还 即 几 既 看 据 距 靠 啦 了 另 么 每 们 嘛 拿 哪 那 您 凭 且 却 让 仍 啥 如 若 使 谁 虽 随 同 所 她 哇 嗡 往 哪 些 向 沿 哟 用 于 咱 则 怎 曾 至 致 着 诸 自".split(" ")),r.Pipeline.registerFunction(r.zh.stopWordFilter,"stopWordFilter-zh")}}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/tinyseg.js b/3.25.0/assets/javascripts/lunr/tinyseg.js new file mode 100644 index 0000000000..167fa6dd69 --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/tinyseg.js @@ -0,0 +1,206 @@ +/** + * export the module via AMD, CommonJS or as a browser global + * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js + */ +;(function (root, factory) { + if (typeof define === 'function' && define.amd) { + // AMD. Register as an anonymous module. + define(factory) + } else if (typeof exports === 'object') { + /** + * Node. Does not work with strict CommonJS, but + * only CommonJS-like environments that support module.exports, + * like Node. + */ + module.exports = factory() + } else { + // Browser globals (root is window) + factory()(root.lunr); + } +}(this, function () { + /** + * Just return a value to define the module export. + * This example returns an object, but the module + * can return a function as the exported value. + */ + + return function(lunr) { + // TinySegmenter 0.1 -- Super compact Japanese tokenizer in Javascript + // (c) 2008 Taku Kudo + // TinySegmenter is freely distributable under the terms of a new BSD licence. + // For details, see http://chasen.org/~taku/software/TinySegmenter/LICENCE.txt + + function TinySegmenter() { + var patterns = { + "[一二三四五六七八九十百千万億兆]":"M", + "[一-龠々〆ヵヶ]":"H", + "[ぁ-ん]":"I", + "[ァ-ヴーｱ-ﾝﾞｰ]":"K", + "[a-zA-Zａ-ｚＡ-Ｚ]":"A", + "[0-9０-９]":"N" + } + this.chartype_ = []; + for (var i in patterns) { + var regexp = new RegExp(i); + this.chartype_.push([regexp, patterns[i]]); + } + + this.BIAS__ = -332 + this.BC1__ = {"HH":6,"II":2461,"KH":406,"OH":-1378}; + this.BC2__ = {"AA":-3267,"AI":2744,"AN":-878,"HH":-4070,"HM":-1711,"HN":4012,"HO":3761,"IA":1327,"IH":-1184,"II":-1332,"IK":1721,"IO":5492,"KI":3831,"KK":-8741,"MH":-3132,"MK":3334,"OO":-2920}; + this.BC3__ = {"HH":996,"HI":626,"HK":-721,"HN":-1307,"HO":-836,"IH":-301,"KK":2762,"MK":1079,"MM":4034,"OA":-1652,"OH":266}; + this.BP1__ = {"BB":295,"OB":304,"OO":-125,"UB":352}; + this.BP2__ = {"BO":60,"OO":-1762}; + this.BQ1__ = {"BHH":1150,"BHM":1521,"BII":-1158,"BIM":886,"BMH":1208,"BNH":449,"BOH":-91,"BOO":-2597,"OHI":451,"OIH":-296,"OKA":1851,"OKH":-1020,"OKK":904,"OOO":2965}; + this.BQ2__ = {"BHH":118,"BHI":-1159,"BHM":466,"BIH":-919,"BKK":-1720,"BKO":864,"OHH":-1139,"OHM":-181,"OIH":153,"UHI":-1146}; + this.BQ3__ = {"BHH":-792,"BHI":2664,"BII":-299,"BKI":419,"BMH":937,"BMM":8335,"BNN":998,"BOH":775,"OHH":2174,"OHM":439,"OII":280,"OKH":1798,"OKI":-793,"OKO":-2242,"OMH":-2402,"OOO":11699}; + this.BQ4__ = {"BHH":-3895,"BIH":3761,"BII":-4654,"BIK":1348,"BKK":-1806,"BMI":-3385,"BOO":-12396,"OAH":926,"OHH":266,"OHK":-2036,"ONN":-973}; + this.BW1__ = {",と":660,",同":727,"B1あ":1404,"B1同":542,"、と":660,"、同":727,"」と":1682,"あっ":1505,"いう":1743,"いっ":-2055,"いる":672,"うし":-4817,"うん":665,"から":3472,"がら":600,"こう":-790,"こと":2083,"こん":-1262,"さら":-4143,"さん":4573,"した":2641,"して":1104,"すで":-3399,"そこ":1977,"それ":-871,"たち":1122,"ため":601,"った":3463,"つい":-802,"てい":805,"てき":1249,"でき":1127,"です":3445,"では":844,"とい":-4915,"とみ":1922,"どこ":3887,"ない":5713,"なっ":3015,"など":7379,"なん":-1113,"にし":2468,"には":1498,"にも":1671,"に対":-912,"の一":-501,"の中":741,"ませ":2448,"まで":1711,"まま":2600,"まる":-2155,"やむ":-1947,"よっ":-2565,"れた":2369,"れで":-913,"をし":1860,"を見":731,"亡く":-1886,"京都":2558,"取り":-2784,"大き":-2604,"大阪":1497,"平方":-2314,"引き":-1336,"日本":-195,"本当":-2423,"毎日":-2113,"目指":-724,"Ｂ１あ":1404,"Ｂ１同":542,"｣と":1682}; + this.BW2__ = {"..":-11822,"11":-669,"――":-5730,"−−":-13175,"いう":-1609,"うか":2490,"かし":-1350,"かも":-602,"から":-7194,"かれ":4612,"がい":853,"がら":-3198,"きた":1941,"くな":-1597,"こと":-8392,"この":-4193,"させ":4533,"され":13168,"さん":-3977,"しい":-1819,"しか":-545,"した":5078,"して":972,"しな":939,"その":-3744,"たい":-1253,"たた":-662,"ただ":-3857,"たち":-786,"たと":1224,"たは":-939,"った":4589,"って":1647,"っと":-2094,"てい":6144,"てき":3640,"てく":2551,"ては":-3110,"ても":-3065,"でい":2666,"でき":-1528,"でし":-3828,"です":-4761,"でも":-4203,"とい":1890,"とこ":-1746,"とと":-2279,"との":720,"とみ":5168,"とも":-3941,"ない":-2488,"なが":-1313,"など":-6509,"なの":2614,"なん":3099,"にお":-1615,"にし":2748,"にな":2454,"によ":-7236,"に対":-14943,"に従":-4688,"に関":-11388,"のか":2093,"ので":-7059,"のに":-6041,"のの":-6125,"はい":1073,"はが":-1033,"はず":-2532,"ばれ":1813,"まし":-1316,"まで":-6621,"まれ":5409,"めて":-3153,"もい":2230,"もの":-10713,"らか":-944,"らし":-1611,"らに":-1897,"りし":651,"りま":1620,"れた":4270,"れて":849,"れば":4114,"ろう":6067,"われ":7901,"を通":-11877,"んだ":728,"んな":-4115,"一人":602,"一方":-1375,"一日":970,"一部":-1051,"上が":-4479,"会社":-1116,"出て":2163,"分の":-7758,"同党":970,"同日":-913,"大阪":-2471,"委員":-1250,"少な":-1050,"年度":-8669,"年間":-1626,"府県":-2363,"手権":-1982,"新聞":-4066,"日新":-722,"日本":-7068,"日米":3372,"曜日":-601,"朝鮮":-2355,"本人":-2697,"東京":-1543,"然と":-1384,"社会":-1276,"立て":-990,"第に":-1612,"米国":-4268,"１１":-669}; + this.BW3__ = {"あた":-2194,"あり":719,"ある":3846,"い.":-1185,"い。":-1185,"いい":5308,"いえ":2079,"いく":3029,"いた":2056,"いっ":1883,"いる":5600,"いわ":1527,"うち":1117,"うと":4798,"えと":1454,"か.":2857,"か。":2857,"かけ":-743,"かっ":-4098,"かに":-669,"から":6520,"かり":-2670,"が,":1816,"が、":1816,"がき":-4855,"がけ":-1127,"がっ":-913,"がら":-4977,"がり":-2064,"きた":1645,"けど":1374,"こと":7397,"この":1542,"ころ":-2757,"さい":-714,"さを":976,"し,":1557,"し、":1557,"しい":-3714,"した":3562,"して":1449,"しな":2608,"しま":1200,"す.":-1310,"す。":-1310,"する":6521,"ず,":3426,"ず、":3426,"ずに":841,"そう":428,"た.":8875,"た。":8875,"たい":-594,"たの":812,"たり":-1183,"たる":-853,"だ.":4098,"だ。":4098,"だっ":1004,"った":-4748,"って":300,"てい":6240,"てお":855,"ても":302,"です":1437,"でに":-1482,"では":2295,"とう":-1387,"とし":2266,"との":541,"とも":-3543,"どう":4664,"ない":1796,"なく":-903,"など":2135,"に,":-1021,"に、":-1021,"にし":1771,"にな":1906,"には":2644,"の,":-724,"の、":-724,"の子":-1000,"は,":1337,"は、":1337,"べき":2181,"まし":1113,"ます":6943,"まっ":-1549,"まで":6154,"まれ":-793,"らし":1479,"られ":6820,"るる":3818,"れ,":854,"れ、":854,"れた":1850,"れて":1375,"れば":-3246,"れる":1091,"われ":-605,"んだ":606,"んで":798,"カ月":990,"会議":860,"入り":1232,"大会":2217,"始め":1681,"市":965,"新聞":-5055,"日,":974,"日、":974,"社会":2024,"ｶ月":990}; + this.TC1__ = {"AAA":1093,"HHH":1029,"HHM":580,"HII":998,"HOH":-390,"HOM":-331,"IHI":1169,"IOH":-142,"IOI":-1015,"IOM":467,"MMH":187,"OOI":-1832}; + this.TC2__ = {"HHO":2088,"HII":-1023,"HMM":-1154,"IHI":-1965,"KKH":703,"OII":-2649}; + this.TC3__ = {"AAA":-294,"HHH":346,"HHI":-341,"HII":-1088,"HIK":731,"HOH":-1486,"IHH":128,"IHI":-3041,"IHO":-1935,"IIH":-825,"IIM":-1035,"IOI":-542,"KHH":-1216,"KKA":491,"KKH":-1217,"KOK":-1009,"MHH":-2694,"MHM":-457,"MHO":123,"MMH":-471,"NNH":-1689,"NNO":662,"OHO":-3393}; + this.TC4__ = {"HHH":-203,"HHI":1344,"HHK":365,"HHM":-122,"HHN":182,"HHO":669,"HIH":804,"HII":679,"HOH":446,"IHH":695,"IHO":-2324,"IIH":321,"III":1497,"IIO":656,"IOO":54,"KAK":4845,"KKA":3386,"KKK":3065,"MHH":-405,"MHI":201,"MMH":-241,"MMM":661,"MOM":841}; + this.TQ1__ = {"BHHH":-227,"BHHI":316,"BHIH":-132,"BIHH":60,"BIII":1595,"BNHH":-744,"BOHH":225,"BOOO":-908,"OAKK":482,"OHHH":281,"OHIH":249,"OIHI":200,"OIIH":-68}; + this.TQ2__ = {"BIHH":-1401,"BIII":-1033,"BKAK":-543,"BOOO":-5591}; + this.TQ3__ = {"BHHH":478,"BHHM":-1073,"BHIH":222,"BHII":-504,"BIIH":-116,"BIII":-105,"BMHI":-863,"BMHM":-464,"BOMH":620,"OHHH":346,"OHHI":1729,"OHII":997,"OHMH":481,"OIHH":623,"OIIH":1344,"OKAK":2792,"OKHH":587,"OKKA":679,"OOHH":110,"OOII":-685}; + this.TQ4__ = {"BHHH":-721,"BHHM":-3604,"BHII":-966,"BIIH":-607,"BIII":-2181,"OAAA":-2763,"OAKK":180,"OHHH":-294,"OHHI":2446,"OHHO":480,"OHIH":-1573,"OIHH":1935,"OIHI":-493,"OIIH":626,"OIII":-4007,"OKAK":-8156}; + this.TW1__ = {"につい":-4681,"東京都":2026}; + this.TW2__ = {"ある程":-2049,"いった":-1256,"ころが":-2434,"しょう":3873,"その後":-4430,"だって":-1049,"ていた":1833,"として":-4657,"ともに":-4517,"もので":1882,"一気に":-792,"初めて":-1512,"同時に":-8097,"大きな":-1255,"対して":-2721,"社会党":-3216}; + this.TW3__ = {"いただ":-1734,"してい":1314,"として":-4314,"につい":-5483,"にとっ":-5989,"に当た":-6247,"ので,":-727,"ので、":-727,"のもの":-600,"れから":-3752,"十二月":-2287}; + this.TW4__ = {"いう.":8576,"いう。":8576,"からな":-2348,"してい":2958,"たが,":1516,"たが、":1516,"ている":1538,"という":1349,"ました":5543,"ません":1097,"ようと":-4258,"よると":5865}; + this.UC1__ = {"A":484,"K":93,"M":645,"O":-505}; + this.UC2__ = {"A":819,"H":1059,"I":409,"M":3987,"N":5775,"O":646}; + this.UC3__ = {"A":-1370,"I":2311}; + this.UC4__ = {"A":-2643,"H":1809,"I":-1032,"K":-3450,"M":3565,"N":3876,"O":6646}; + this.UC5__ = {"H":313,"I":-1238,"K":-799,"M":539,"O":-831}; + this.UC6__ = {"H":-506,"I":-253,"K":87,"M":247,"O":-387}; + this.UP1__ = {"O":-214}; + this.UP2__ = {"B":69,"O":935}; + this.UP3__ = {"B":189}; + this.UQ1__ = {"BH":21,"BI":-12,"BK":-99,"BN":142,"BO":-56,"OH":-95,"OI":477,"OK":410,"OO":-2422}; + this.UQ2__ = {"BH":216,"BI":113,"OK":1759}; + this.UQ3__ = {"BA":-479,"BH":42,"BI":1913,"BK":-7198,"BM":3160,"BN":6427,"BO":14761,"OI":-827,"ON":-3212}; + this.UW1__ = {",":156,"、":156,"「":-463,"あ":-941,"う":-127,"が":-553,"き":121,"こ":505,"で":-201,"と":-547,"ど":-123,"に":-789,"の":-185,"は":-847,"も":-466,"や":-470,"よ":182,"ら":-292,"り":208,"れ":169,"を":-446,"ん":-137,"・":-135,"主":-402,"京":-268,"区":-912,"午":871,"国":-460,"大":561,"委":729,"市":-411,"日":-141,"理":361,"生":-408,"県":-386,"都":-718,"｢":-463,"･":-135}; + this.UW2__ = {",":-829,"、":-829,"〇":892,"「":-645,"」":3145,"あ":-538,"い":505,"う":134,"お":-502,"か":1454,"が":-856,"く":-412,"こ":1141,"さ":878,"ざ":540,"し":1529,"す":-675,"せ":300,"そ":-1011,"た":188,"だ":1837,"つ":-949,"て":-291,"で":-268,"と":-981,"ど":1273,"な":1063,"に":-1764,"の":130,"は":-409,"ひ":-1273,"べ":1261,"ま":600,"も":-1263,"や":-402,"よ":1639,"り":-579,"る":-694,"れ":571,"を":-2516,"ん":2095,"ア":-587,"カ":306,"キ":568,"ッ":831,"三":-758,"不":-2150,"世":-302,"中":-968,"主":-861,"事":492,"人":-123,"会":978,"保":362,"入":548,"初":-3025,"副":-1566,"北":-3414,"区":-422,"大":-1769,"天":-865,"太":-483,"子":-1519,"学":760,"実":1023,"小":-2009,"市":-813,"年":-1060,"強":1067,"手":-1519,"揺":-1033,"政":1522,"文":-1355,"新":-1682,"日":-1815,"明":-1462,"最":-630,"朝":-1843,"本":-1650,"東":-931,"果":-665,"次":-2378,"民":-180,"気":-1740,"理":752,"発":529,"目":-1584,"相":-242,"県":-1165,"立":-763,"第":810,"米":509,"自":-1353,"行":838,"西":-744,"見":-3874,"調":1010,"議":1198,"込":3041,"開":1758,"間":-1257,"｢":-645,"｣":3145,"ｯ":831,"ｱ":-587,"ｶ":306,"ｷ":568}; + this.UW3__ = {",":4889,"1":-800,"−":-1723,"、":4889,"々":-2311,"〇":5827,"」":2670,"〓":-3573,"あ":-2696,"い":1006,"う":2342,"え":1983,"お":-4864,"か":-1163,"が":3271,"く":1004,"け":388,"げ":401,"こ":-3552,"ご":-3116,"さ":-1058,"し":-395,"す":584,"せ":3685,"そ":-5228,"た":842,"ち":-521,"っ":-1444,"つ":-1081,"て":6167,"で":2318,"と":1691,"ど":-899,"な":-2788,"に":2745,"の":4056,"は":4555,"ひ":-2171,"ふ":-1798,"へ":1199,"ほ":-5516,"ま":-4384,"み":-120,"め":1205,"も":2323,"や":-788,"よ":-202,"ら":727,"り":649,"る":5905,"れ":2773,"わ":-1207,"を":6620,"ん":-518,"ア":551,"グ":1319,"ス":874,"ッ":-1350,"ト":521,"ム":1109,"ル":1591,"ロ":2201,"ン":278,"・":-3794,"一":-1619,"下":-1759,"世":-2087,"両":3815,"中":653,"主":-758,"予":-1193,"二":974,"人":2742,"今":792,"他":1889,"以":-1368,"低":811,"何":4265,"作":-361,"保":-2439,"元":4858,"党":3593,"全":1574,"公":-3030,"六":755,"共":-1880,"円":5807,"再":3095,"分":457,"初":2475,"別":1129,"前":2286,"副":4437,"力":365,"動":-949,"務":-1872,"化":1327,"北":-1038,"区":4646,"千":-2309,"午":-783,"協":-1006,"口":483,"右":1233,"各":3588,"合":-241,"同":3906,"和":-837,"員":4513,"国":642,"型":1389,"場":1219,"外":-241,"妻":2016,"学":-1356,"安":-423,"実":-1008,"家":1078,"小":-513,"少":-3102,"州":1155,"市":3197,"平":-1804,"年":2416,"広":-1030,"府":1605,"度":1452,"建":-2352,"当":-3885,"得":1905,"思":-1291,"性":1822,"戸":-488,"指":-3973,"政":-2013,"教":-1479,"数":3222,"文":-1489,"新":1764,"日":2099,"旧":5792,"昨":-661,"時":-1248,"曜":-951,"最":-937,"月":4125,"期":360,"李":3094,"村":364,"東":-805,"核":5156,"森":2438,"業":484,"氏":2613,"民":-1694,"決":-1073,"法":1868,"海":-495,"無":979,"物":461,"特":-3850,"生":-273,"用":914,"町":1215,"的":7313,"直":-1835,"省":792,"県":6293,"知":-1528,"私":4231,"税":401,"立":-960,"第":1201,"米":7767,"系":3066,"約":3663,"級":1384,"統":-4229,"総":1163,"線":1255,"者":6457,"能":725,"自":-2869,"英":785,"見":1044,"調":-562,"財":-733,"費":1777,"車":1835,"軍":1375,"込":-1504,"通":-1136,"選":-681,"郎":1026,"郡":4404,"部":1200,"金":2163,"長":421,"開":-1432,"間":1302,"関":-1282,"雨":2009,"電":-1045,"非":2066,"駅":1620,"１":-800,"｣":2670,"･":-3794,"ｯ":-1350,"ｱ":551,"ｸﾞ":1319,"ｽ":874,"ﾄ":521,"ﾑ":1109,"ﾙ":1591,"ﾛ":2201,"ﾝ":278}; + this.UW4__ = {",":3930,".":3508,"―":-4841,"、":3930,"。":3508,"〇":4999,"「":1895,"」":3798,"〓":-5156,"あ":4752,"い":-3435,"う":-640,"え":-2514,"お":2405,"か":530,"が":6006,"き":-4482,"ぎ":-3821,"く":-3788,"け":-4376,"げ":-4734,"こ":2255,"ご":1979,"さ":2864,"し":-843,"じ":-2506,"す":-731,"ず":1251,"せ":181,"そ":4091,"た":5034,"だ":5408,"ち":-3654,"っ":-5882,"つ":-1659,"て":3994,"で":7410,"と":4547,"な":5433,"に":6499,"ぬ":1853,"ね":1413,"の":7396,"は":8578,"ば":1940,"ひ":4249,"び":-4134,"ふ":1345,"へ":6665,"べ":-744,"ほ":1464,"ま":1051,"み":-2082,"む":-882,"め":-5046,"も":4169,"ゃ":-2666,"や":2795,"ょ":-1544,"よ":3351,"ら":-2922,"り":-9726,"る":-14896,"れ":-2613,"ろ":-4570,"わ":-1783,"を":13150,"ん":-2352,"カ":2145,"コ":1789,"セ":1287,"ッ":-724,"ト":-403,"メ":-1635,"ラ":-881,"リ":-541,"ル":-856,"ン":-3637,"・":-4371,"ー":-11870,"一":-2069,"中":2210,"予":782,"事":-190,"井":-1768,"人":1036,"以":544,"会":950,"体":-1286,"作":530,"側":4292,"先":601,"党":-2006,"共":-1212,"内":584,"円":788,"初":1347,"前":1623,"副":3879,"力":-302,"動":-740,"務":-2715,"化":776,"区":4517,"協":1013,"参":1555,"合":-1834,"和":-681,"員":-910,"器":-851,"回":1500,"国":-619,"園":-1200,"地":866,"場":-1410,"塁":-2094,"士":-1413,"多":1067,"大":571,"子":-4802,"学":-1397,"定":-1057,"寺":-809,"小":1910,"屋":-1328,"山":-1500,"島":-2056,"川":-2667,"市":2771,"年":374,"庁":-4556,"後":456,"性":553,"感":916,"所":-1566,"支":856,"改":787,"政":2182,"教":704,"文":522,"方":-856,"日":1798,"時":1829,"最":845,"月":-9066,"木":-485,"来":-442,"校":-360,"業":-1043,"氏":5388,"民":-2716,"気":-910,"沢":-939,"済":-543,"物":-735,"率":672,"球":-1267,"生":-1286,"産":-1101,"田":-2900,"町":1826,"的":2586,"目":922,"省":-3485,"県":2997,"空":-867,"立":-2112,"第":788,"米":2937,"系":786,"約":2171,"経":1146,"統":-1169,"総":940,"線":-994,"署":749,"者":2145,"能":-730,"般":-852,"行":-792,"規":792,"警":-1184,"議":-244,"谷":-1000,"賞":730,"車":-1481,"軍":1158,"輪":-1433,"込":-3370,"近":929,"道":-1291,"選":2596,"郎":-4866,"都":1192,"野":-1100,"銀":-2213,"長":357,"間":-2344,"院":-2297,"際":-2604,"電":-878,"領":-1659,"題":-792,"館":-1984,"首":1749,"高":2120,"｢":1895,"｣":3798,"･":-4371,"ｯ":-724,"ｰ":-11870,"ｶ":2145,"ｺ":1789,"ｾ":1287,"ﾄ":-403,"ﾒ":-1635,"ﾗ":-881,"ﾘ":-541,"ﾙ":-856,"ﾝ":-3637}; + this.UW5__ = {",":465,".":-299,"1":-514,"E2":-32768,"]":-2762,"、":465,"。":-299,"「":363,"あ":1655,"い":331,"う":-503,"え":1199,"お":527,"か":647,"が":-421,"き":1624,"ぎ":1971,"く":312,"げ":-983,"さ":-1537,"し":-1371,"す":-852,"だ":-1186,"ち":1093,"っ":52,"つ":921,"て":-18,"で":-850,"と":-127,"ど":1682,"な":-787,"に":-1224,"の":-635,"は":-578,"べ":1001,"み":502,"め":865,"ゃ":3350,"ょ":854,"り":-208,"る":429,"れ":504,"わ":419,"を":-1264,"ん":327,"イ":241,"ル":451,"ン":-343,"中":-871,"京":722,"会":-1153,"党":-654,"務":3519,"区":-901,"告":848,"員":2104,"大":-1296,"学":-548,"定":1785,"嵐":-1304,"市":-2991,"席":921,"年":1763,"思":872,"所":-814,"挙":1618,"新":-1682,"日":218,"月":-4353,"査":932,"格":1356,"機":-1508,"氏":-1347,"田":240,"町":-3912,"的":-3149,"相":1319,"省":-1052,"県":-4003,"研":-997,"社":-278,"空":-813,"統":1955,"者":-2233,"表":663,"語":-1073,"議":1219,"選":-1018,"郎":-368,"長":786,"間":1191,"題":2368,"館":-689,"１":-514,"Ｅ２":-32768,"｢":363,"ｲ":241,"ﾙ":451,"ﾝ":-343}; + this.UW6__ = {",":227,".":808,"1":-270,"E1":306,"、":227,"。":808,"あ":-307,"う":189,"か":241,"が":-73,"く":-121,"こ":-200,"じ":1782,"す":383,"た":-428,"っ":573,"て":-1014,"で":101,"と":-105,"な":-253,"に":-149,"の":-417,"は":-236,"も":-206,"り":187,"る":-135,"を":195,"ル":-673,"ン":-496,"一":-277,"中":201,"件":-800,"会":624,"前":302,"区":1792,"員":-1212,"委":798,"学":-960,"市":887,"広":-695,"後":535,"業":-697,"相":753,"社":-507,"福":974,"空":-822,"者":1811,"連":463,"郎":1082,"１":-270,"Ｅ１":306,"ﾙ":-673,"ﾝ":-496}; + + return this; + } + TinySegmenter.prototype.ctype_ = function(str) { + for (var i in this.chartype_) { + if (str.match(this.chartype_[i][0])) { + return this.chartype_[i][1]; + } + } + return "O"; + } + + TinySegmenter.prototype.ts_ = function(v) { + if (v) { return v; } + return 0; + } + + TinySegmenter.prototype.segment = function(input) { + if (input == null || input == undefined || input == "") { + return []; + } + var result = []; + var seg = ["B3","B2","B1"]; + var ctype = ["O","O","O"]; + var o = input.split(""); + for (i = 0; i < o.length; ++i) { + seg.push(o[i]); + ctype.push(this.ctype_(o[i])) + } + seg.push("E1"); + seg.push("E2"); + seg.push("E3"); + ctype.push("O"); + ctype.push("O"); + ctype.push("O"); + var word = seg[3]; + var p1 = "U"; + var p2 = "U"; + var p3 = "U"; + for (var i = 4; i < seg.length - 3; ++i) { + var score = this.BIAS__; + var w1 = seg[i-3]; + var w2 = seg[i-2]; + var w3 = seg[i-1]; + var w4 = seg[i]; + var w5 = seg[i+1]; + var w6 = seg[i+2]; + var c1 = ctype[i-3]; + var c2 = ctype[i-2]; + var c3 = ctype[i-1]; + var c4 = ctype[i]; + var c5 = ctype[i+1]; + var c6 = ctype[i+2]; + score += this.ts_(this.UP1__[p1]); + score += this.ts_(this.UP2__[p2]); + score += this.ts_(this.UP3__[p3]); + score += this.ts_(this.BP1__[p1 + p2]); + score += this.ts_(this.BP2__[p2 + p3]); + score += this.ts_(this.UW1__[w1]); + score += this.ts_(this.UW2__[w2]); + score += this.ts_(this.UW3__[w3]); + score += this.ts_(this.UW4__[w4]); + score += this.ts_(this.UW5__[w5]); + score += this.ts_(this.UW6__[w6]); + score += this.ts_(this.BW1__[w2 + w3]); + score += this.ts_(this.BW2__[w3 + w4]); + score += this.ts_(this.BW3__[w4 + w5]); + score += this.ts_(this.TW1__[w1 + w2 + w3]); + score += this.ts_(this.TW2__[w2 + w3 + w4]); + score += this.ts_(this.TW3__[w3 + w4 + w5]); + score += this.ts_(this.TW4__[w4 + w5 + w6]); + score += this.ts_(this.UC1__[c1]); + score += this.ts_(this.UC2__[c2]); + score += this.ts_(this.UC3__[c3]); + score += this.ts_(this.UC4__[c4]); + score += this.ts_(this.UC5__[c5]); + score += this.ts_(this.UC6__[c6]); + score += this.ts_(this.BC1__[c2 + c3]); + score += this.ts_(this.BC2__[c3 + c4]); + score += this.ts_(this.BC3__[c4 + c5]); + score += this.ts_(this.TC1__[c1 + c2 + c3]); + score += this.ts_(this.TC2__[c2 + c3 + c4]); + score += this.ts_(this.TC3__[c3 + c4 + c5]); + score += this.ts_(this.TC4__[c4 + c5 + c6]); + // score += this.ts_(this.TC5__[c4 + c5 + c6]); + score += this.ts_(this.UQ1__[p1 + c1]); + score += this.ts_(this.UQ2__[p2 + c2]); + score += this.ts_(this.UQ3__[p3 + c3]); + score += this.ts_(this.BQ1__[p2 + c2 + c3]); + score += this.ts_(this.BQ2__[p2 + c3 + c4]); + score += this.ts_(this.BQ3__[p3 + c2 + c3]); + score += this.ts_(this.BQ4__[p3 + c3 + c4]); + score += this.ts_(this.TQ1__[p2 + c1 + c2 + c3]); + score += this.ts_(this.TQ2__[p2 + c2 + c3 + c4]); + score += this.ts_(this.TQ3__[p3 + c1 + c2 + c3]); + score += this.ts_(this.TQ4__[p3 + c2 + c3 + c4]); + var p = "O"; + if (score > 0) { + result.push(word); + word = ""; + p = "B"; + } + p1 = p2; + p2 = p3; + p3 = p; + word += seg[i]; + } + result.push(word); + + return result; + } + + lunr.TinySegmenter = TinySegmenter; + }; + +})); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/lunr/wordcut.js b/3.25.0/assets/javascripts/lunr/wordcut.js new file mode 100644 index 0000000000..146f4b44bc --- /dev/null +++ b/3.25.0/assets/javascripts/lunr/wordcut.js @@ -0,0 +1,6708 @@ +(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}(g.lunr || (g.lunr = {})).wordcut = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o 1; + }) + this.addWords(words, false) + } + if(finalize){ + this.finalizeDict(); + } + }, + + dictSeek: function (l, r, ch, strOffset, pos) { + var ans = null; + while (l <= r) { + var m = Math.floor((l + r) / 2), + dict_item = this.dict[m], + len = dict_item.length; + if (len <= strOffset) { + l = m + 1; + } else { + var ch_ = dict_item[strOffset]; + if (ch_ < ch) { + l = m + 1; + } else if (ch_ > ch) { + r = m - 1; + } else { + ans = m; + if (pos == LEFT) { + r = m - 1; + } else { + l = m + 1; + } + } + } + } + return ans; + }, + + isFinal: function (acceptor) { + return this.dict[acceptor.l].length == acceptor.strOffset; + }, + + createAcceptor: function () { + return { + l: 0, + r: this.dict.length - 1, + strOffset: 0, + isFinal: false, + dict: this, + transit: function (ch) { + return this.dict.transit(this, ch); + }, + isError: false, + tag: "DICT", + w: 1, + type: "DICT" + }; + }, + + transit: function (acceptor, ch) { + var l = this.dictSeek(acceptor.l, + acceptor.r, + ch, + acceptor.strOffset, + LEFT); + if (l !== null) { + var r = this.dictSeek(l, + acceptor.r, + ch, + acceptor.strOffset, + RIGHT); + acceptor.l = l; + acceptor.r = r; + acceptor.strOffset++; + acceptor.isFinal = this.isFinal(acceptor); + } else { + acceptor.isError = true; + } + return acceptor; + }, + + sortuniq: function(a){ + return a.sort().filter(function(item, pos, arr){ + return !pos || item != arr[pos - 1]; + }) + }, + + flatten: function(a){ + //[[1,2],[3]] -> [1,2,3] + return [].concat.apply([], a); + } +}; +module.exports = WordcutDict; + +}).call(this,"/dist/tmp") +},{"glob":16,"path":22}],3:[function(require,module,exports){ +var WordRule = { + createAcceptor: function(tag) { + if (tag["WORD_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + var lch = ch.toLowerCase(); + if (lch >= "a" && lch <= "z") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "WORD_RULE", + type: "WORD_RULE", + w: 1}; + } +}; + +var NumberRule = { + createAcceptor: function(tag) { + if (tag["NUMBER_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch >= "0" && ch <= "9") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "NUMBER_RULE", + type: "NUMBER_RULE", + w: 1}; + } +}; + +var SpaceRule = { + tag: "SPACE_RULE", + createAcceptor: function(tag) { + + if (tag["SPACE_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch == " " || ch == "\t" || ch == "\r" || ch == "\n" || + ch == "\u00A0" || ch=="\u2003"//nbsp and emsp + ) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: SpaceRule.tag, + w: 1, + type: "SPACE_RULE"}; + } +} + +var SingleSymbolRule = { + tag: "SINSYM", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (this.strOffset == 0 && ch.match(/^[\@\(\)\/\,\-\."`]$/)) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "SINSYM", + w: 1, + type: "SINSYM"}; + } +} + + +var LatinRules = [WordRule, SpaceRule, SingleSymbolRule, NumberRule]; + +module.exports = LatinRules; + +},{}],4:[function(require,module,exports){ +var _ = require("underscore") + , WordcutCore = require("./wordcut_core"); +var PathInfoBuilder = { + + /* + buildByPartAcceptors: function(path, acceptors, i) { + var + var genInfos = partAcceptors.reduce(function(genInfos, acceptor) { + + }, []); + + return genInfos; + } + */ + + buildByAcceptors: function(path, finalAcceptors, i) { + var self = this; + var infos = finalAcceptors.map(function(acceptor) { + var p = i - acceptor.strOffset + 1 + , _info = path[p]; + + var info = {p: p, + mw: _info.mw + (acceptor.mw === undefined ? 0 : acceptor.mw), + w: acceptor.w + _info.w, + unk: (acceptor.unk ? acceptor.unk : 0) + _info.unk, + type: acceptor.type}; + + if (acceptor.type == "PART") { + for(var j = p + 1; j <= i; j++) { + path[j].merge = p; + } + info.merge = p; + } + + return info; + }); + return infos.filter(function(info) { return info; }); + }, + + fallback: function(path, leftBoundary, text, i) { + var _info = path[leftBoundary]; + if (text[i].match(/[\u0E48-\u0E4E]/)) { + if (leftBoundary != 0) + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + mw: 0, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; +/* } else if(leftBoundary > 0 && path[leftBoundary].type !== "UNK") { + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; */ + } else { + return {p: leftBoundary, + mw: _info.mw, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; + } + }, + + build: function(path, finalAcceptors, i, leftBoundary, text) { + var basicPathInfos = this.buildByAcceptors(path, finalAcceptors, i); + if (basicPathInfos.length > 0) { + return basicPathInfos; + } else { + return [this.fallback(path, leftBoundary, text, i)]; + } + } +}; + +module.exports = function() { + return _.clone(PathInfoBuilder); +} + +},{"./wordcut_core":8,"underscore":25}],5:[function(require,module,exports){ +var _ = require("underscore"); + + +var PathSelector = { + selectPath: function(paths) { + var path = paths.reduce(function(selectedPath, path) { + if (selectedPath == null) { + return path; + } else { + if (path.unk < selectedPath.unk) + return path; + if (path.unk == selectedPath.unk) { + if (path.mw < selectedPath.mw) + return path + if (path.mw == selectedPath.mw) { + if (path.w < selectedPath.w) + return path; + } + } + return selectedPath; + } + }, null); + return path; + }, + + createPath: function() { + return [{p:null, w:0, unk:0, type: "INIT", mw:0}]; + } +}; + +module.exports = function() { + return _.clone(PathSelector); +}; + +},{"underscore":25}],6:[function(require,module,exports){ +function isMatch(pat, offset, ch) { + if (pat.length <= offset) + return false; + var _ch = pat[offset]; + return _ch == ch || + (_ch.match(/[กข]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/[มบ]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/\u0E49/) && ch.match(/[\u0E48-\u0E4B]/)); +} + +var Rule0 = { + pat: "เหก็ม", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (isMatch(Rule0.pat, this.strOffset,ch)) { + this.isFinal = (this.strOffset + 1 == Rule0.pat.length); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "THAI_RULE", + type: "THAI_RULE", + w: 1}; + } +}; + +var PartRule = { + createAcceptor: function(tag) { + return {strOffset: 0, + patterns: [ + "แก", "เก", "ก้", "กก์", "กา", "กี", "กิ", "กืก" + ], + isFinal: false, + transit: function(ch) { + var offset = this.strOffset; + this.patterns = this.patterns.filter(function(pat) { + return isMatch(pat, offset, ch); + }); + + if (this.patterns.length > 0) { + var len = 1 + offset; + this.isFinal = this.patterns.some(function(pat) { + return pat.length == len; + }); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "PART", + type: "PART", + unk: 1, + w: 1}; + } +}; + +var ThaiRules = [Rule0, PartRule]; + +module.exports = ThaiRules; + +},{}],7:[function(require,module,exports){ +var sys = require("sys") + , WordcutDict = require("./dict") + , WordcutCore = require("./wordcut_core") + , PathInfoBuilder = require("./path_info_builder") + , PathSelector = require("./path_selector") + , Acceptors = require("./acceptors") + , latinRules = require("./latin_rules") + , thaiRules = require("./thai_rules") + , _ = require("underscore"); + + +var Wordcut = Object.create(WordcutCore); +Wordcut.defaultPathInfoBuilder = PathInfoBuilder; +Wordcut.defaultPathSelector = PathSelector; +Wordcut.defaultAcceptors = Acceptors; +Wordcut.defaultLatinRules = latinRules; +Wordcut.defaultThaiRules = thaiRules; +Wordcut.defaultDict = WordcutDict; + + +Wordcut.initNoDict = function(dict_path) { + var self = this; + self.pathInfoBuilder = new self.defaultPathInfoBuilder; + self.pathSelector = new self.defaultPathSelector; + self.acceptors = new self.defaultAcceptors; + self.defaultLatinRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); + self.defaultThaiRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); +}; + +Wordcut.init = function(dict_path, withDefault, additionalWords) { + withDefault = withDefault || false; + this.initNoDict(); + var dict = _.clone(this.defaultDict); + dict.init(dict_path, withDefault, additionalWords); + this.acceptors.creators.push(dict); +}; + +module.exports = Wordcut; + +},{"./acceptors":1,"./dict":2,"./latin_rules":3,"./path_info_builder":4,"./path_selector":5,"./thai_rules":6,"./wordcut_core":8,"sys":28,"underscore":25}],8:[function(require,module,exports){ +var WordcutCore = { + + buildPath: function(text) { + var self = this + , path = self.pathSelector.createPath() + , leftBoundary = 0; + self.acceptors.reset(); + for (var i = 0; i < text.length; i++) { + var ch = text[i]; + self.acceptors.transit(ch); + + var possiblePathInfos = self + .pathInfoBuilder + .build(path, + self.acceptors.getFinalAcceptors(), + i, + leftBoundary, + text); + var selectedPath = self.pathSelector.selectPath(possiblePathInfos) + + path.push(selectedPath); + if (selectedPath.type !== "UNK") { + leftBoundary = i; + } + } + return path; + }, + + pathToRanges: function(path) { + var e = path.length - 1 + , ranges = []; + + while (e > 0) { + var info = path[e] + , s = info.p; + + if (info.merge !== undefined && ranges.length > 0) { + var r = ranges[ranges.length - 1]; + r.s = info.merge; + s = r.s; + } else { + ranges.push({s:s, e:e}); + } + e = s; + } + return ranges.reverse(); + }, + + rangesToText: function(text, ranges, delimiter) { + return ranges.map(function(r) { + return text.substring(r.s, r.e); + }).join(delimiter); + }, + + cut: function(text, delimiter) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + return this + .rangesToText(text, ranges, + (delimiter === undefined ? "|" : delimiter)); + }, + + cutIntoRanges: function(text, noText) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + if (!noText) { + ranges.forEach(function(r) { + r.text = text.substring(r.s, r.e); + }); + } + return ranges; + }, + + cutIntoArray: function(text) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + return ranges.map(function(r) { + return text.substring(r.s, r.e) + }); + } +}; + +module.exports = WordcutCore; + +},{}],9:[function(require,module,exports){ +// http://wiki.commonjs.org/wiki/Unit_Testing/1.0 +// +// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8! +// +// Originally from narwhal.js (http://narwhaljs.org) +// Copyright (c) 2009 Thomas Robinson <280north.com> +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the 'Software'), to +// deal in the Software without restriction, including without limitation the +// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +// sell copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// when used in node, this will actually load the util module we depend on +// versus loading the builtin util module as happens otherwise +// this is a bug in node module loading as far as I am concerned +var util = require('util/'); + +var pSlice = Array.prototype.slice; +var hasOwn = Object.prototype.hasOwnProperty; + +// 1. The assert module provides functions that throw +// AssertionError's when particular conditions are not met. The +// assert module must conform to the following interface. + +var assert = module.exports = ok; + +// 2. The AssertionError is defined in assert. +// new assert.AssertionError({ message: message, +// actual: actual, +// expected: expected }) + +assert.AssertionError = function AssertionError(options) { + this.name = 'AssertionError'; + this.actual = options.actual; + this.expected = options.expected; + this.operator = options.operator; + if (options.message) { + this.message = options.message; + this.generatedMessage = false; + } else { + this.message = getMessage(this); + this.generatedMessage = true; + } + var stackStartFunction = options.stackStartFunction || fail; + + if (Error.captureStackTrace) { + Error.captureStackTrace(this, stackStartFunction); + } + else { + // non v8 browsers so we can have a stacktrace + var err = new Error(); + if (err.stack) { + var out = err.stack; + + // try to strip useless frames + var fn_name = stackStartFunction.name; + var idx = out.indexOf('\n' + fn_name); + if (idx >= 0) { + // once we have located the function frame + // we need to strip out everything before it (and its line) + var next_line = out.indexOf('\n', idx + 1); + out = out.substring(next_line + 1); + } + + this.stack = out; + } + } +}; + +// assert.AssertionError instanceof Error +util.inherits(assert.AssertionError, Error); + +function replacer(key, value) { + if (util.isUndefined(value)) { + return '' + value; + } + if (util.isNumber(value) && !isFinite(value)) { + return value.toString(); + } + if (util.isFunction(value) || util.isRegExp(value)) { + return value.toString(); + } + return value; +} + +function truncate(s, n) { + if (util.isString(s)) { + return s.length < n ? s : s.slice(0, n); + } else { + return s; + } +} + +function getMessage(self) { + return truncate(JSON.stringify(self.actual, replacer), 128) + ' ' + + self.operator + ' ' + + truncate(JSON.stringify(self.expected, replacer), 128); +} + +// At present only the three keys mentioned above are used and +// understood by the spec. Implementations or sub modules can pass +// other keys to the AssertionError's constructor - they will be +// ignored. + +// 3. All of the following functions must throw an AssertionError +// when a corresponding condition is not met, with a message that +// may be undefined if not provided. All assertion methods provide +// both the actual and expected values to the assertion error for +// display purposes. + +function fail(actual, expected, message, operator, stackStartFunction) { + throw new assert.AssertionError({ + message: message, + actual: actual, + expected: expected, + operator: operator, + stackStartFunction: stackStartFunction + }); +} + +// EXTENSION! allows for well behaved errors defined elsewhere. +assert.fail = fail; + +// 4. Pure assertion tests whether a value is truthy, as determined +// by !!guard. +// assert.ok(guard, message_opt); +// This statement is equivalent to assert.equal(true, !!guard, +// message_opt);. To test strictly for the value true, use +// assert.strictEqual(true, guard, message_opt);. + +function ok(value, message) { + if (!value) fail(value, true, message, '==', assert.ok); +} +assert.ok = ok; + +// 5. The equality assertion tests shallow, coercive equality with +// ==. +// assert.equal(actual, expected, message_opt); + +assert.equal = function equal(actual, expected, message) { + if (actual != expected) fail(actual, expected, message, '==', assert.equal); +}; + +// 6. The non-equality assertion tests for whether two objects are not equal +// with != assert.notEqual(actual, expected, message_opt); + +assert.notEqual = function notEqual(actual, expected, message) { + if (actual == expected) { + fail(actual, expected, message, '!=', assert.notEqual); + } +}; + +// 7. The equivalence assertion tests a deep equality relation. +// assert.deepEqual(actual, expected, message_opt); + +assert.deepEqual = function deepEqual(actual, expected, message) { + if (!_deepEqual(actual, expected)) { + fail(actual, expected, message, 'deepEqual', assert.deepEqual); + } +}; + +function _deepEqual(actual, expected) { + // 7.1. All identical values are equivalent, as determined by ===. + if (actual === expected) { + return true; + + } else if (util.isBuffer(actual) && util.isBuffer(expected)) { + if (actual.length != expected.length) return false; + + for (var i = 0; i < actual.length; i++) { + if (actual[i] !== expected[i]) return false; + } + + return true; + + // 7.2. If the expected value is a Date object, the actual value is + // equivalent if it is also a Date object that refers to the same time. + } else if (util.isDate(actual) && util.isDate(expected)) { + return actual.getTime() === expected.getTime(); + + // 7.3 If the expected value is a RegExp object, the actual value is + // equivalent if it is also a RegExp object with the same source and + // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`). + } else if (util.isRegExp(actual) && util.isRegExp(expected)) { + return actual.source === expected.source && + actual.global === expected.global && + actual.multiline === expected.multiline && + actual.lastIndex === expected.lastIndex && + actual.ignoreCase === expected.ignoreCase; + + // 7.4. Other pairs that do not both pass typeof value == 'object', + // equivalence is determined by ==. + } else if (!util.isObject(actual) && !util.isObject(expected)) { + return actual == expected; + + // 7.5 For all other Object pairs, including Array objects, equivalence is + // determined by having the same number of owned properties (as verified + // with Object.prototype.hasOwnProperty.call), the same set of keys + // (although not necessarily the same order), equivalent values for every + // corresponding key, and an identical 'prototype' property. Note: this + // accounts for both named and indexed properties on Arrays. + } else { + return objEquiv(actual, expected); + } +} + +function isArguments(object) { + return Object.prototype.toString.call(object) == '[object Arguments]'; +} + +function objEquiv(a, b) { + if (util.isNullOrUndefined(a) || util.isNullOrUndefined(b)) + return false; + // an identical 'prototype' property. + if (a.prototype !== b.prototype) return false; + // if one is a primitive, the other must be same + if (util.isPrimitive(a) || util.isPrimitive(b)) { + return a === b; + } + var aIsArgs = isArguments(a), + bIsArgs = isArguments(b); + if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs)) + return false; + if (aIsArgs) { + a = pSlice.call(a); + b = pSlice.call(b); + return _deepEqual(a, b); + } + var ka = objectKeys(a), + kb = objectKeys(b), + key, i; + // having the same number of owned properties (keys incorporates + // hasOwnProperty) + if (ka.length != kb.length) + return false; + //the same set of keys (although not necessarily the same order), + ka.sort(); + kb.sort(); + //~~~cheap key test + for (i = ka.length - 1; i >= 0; i--) { + if (ka[i] != kb[i]) + return false; + } + //equivalent values for every corresponding key, and + //~~~possibly expensive deep test + for (i = ka.length - 1; i >= 0; i--) { + key = ka[i]; + if (!_deepEqual(a[key], b[key])) return false; + } + return true; +} + +// 8. The non-equivalence assertion tests for any deep inequality. +// assert.notDeepEqual(actual, expected, message_opt); + +assert.notDeepEqual = function notDeepEqual(actual, expected, message) { + if (_deepEqual(actual, expected)) { + fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual); + } +}; + +// 9. The strict equality assertion tests strict equality, as determined by ===. +// assert.strictEqual(actual, expected, message_opt); + +assert.strictEqual = function strictEqual(actual, expected, message) { + if (actual !== expected) { + fail(actual, expected, message, '===', assert.strictEqual); + } +}; + +// 10. The strict non-equality assertion tests for strict inequality, as +// determined by !==. assert.notStrictEqual(actual, expected, message_opt); + +assert.notStrictEqual = function notStrictEqual(actual, expected, message) { + if (actual === expected) { + fail(actual, expected, message, '!==', assert.notStrictEqual); + } +}; + +function expectedException(actual, expected) { + if (!actual || !expected) { + return false; + } + + if (Object.prototype.toString.call(expected) == '[object RegExp]') { + return expected.test(actual); + } else if (actual instanceof expected) { + return true; + } else if (expected.call({}, actual) === true) { + return true; + } + + return false; +} + +function _throws(shouldThrow, block, expected, message) { + var actual; + + if (util.isString(expected)) { + message = expected; + expected = null; + } + + try { + block(); + } catch (e) { + actual = e; + } + + message = (expected && expected.name ? ' (' + expected.name + ').' : '.') + + (message ? ' ' + message : '.'); + + if (shouldThrow && !actual) { + fail(actual, expected, 'Missing expected exception' + message); + } + + if (!shouldThrow && expectedException(actual, expected)) { + fail(actual, expected, 'Got unwanted exception' + message); + } + + if ((shouldThrow && actual && expected && + !expectedException(actual, expected)) || (!shouldThrow && actual)) { + throw actual; + } +} + +// 11. Expected to throw an error: +// assert.throws(block, Error_opt, message_opt); + +assert.throws = function(block, /*optional*/error, /*optional*/message) { + _throws.apply(this, [true].concat(pSlice.call(arguments))); +}; + +// EXTENSION! This is annoying to write outside this module. +assert.doesNotThrow = function(block, /*optional*/message) { + _throws.apply(this, [false].concat(pSlice.call(arguments))); +}; + +assert.ifError = function(err) { if (err) {throw err;}}; + +var objectKeys = Object.keys || function (obj) { + var keys = []; + for (var key in obj) { + if (hasOwn.call(obj, key)) keys.push(key); + } + return keys; +}; + +},{"util/":28}],10:[function(require,module,exports){ +'use strict'; +module.exports = balanced; +function balanced(a, b, str) { + if (a instanceof RegExp) a = maybeMatch(a, str); + if (b instanceof RegExp) b = maybeMatch(b, str); + + var r = range(a, b, str); + + return r && { + start: r[0], + end: r[1], + pre: str.slice(0, r[0]), + body: str.slice(r[0] + a.length, r[1]), + post: str.slice(r[1] + b.length) + }; +} + +function maybeMatch(reg, str) { + var m = str.match(reg); + return m ? m[0] : null; +} + +balanced.range = range; +function range(a, b, str) { + var begs, beg, left, right, result; + var ai = str.indexOf(a); + var bi = str.indexOf(b, ai + 1); + var i = ai; + + if (ai >= 0 && bi > 0) { + begs = []; + left = str.length; + + while (i >= 0 && !result) { + if (i == ai) { + begs.push(i); + ai = str.indexOf(a, i + 1); + } else if (begs.length == 1) { + result = [ begs.pop(), bi ]; + } else { + beg = begs.pop(); + if (beg < left) { + left = beg; + right = bi; + } + + bi = str.indexOf(b, i + 1); + } + + i = ai < bi && ai >= 0 ? ai : bi; + } + + if (begs.length) { + result = [ left, right ]; + } + } + + return result; +} + +},{}],11:[function(require,module,exports){ +var concatMap = require('concat-map'); +var balanced = require('balanced-match'); + +module.exports = expandTop; + +var escSlash = '\0SLASH'+Math.random()+'\0'; +var escOpen = '\0OPEN'+Math.random()+'\0'; +var escClose = '\0CLOSE'+Math.random()+'\0'; +var escComma = '\0COMMA'+Math.random()+'\0'; +var escPeriod = '\0PERIOD'+Math.random()+'\0'; + +function numeric(str) { + return parseInt(str, 10) == str + ? parseInt(str, 10) + : str.charCodeAt(0); +} + +function escapeBraces(str) { + return str.split('\\\\').join(escSlash) + .split('\\{').join(escOpen) + .split('\\}').join(escClose) + .split('\\,').join(escComma) + .split('\\.').join(escPeriod); +} + +function unescapeBraces(str) { + return str.split(escSlash).join('\\') + .split(escOpen).join('{') + .split(escClose).join('}') + .split(escComma).join(',') + .split(escPeriod).join('.'); +} + + +// Basically just str.split(","), but handling cases +// where we have nested braced sections, which should be +// treated as individual members, like {a,{b,c},d} +function parseCommaParts(str) { + if (!str) + return ['']; + + var parts = []; + var m = balanced('{', '}', str); + + if (!m) + return str.split(','); + + var pre = m.pre; + var body = m.body; + var post = m.post; + var p = pre.split(','); + + p[p.length-1] += '{' + body + '}'; + var postParts = parseCommaParts(post); + if (post.length) { + p[p.length-1] += postParts.shift(); + p.push.apply(p, postParts); + } + + parts.push.apply(parts, p); + + return parts; +} + +function expandTop(str) { + if (!str) + return []; + + // I don't know why Bash 4.3 does this, but it does. + // Anything starting with {} will have the first two bytes preserved + // but *only* at the top level, so {},a}b will not expand to anything, + // but a{},b}c will be expanded to [a}c,abc]. + // One could argue that this is a bug in Bash, but since the goal of + // this module is to match Bash's rules, we escape a leading {} + if (str.substr(0, 2) === '{}') { + str = '\\{\\}' + str.substr(2); + } + + return expand(escapeBraces(str), true).map(unescapeBraces); +} + +function identity(e) { + return e; +} + +function embrace(str) { + return '{' + str + '}'; +} +function isPadded(el) { + return /^-?0\d/.test(el); +} + +function lte(i, y) { + return i <= y; +} +function gte(i, y) { + return i >= y; +} + +function expand(str, isTop) { + var expansions = []; + + var m = balanced('{', '}', str); + if (!m || /\$$/.test(m.pre)) return [str]; + + var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body); + var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body); + var isSequence = isNumericSequence || isAlphaSequence; + var isOptions = m.body.indexOf(',') >= 0; + if (!isSequence && !isOptions) { + // {a},b} + if (m.post.match(/,.*\}/)) { + str = m.pre + '{' + m.body + escClose + m.post; + return expand(str); + } + return [str]; + } + + var n; + if (isSequence) { + n = m.body.split(/\.\./); + } else { + n = parseCommaParts(m.body); + if (n.length === 1) { + // x{{a,b}}y ==> x{a}y x{b}y + n = expand(n[0], false).map(embrace); + if (n.length === 1) { + var post = m.post.length + ? expand(m.post, false) + : ['']; + return post.map(function(p) { + return m.pre + n[0] + p; + }); + } + } + } + + // at this point, n is the parts, and we know it's not a comma set + // with a single entry. + + // no need to expand pre, since it is guaranteed to be free of brace-sets + var pre = m.pre; + var post = m.post.length + ? expand(m.post, false) + : ['']; + + var N; + + if (isSequence) { + var x = numeric(n[0]); + var y = numeric(n[1]); + var width = Math.max(n[0].length, n[1].length) + var incr = n.length == 3 + ? Math.abs(numeric(n[2])) + : 1; + var test = lte; + var reverse = y < x; + if (reverse) { + incr *= -1; + test = gte; + } + var pad = n.some(isPadded); + + N = []; + + for (var i = x; test(i, y); i += incr) { + var c; + if (isAlphaSequence) { + c = String.fromCharCode(i); + if (c === '\\') + c = ''; + } else { + c = String(i); + if (pad) { + var need = width - c.length; + if (need > 0) { + var z = new Array(need + 1).join('0'); + if (i < 0) + c = '-' + z + c.slice(1); + else + c = z + c; + } + } + } + N.push(c); + } + } else { + N = concatMap(n, function(el) { return expand(el, false) }); + } + + for (var j = 0; j < N.length; j++) { + for (var k = 0; k < post.length; k++) { + var expansion = pre + N[j] + post[k]; + if (!isTop || isSequence || expansion) + expansions.push(expansion); + } + } + + return expansions; +} + + +},{"balanced-match":10,"concat-map":13}],12:[function(require,module,exports){ + +},{}],13:[function(require,module,exports){ +module.exports = function (xs, fn) { + var res = []; + for (var i = 0; i < xs.length; i++) { + var x = fn(xs[i], i); + if (isArray(x)) res.push.apply(res, x); + else res.push(x); + } + return res; +}; + +var isArray = Array.isArray || function (xs) { + return Object.prototype.toString.call(xs) === '[object Array]'; +}; + +},{}],14:[function(require,module,exports){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +function EventEmitter() { + this._events = this._events || {}; + this._maxListeners = this._maxListeners || undefined; +} +module.exports = EventEmitter; + +// Backwards-compat with node 0.10.x +EventEmitter.EventEmitter = EventEmitter; + +EventEmitter.prototype._events = undefined; +EventEmitter.prototype._maxListeners = undefined; + +// By default EventEmitters will print a warning if more than 10 listeners are +// added to it. This is a useful default which helps finding memory leaks. +EventEmitter.defaultMaxListeners = 10; + +// Obviously not all Emitters should be limited to 10. This function allows +// that to be increased. Set to zero for unlimited. +EventEmitter.prototype.setMaxListeners = function(n) { + if (!isNumber(n) || n < 0 || isNaN(n)) + throw TypeError('n must be a positive number'); + this._maxListeners = n; + return this; +}; + +EventEmitter.prototype.emit = function(type) { + var er, handler, len, args, i, listeners; + + if (!this._events) + this._events = {}; + + // If there is no 'error' event listener then throw. + if (type === 'error') { + if (!this._events.error || + (isObject(this._events.error) && !this._events.error.length)) { + er = arguments[1]; + if (er instanceof Error) { + throw er; // Unhandled 'error' event + } + throw TypeError('Uncaught, unspecified "error" event.'); + } + } + + handler = this._events[type]; + + if (isUndefined(handler)) + return false; + + if (isFunction(handler)) { + switch (arguments.length) { + // fast cases + case 1: + handler.call(this); + break; + case 2: + handler.call(this, arguments[1]); + break; + case 3: + handler.call(this, arguments[1], arguments[2]); + break; + // slower + default: + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + handler.apply(this, args); + } + } else if (isObject(handler)) { + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + + listeners = handler.slice(); + len = listeners.length; + for (i = 0; i < len; i++) + listeners[i].apply(this, args); + } + + return true; +}; + +EventEmitter.prototype.addListener = function(type, listener) { + var m; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events) + this._events = {}; + + // To avoid recursion in the case that type === "newListener"! Before + // adding it to the listeners, first emit "newListener". + if (this._events.newListener) + this.emit('newListener', type, + isFunction(listener.listener) ? + listener.listener : listener); + + if (!this._events[type]) + // Optimize the case of one listener. Don't need the extra array object. + this._events[type] = listener; + else if (isObject(this._events[type])) + // If we've already got an array, just append. + this._events[type].push(listener); + else + // Adding the second element, need to change to array. + this._events[type] = [this._events[type], listener]; + + // Check for listener leak + if (isObject(this._events[type]) && !this._events[type].warned) { + var m; + if (!isUndefined(this._maxListeners)) { + m = this._maxListeners; + } else { + m = EventEmitter.defaultMaxListeners; + } + + if (m && m > 0 && this._events[type].length > m) { + this._events[type].warned = true; + console.error('(node) warning: possible EventEmitter memory ' + + 'leak detected. %d listeners added. ' + + 'Use emitter.setMaxListeners() to increase limit.', + this._events[type].length); + if (typeof console.trace === 'function') { + // not supported in IE 10 + console.trace(); + } + } + } + + return this; +}; + +EventEmitter.prototype.on = EventEmitter.prototype.addListener; + +EventEmitter.prototype.once = function(type, listener) { + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + var fired = false; + + function g() { + this.removeListener(type, g); + + if (!fired) { + fired = true; + listener.apply(this, arguments); + } + } + + g.listener = listener; + this.on(type, g); + + return this; +}; + +// emits a 'removeListener' event iff the listener was removed +EventEmitter.prototype.removeListener = function(type, listener) { + var list, position, length, i; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events || !this._events[type]) + return this; + + list = this._events[type]; + length = list.length; + position = -1; + + if (list === listener || + (isFunction(list.listener) && list.listener === listener)) { + delete this._events[type]; + if (this._events.removeListener) + this.emit('removeListener', type, listener); + + } else if (isObject(list)) { + for (i = length; i-- > 0;) { + if (list[i] === listener || + (list[i].listener && list[i].listener === listener)) { + position = i; + break; + } + } + + if (position < 0) + return this; + + if (list.length === 1) { + list.length = 0; + delete this._events[type]; + } else { + list.splice(position, 1); + } + + if (this._events.removeListener) + this.emit('removeListener', type, listener); + } + + return this; +}; + +EventEmitter.prototype.removeAllListeners = function(type) { + var key, listeners; + + if (!this._events) + return this; + + // not listening for removeListener, no need to emit + if (!this._events.removeListener) { + if (arguments.length === 0) + this._events = {}; + else if (this._events[type]) + delete this._events[type]; + return this; + } + + // emit removeListener for all listeners on all events + if (arguments.length === 0) { + for (key in this._events) { + if (key === 'removeListener') continue; + this.removeAllListeners(key); + } + this.removeAllListeners('removeListener'); + this._events = {}; + return this; + } + + listeners = this._events[type]; + + if (isFunction(listeners)) { + this.removeListener(type, listeners); + } else { + // LIFO order + while (listeners.length) + this.removeListener(type, listeners[listeners.length - 1]); + } + delete this._events[type]; + + return this; +}; + +EventEmitter.prototype.listeners = function(type) { + var ret; + if (!this._events || !this._events[type]) + ret = []; + else if (isFunction(this._events[type])) + ret = [this._events[type]]; + else + ret = this._events[type].slice(); + return ret; +}; + +EventEmitter.listenerCount = function(emitter, type) { + var ret; + if (!emitter._events || !emitter._events[type]) + ret = 0; + else if (isFunction(emitter._events[type])) + ret = 1; + else + ret = emitter._events[type].length; + return ret; +}; + +function isFunction(arg) { + return typeof arg === 'function'; +} + +function isNumber(arg) { + return typeof arg === 'number'; +} + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} + +function isUndefined(arg) { + return arg === void 0; +} + +},{}],15:[function(require,module,exports){ +(function (process){ +exports.alphasort = alphasort +exports.alphasorti = alphasorti +exports.setopts = setopts +exports.ownProp = ownProp +exports.makeAbs = makeAbs +exports.finish = finish +exports.mark = mark +exports.isIgnored = isIgnored +exports.childrenIgnored = childrenIgnored + +function ownProp (obj, field) { + return Object.prototype.hasOwnProperty.call(obj, field) +} + +var path = require("path") +var minimatch = require("minimatch") +var isAbsolute = require("path-is-absolute") +var Minimatch = minimatch.Minimatch + +function alphasorti (a, b) { + return a.toLowerCase().localeCompare(b.toLowerCase()) +} + +function alphasort (a, b) { + return a.localeCompare(b) +} + +function setupIgnores (self, options) { + self.ignore = options.ignore || [] + + if (!Array.isArray(self.ignore)) + self.ignore = [self.ignore] + + if (self.ignore.length) { + self.ignore = self.ignore.map(ignoreMap) + } +} + +function ignoreMap (pattern) { + var gmatcher = null + if (pattern.slice(-3) === '/**') { + var gpattern = pattern.replace(/(\/\*\*)+$/, '') + gmatcher = new Minimatch(gpattern) + } + + return { + matcher: new Minimatch(pattern), + gmatcher: gmatcher + } +} + +function setopts (self, pattern, options) { + if (!options) + options = {} + + // base-matching: just use globstar for that. + if (options.matchBase && -1 === pattern.indexOf("/")) { + if (options.noglobstar) { + throw new Error("base matching requires globstar") + } + pattern = "**/" + pattern + } + + self.silent = !!options.silent + self.pattern = pattern + self.strict = options.strict !== false + self.realpath = !!options.realpath + self.realpathCache = options.realpathCache || Object.create(null) + self.follow = !!options.follow + self.dot = !!options.dot + self.mark = !!options.mark + self.nodir = !!options.nodir + if (self.nodir) + self.mark = true + self.sync = !!options.sync + self.nounique = !!options.nounique + self.nonull = !!options.nonull + self.nosort = !!options.nosort + self.nocase = !!options.nocase + self.stat = !!options.stat + self.noprocess = !!options.noprocess + + self.maxLength = options.maxLength || Infinity + self.cache = options.cache || Object.create(null) + self.statCache = options.statCache || Object.create(null) + self.symlinks = options.symlinks || Object.create(null) + + setupIgnores(self, options) + + self.changedCwd = false + var cwd = process.cwd() + if (!ownProp(options, "cwd")) + self.cwd = cwd + else { + self.cwd = options.cwd + self.changedCwd = path.resolve(options.cwd) !== cwd + } + + self.root = options.root || path.resolve(self.cwd, "/") + self.root = path.resolve(self.root) + if (process.platform === "win32") + self.root = self.root.replace(/\\/g, "/") + + self.nomount = !!options.nomount + + // disable comments and negation unless the user explicitly + // passes in false as the option. + options.nonegate = options.nonegate === false ? false : true + options.nocomment = options.nocomment === false ? false : true + deprecationWarning(options) + + self.minimatch = new Minimatch(pattern, options) + self.options = self.minimatch.options +} + +// TODO(isaacs): remove entirely in v6 +// exported to reset in tests +exports.deprecationWarned +function deprecationWarning(options) { + if (!options.nonegate || !options.nocomment) { + if (process.noDeprecation !== true && !exports.deprecationWarned) { + var msg = 'glob WARNING: comments and negation will be disabled in v6' + if (process.throwDeprecation) + throw new Error(msg) + else if (process.traceDeprecation) + console.trace(msg) + else + console.error(msg) + + exports.deprecationWarned = true + } + } +} + +function finish (self) { + var nou = self.nounique + var all = nou ? [] : Object.create(null) + + for (var i = 0, l = self.matches.length; i < l; i ++) { + var matches = self.matches[i] + if (!matches || Object.keys(matches).length === 0) { + if (self.nonull) { + // do like the shell, and spit out the literal glob + var literal = self.minimatch.globSet[i] + if (nou) + all.push(literal) + else + all[literal] = true + } + } else { + // had matches + var m = Object.keys(matches) + if (nou) + all.push.apply(all, m) + else + m.forEach(function (m) { + all[m] = true + }) + } + } + + if (!nou) + all = Object.keys(all) + + if (!self.nosort) + all = all.sort(self.nocase ? alphasorti : alphasort) + + // at *some* point we statted all of these + if (self.mark) { + for (var i = 0; i < all.length; i++) { + all[i] = self._mark(all[i]) + } + if (self.nodir) { + all = all.filter(function (e) { + return !(/\/$/.test(e)) + }) + } + } + + if (self.ignore.length) + all = all.filter(function(m) { + return !isIgnored(self, m) + }) + + self.found = all +} + +function mark (self, p) { + var abs = makeAbs(self, p) + var c = self.cache[abs] + var m = p + if (c) { + var isDir = c === 'DIR' || Array.isArray(c) + var slash = p.slice(-1) === '/' + + if (isDir && !slash) + m += '/' + else if (!isDir && slash) + m = m.slice(0, -1) + + if (m !== p) { + var mabs = makeAbs(self, m) + self.statCache[mabs] = self.statCache[abs] + self.cache[mabs] = self.cache[abs] + } + } + + return m +} + +// lotta situps... +function makeAbs (self, f) { + var abs = f + if (f.charAt(0) === '/') { + abs = path.join(self.root, f) + } else if (isAbsolute(f) || f === '') { + abs = f + } else if (self.changedCwd) { + abs = path.resolve(self.cwd, f) + } else { + abs = path.resolve(f) + } + return abs +} + + +// Return true, if pattern ends with globstar '**', for the accompanying parent directory. +// Ex:- If node_modules/** is the pattern, add 'node_modules' to ignore list along with it's contents +function isIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return item.matcher.match(path) || !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +function childrenIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +}).call(this,require('_process')) +},{"_process":24,"minimatch":20,"path":22,"path-is-absolute":23}],16:[function(require,module,exports){ +(function (process){ +// Approach: +// +// 1. Get the minimatch set +// 2. For each pattern in the set, PROCESS(pattern, false) +// 3. Store matches per-set, then uniq them +// +// PROCESS(pattern, inGlobStar) +// Get the first [n] items from pattern that are all strings +// Join these together. This is PREFIX. +// If there is no more remaining, then stat(PREFIX) and +// add to matches if it succeeds. END. +// +// If inGlobStar and PREFIX is symlink and points to dir +// set ENTRIES = [] +// else readdir(PREFIX) as ENTRIES +// If fail, END +// +// with ENTRIES +// If pattern[n] is GLOBSTAR +// // handle the case where the globstar match is empty +// // by pruning it out, and testing the resulting pattern +// PROCESS(pattern[0..n] + pattern[n+1 .. $], false) +// // handle other cases. +// for ENTRY in ENTRIES (not dotfiles) +// // attach globstar + tail onto the entry +// // Mark that this entry is a globstar match +// PROCESS(pattern[0..n] + ENTRY + pattern[n .. $], true) +// +// else // not globstar +// for ENTRY in ENTRIES (not dotfiles, unless pattern[n] is dot) +// Test ENTRY against pattern[n] +// If fails, continue +// If passes, PROCESS(pattern[0..n] + item + pattern[n+1 .. $]) +// +// Caveat: +// Cache all stats and readdirs results to minimize syscall. Since all +// we ever care about is existence and directory-ness, we can just keep +// `true` for files, and [children,...] for directories, or `false` for +// things that don't exist. + +module.exports = glob + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var inherits = require('inherits') +var EE = require('events').EventEmitter +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var globSync = require('./sync.js') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var inflight = require('inflight') +var util = require('util') +var childrenIgnored = common.childrenIgnored +var isIgnored = common.isIgnored + +var once = require('once') + +function glob (pattern, options, cb) { + if (typeof options === 'function') cb = options, options = {} + if (!options) options = {} + + if (options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return globSync(pattern, options) + } + + return new Glob(pattern, options, cb) +} + +glob.sync = globSync +var GlobSync = glob.GlobSync = globSync.GlobSync + +// old api surface +glob.glob = glob + +glob.hasMagic = function (pattern, options_) { + var options = util._extend({}, options_) + options.noprocess = true + + var g = new Glob(pattern, options) + var set = g.minimatch.set + if (set.length > 1) + return true + + for (var j = 0; j < set[0].length; j++) { + if (typeof set[0][j] !== 'string') + return true + } + + return false +} + +glob.Glob = Glob +inherits(Glob, EE) +function Glob (pattern, options, cb) { + if (typeof options === 'function') { + cb = options + options = null + } + + if (options && options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return new GlobSync(pattern, options) + } + + if (!(this instanceof Glob)) + return new Glob(pattern, options, cb) + + setopts(this, pattern, options) + this._didRealPath = false + + // process each pattern in the minimatch set + var n = this.minimatch.set.length + + // The matches are stored as {: true,...} so that + // duplicates are automagically pruned. + // Later, we do an Object.keys() on these. + // Keep them as a list so we can fill in when nonull is set. + this.matches = new Array(n) + + if (typeof cb === 'function') { + cb = once(cb) + this.on('error', cb) + this.on('end', function (matches) { + cb(null, matches) + }) + } + + var self = this + var n = this.minimatch.set.length + this._processing = 0 + this.matches = new Array(n) + + this._emitQueue = [] + this._processQueue = [] + this.paused = false + + if (this.noprocess) + return this + + if (n === 0) + return done() + + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false, done) + } + + function done () { + --self._processing + if (self._processing <= 0) + self._finish() + } +} + +Glob.prototype._finish = function () { + assert(this instanceof Glob) + if (this.aborted) + return + + if (this.realpath && !this._didRealpath) + return this._realpath() + + common.finish(this) + this.emit('end', this.found) +} + +Glob.prototype._realpath = function () { + if (this._didRealpath) + return + + this._didRealpath = true + + var n = this.matches.length + if (n === 0) + return this._finish() + + var self = this + for (var i = 0; i < this.matches.length; i++) + this._realpathSet(i, next) + + function next () { + if (--n === 0) + self._finish() + } +} + +Glob.prototype._realpathSet = function (index, cb) { + var matchset = this.matches[index] + if (!matchset) + return cb() + + var found = Object.keys(matchset) + var self = this + var n = found.length + + if (n === 0) + return cb() + + var set = this.matches[index] = Object.create(null) + found.forEach(function (p, i) { + // If there's a problem with the stat, then it means that + // one or more of the links in the realpath couldn't be + // resolved. just return the abs value in that case. + p = self._makeAbs(p) + fs.realpath(p, self.realpathCache, function (er, real) { + if (!er) + set[real] = true + else if (er.syscall === 'stat') + set[p] = true + else + self.emit('error', er) // srsly wtf right here + + if (--n === 0) { + self.matches[index] = set + cb() + } + }) + }) +} + +Glob.prototype._mark = function (p) { + return common.mark(this, p) +} + +Glob.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +Glob.prototype.abort = function () { + this.aborted = true + this.emit('abort') +} + +Glob.prototype.pause = function () { + if (!this.paused) { + this.paused = true + this.emit('pause') + } +} + +Glob.prototype.resume = function () { + if (this.paused) { + this.emit('resume') + this.paused = false + if (this._emitQueue.length) { + var eq = this._emitQueue.slice(0) + this._emitQueue.length = 0 + for (var i = 0; i < eq.length; i ++) { + var e = eq[i] + this._emitMatch(e[0], e[1]) + } + } + if (this._processQueue.length) { + var pq = this._processQueue.slice(0) + this._processQueue.length = 0 + for (var i = 0; i < pq.length; i ++) { + var p = pq[i] + this._processing-- + this._process(p[0], p[1], p[2], p[3]) + } + } + } +} + +Glob.prototype._process = function (pattern, index, inGlobStar, cb) { + assert(this instanceof Glob) + assert(typeof cb === 'function') + + if (this.aborted) + return + + this._processing++ + if (this.paused) { + this._processQueue.push([pattern, index, inGlobStar, cb]) + return + } + + //console.error('PROCESS %d', this._processing, pattern) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // see if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index, cb) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip _processing + if (childrenIgnored(this, read)) + return cb() + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb) +} + +Glob.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + return self._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + +Glob.prototype._processReaddir2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return cb() + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + //console.error('prd2', prefix, entries, remain[0]._glob, matchedEntries) + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return cb() + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this._emitMatch(index, e) + } + // This was the last one, and no stats were needed + return cb() + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + this._process([e].concat(remain), index, inGlobStar, cb) + } + cb() +} + +Glob.prototype._emitMatch = function (index, e) { + if (this.aborted) + return + + if (this.matches[index][e]) + return + + if (isIgnored(this, e)) + return + + if (this.paused) { + this._emitQueue.push([index, e]) + return + } + + var abs = this._makeAbs(e) + + if (this.nodir) { + var c = this.cache[abs] + if (c === 'DIR' || Array.isArray(c)) + return + } + + if (this.mark) + e = this._mark(e) + + this.matches[index][e] = true + + var st = this.statCache[abs] + if (st) + this.emit('stat', e, st) + + this.emit('match', e) +} + +Glob.prototype._readdirInGlobStar = function (abs, cb) { + if (this.aborted) + return + + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false, cb) + + var lstatkey = 'lstat\0' + abs + var self = this + var lstatcb = inflight(lstatkey, lstatcb_) + + if (lstatcb) + fs.lstat(abs, lstatcb) + + function lstatcb_ (er, lstat) { + if (er) + return cb() + + var isSym = lstat.isSymbolicLink() + self.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) { + self.cache[abs] = 'FILE' + cb() + } else + self._readdir(abs, false, cb) + } +} + +Glob.prototype._readdir = function (abs, inGlobStar, cb) { + if (this.aborted) + return + + cb = inflight('readdir\0'+abs+'\0'+inGlobStar, cb) + if (!cb) + return + + //console.error('RD %j %j', +inGlobStar, abs) + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs, cb) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return cb() + + if (Array.isArray(c)) + return cb(null, c) + } + + var self = this + fs.readdir(abs, readdirCb(this, abs, cb)) +} + +function readdirCb (self, abs, cb) { + return function (er, entries) { + if (er) + self._readdirError(abs, er, cb) + else + self._readdirEntries(abs, entries, cb) + } +} + +Glob.prototype._readdirEntries = function (abs, entries, cb) { + if (this.aborted) + return + + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + return cb(null, entries) +} + +Glob.prototype._readdirError = function (f, er, cb) { + if (this.aborted) + return + + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) { + this.emit('error', er) + // If the error is handled, then we abort + // if not, we threw out of here + this.abort() + } + if (!this.silent) + console.error('glob error', er) + break + } + + return cb() +} + +Glob.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + self._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + + +Glob.prototype._processGlobStar2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + //console.error('pgs2', prefix, remain[0], entries) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return cb() + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false, cb) + + var isSym = this.symlinks[abs] + var len = entries.length + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return cb() + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true, cb) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true, cb) + } + + cb() +} + +Glob.prototype._processSimple = function (prefix, index, cb) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var self = this + this._stat(prefix, function (er, exists) { + self._processSimple2(prefix, index, er, exists, cb) + }) +} +Glob.prototype._processSimple2 = function (prefix, index, er, exists, cb) { + + //console.error('ps2', prefix, exists) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return cb() + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this._emitMatch(index, prefix) + cb() +} + +// Returns either 'DIR', 'FILE', or false +Glob.prototype._stat = function (f, cb) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return cb() + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return cb(null, c) + + if (needDir && c === 'FILE') + return cb() + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (stat !== undefined) { + if (stat === false) + return cb(null, stat) + else { + var type = stat.isDirectory() ? 'DIR' : 'FILE' + if (needDir && type === 'FILE') + return cb() + else + return cb(null, type, stat) + } + } + + var self = this + var statcb = inflight('stat\0' + abs, lstatcb_) + if (statcb) + fs.lstat(abs, statcb) + + function lstatcb_ (er, lstat) { + if (lstat && lstat.isSymbolicLink()) { + // If it's a symlink, then treat it as the target, unless + // the target does not exist, then treat it as a file. + return fs.stat(abs, function (er, stat) { + if (er) + self._stat2(f, abs, null, lstat, cb) + else + self._stat2(f, abs, er, stat, cb) + }) + } else { + self._stat2(f, abs, er, lstat, cb) + } + } +} + +Glob.prototype._stat2 = function (f, abs, er, stat, cb) { + if (er) { + this.statCache[abs] = false + return cb() + } + + var needDir = f.slice(-1) === '/' + this.statCache[abs] = stat + + if (abs.slice(-1) === '/' && !stat.isDirectory()) + return cb(null, false, stat) + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return cb() + + return cb(null, c, stat) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./sync.js":17,"_process":24,"assert":9,"events":14,"fs":12,"inflight":18,"inherits":19,"minimatch":20,"once":21,"path":22,"path-is-absolute":23,"util":28}],17:[function(require,module,exports){ +(function (process){ +module.exports = globSync +globSync.GlobSync = GlobSync + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var Glob = require('./glob.js').Glob +var util = require('util') +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var childrenIgnored = common.childrenIgnored + +function globSync (pattern, options) { + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + return new GlobSync(pattern, options).found +} + +function GlobSync (pattern, options) { + if (!pattern) + throw new Error('must provide pattern') + + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + if (!(this instanceof GlobSync)) + return new GlobSync(pattern, options) + + setopts(this, pattern, options) + + if (this.noprocess) + return this + + var n = this.minimatch.set.length + this.matches = new Array(n) + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false) + } + this._finish() +} + +GlobSync.prototype._finish = function () { + assert(this instanceof GlobSync) + if (this.realpath) { + var self = this + this.matches.forEach(function (matchset, index) { + var set = self.matches[index] = Object.create(null) + for (var p in matchset) { + try { + p = self._makeAbs(p) + var real = fs.realpathSync(p, self.realpathCache) + set[real] = true + } catch (er) { + if (er.syscall === 'stat') + set[self._makeAbs(p)] = true + else + throw er + } + } + }) + } + common.finish(this) +} + + +GlobSync.prototype._process = function (pattern, index, inGlobStar) { + assert(this instanceof GlobSync) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // See if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip processing + if (childrenIgnored(this, read)) + return + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar) +} + + +GlobSync.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar) { + var entries = this._readdir(abs, inGlobStar) + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix.slice(-1) !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this.matches[index][e] = true + } + // This was the last one, and no stats were needed + return + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) + newPattern = [prefix, e] + else + newPattern = [e] + this._process(newPattern.concat(remain), index, inGlobStar) + } +} + + +GlobSync.prototype._emitMatch = function (index, e) { + var abs = this._makeAbs(e) + if (this.mark) + e = this._mark(e) + + if (this.matches[index][e]) + return + + if (this.nodir) { + var c = this.cache[this._makeAbs(e)] + if (c === 'DIR' || Array.isArray(c)) + return + } + + this.matches[index][e] = true + if (this.stat) + this._stat(e) +} + + +GlobSync.prototype._readdirInGlobStar = function (abs) { + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false) + + var entries + var lstat + var stat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + // lstat failed, doesn't exist + return null + } + + var isSym = lstat.isSymbolicLink() + this.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) + this.cache[abs] = 'FILE' + else + entries = this._readdir(abs, false) + + return entries +} + +GlobSync.prototype._readdir = function (abs, inGlobStar) { + var entries + + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return null + + if (Array.isArray(c)) + return c + } + + try { + return this._readdirEntries(abs, fs.readdirSync(abs)) + } catch (er) { + this._readdirError(abs, er) + return null + } +} + +GlobSync.prototype._readdirEntries = function (abs, entries) { + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + + // mark and cache dir-ness + return entries +} + +GlobSync.prototype._readdirError = function (f, er) { + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) + throw er + if (!this.silent) + console.error('glob error', er) + break + } +} + +GlobSync.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar) { + + var entries = this._readdir(abs, inGlobStar) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false) + + var len = entries.length + var isSym = this.symlinks[abs] + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true) + } +} + +GlobSync.prototype._processSimple = function (prefix, index) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var exists = this._stat(prefix) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this.matches[index][prefix] = true +} + +// Returns either 'DIR', 'FILE', or false +GlobSync.prototype._stat = function (f) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return false + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return c + + if (needDir && c === 'FILE') + return false + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (!stat) { + var lstat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + return false + } + + if (lstat.isSymbolicLink()) { + try { + stat = fs.statSync(abs) + } catch (er) { + stat = lstat + } + } else { + stat = lstat + } + } + + this.statCache[abs] = stat + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return false + + return c +} + +GlobSync.prototype._mark = function (p) { + return common.mark(this, p) +} + +GlobSync.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./glob.js":16,"_process":24,"assert":9,"fs":12,"minimatch":20,"path":22,"path-is-absolute":23,"util":28}],18:[function(require,module,exports){ +(function (process){ +var wrappy = require('wrappy') +var reqs = Object.create(null) +var once = require('once') + +module.exports = wrappy(inflight) + +function inflight (key, cb) { + if (reqs[key]) { + reqs[key].push(cb) + return null + } else { + reqs[key] = [cb] + return makeres(key) + } +} + +function makeres (key) { + return once(function RES () { + var cbs = reqs[key] + var len = cbs.length + var args = slice(arguments) + + // XXX It's somewhat ambiguous whether a new callback added in this + // pass should be queued for later execution if something in the + // list of callbacks throws, or if it should just be discarded. + // However, it's such an edge case that it hardly matters, and either + // choice is likely as surprising as the other. + // As it happens, we do go ahead and schedule it for later execution. + try { + for (var i = 0; i < len; i++) { + cbs[i].apply(null, args) + } + } finally { + if (cbs.length > len) { + // added more in the interim. + // de-zalgo, just in case, but don't call again. + cbs.splice(0, len) + process.nextTick(function () { + RES.apply(null, args) + }) + } else { + delete reqs[key] + } + } + }) +} + +function slice (args) { + var length = args.length + var array = [] + + for (var i = 0; i < length; i++) array[i] = args[i] + return array +} + +}).call(this,require('_process')) +},{"_process":24,"once":21,"wrappy":29}],19:[function(require,module,exports){ +if (typeof Object.create === 'function') { + // implementation from standard node.js 'util' module + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + ctor.prototype = Object.create(superCtor.prototype, { + constructor: { + value: ctor, + enumerable: false, + writable: true, + configurable: true + } + }); + }; +} else { + // old school shim for old browsers + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + var TempCtor = function () {} + TempCtor.prototype = superCtor.prototype + ctor.prototype = new TempCtor() + ctor.prototype.constructor = ctor + } +} + +},{}],20:[function(require,module,exports){ +module.exports = minimatch +minimatch.Minimatch = Minimatch + +var path = { sep: '/' } +try { + path = require('path') +} catch (er) {} + +var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {} +var expand = require('brace-expansion') + +var plTypes = { + '!': { open: '(?:(?!(?:', close: '))[^/]*?)'}, + '?': { open: '(?:', close: ')?' }, + '+': { open: '(?:', close: ')+' }, + '*': { open: '(?:', close: ')*' }, + '@': { open: '(?:', close: ')' } +} + +// any single thing other than / +// don't need to escape / when using new RegExp() +var qmark = '[^/]' + +// * => any number of characters +var star = qmark + '*?' + +// ** when dots are allowed. Anything goes, except .. and . +// not (^ or / followed by one or two dots followed by $ or /), +// followed by anything, any number of times. +var twoStarDot = '(?:(?!(?:\\\/|^)(?:\\.{1,2})($|\\\/)).)*?' + +// not a ^ or / followed by a dot, +// followed by anything, any number of times. +var twoStarNoDot = '(?:(?!(?:\\\/|^)\\.).)*?' + +// characters that need to be escaped in RegExp. +var reSpecials = charSet('().*{}+?[]^$\\!') + +// "abc" -> { a:true, b:true, c:true } +function charSet (s) { + return s.split('').reduce(function (set, c) { + set[c] = true + return set + }, {}) +} + +// normalizes slashes. +var slashSplit = /\/+/ + +minimatch.filter = filter +function filter (pattern, options) { + options = options || {} + return function (p, i, list) { + return minimatch(p, pattern, options) + } +} + +function ext (a, b) { + a = a || {} + b = b || {} + var t = {} + Object.keys(b).forEach(function (k) { + t[k] = b[k] + }) + Object.keys(a).forEach(function (k) { + t[k] = a[k] + }) + return t +} + +minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return minimatch + + var orig = minimatch + + var m = function minimatch (p, pattern, options) { + return orig.minimatch(p, pattern, ext(def, options)) + } + + m.Minimatch = function Minimatch (pattern, options) { + return new orig.Minimatch(pattern, ext(def, options)) + } + + return m +} + +Minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return Minimatch + return minimatch.defaults(def).Minimatch +} + +function minimatch (p, pattern, options) { + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + + // shortcut: comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + return false + } + + // "" only matches "" + if (pattern.trim() === '') return p === '' + + return new Minimatch(pattern, options).match(p) +} + +function Minimatch (pattern, options) { + if (!(this instanceof Minimatch)) { + return new Minimatch(pattern, options) + } + + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + pattern = pattern.trim() + + // windows support: need to use /, not \ + if (path.sep !== '/') { + pattern = pattern.split(path.sep).join('/') + } + + this.options = options + this.set = [] + this.pattern = pattern + this.regexp = null + this.negate = false + this.comment = false + this.empty = false + + // make the set of regexps etc. + this.make() +} + +Minimatch.prototype.debug = function () {} + +Minimatch.prototype.make = make +function make () { + // don't do it more than once. + if (this._made) return + + var pattern = this.pattern + var options = this.options + + // empty patterns and comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + this.comment = true + return + } + if (!pattern) { + this.empty = true + return + } + + // step 1: figure out negation, etc. + this.parseNegate() + + // step 2: expand braces + var set = this.globSet = this.braceExpand() + + if (options.debug) this.debug = console.error + + this.debug(this.pattern, set) + + // step 3: now we have a set, so turn each one into a series of path-portion + // matching patterns. + // These will be regexps, except in the case of "**", which is + // set to the GLOBSTAR object for globstar behavior, + // and will not contain any / characters + set = this.globParts = set.map(function (s) { + return s.split(slashSplit) + }) + + this.debug(this.pattern, set) + + // glob --> regexps + set = set.map(function (s, si, set) { + return s.map(this.parse, this) + }, this) + + this.debug(this.pattern, set) + + // filter out everything that didn't compile properly. + set = set.filter(function (s) { + return s.indexOf(false) === -1 + }) + + this.debug(this.pattern, set) + + this.set = set +} + +Minimatch.prototype.parseNegate = parseNegate +function parseNegate () { + var pattern = this.pattern + var negate = false + var options = this.options + var negateOffset = 0 + + if (options.nonegate) return + + for (var i = 0, l = pattern.length + ; i < l && pattern.charAt(i) === '!' + ; i++) { + negate = !negate + negateOffset++ + } + + if (negateOffset) this.pattern = pattern.substr(negateOffset) + this.negate = negate +} + +// Brace expansion: +// a{b,c}d -> abd acd +// a{b,}c -> abc ac +// a{0..3}d -> a0d a1d a2d a3d +// a{b,c{d,e}f}g -> abg acdfg acefg +// a{b,c}d{e,f}g -> abdeg acdeg abdeg abdfg +// +// Invalid sets are not expanded. +// a{2..}b -> a{2..}b +// a{b}c -> a{b}c +minimatch.braceExpand = function (pattern, options) { + return braceExpand(pattern, options) +} + +Minimatch.prototype.braceExpand = braceExpand + +function braceExpand (pattern, options) { + if (!options) { + if (this instanceof Minimatch) { + options = this.options + } else { + options = {} + } + } + + pattern = typeof pattern === 'undefined' + ? this.pattern : pattern + + if (typeof pattern === 'undefined') { + throw new TypeError('undefined pattern') + } + + if (options.nobrace || + !pattern.match(/\{.*\}/)) { + // shortcut. no need to expand. + return [pattern] + } + + return expand(pattern) +} + +// parse a component of the expanded set. +// At this point, no pattern may contain "/" in it +// so we're going to return a 2d array, where each entry is the full +// pattern, split on '/', and then turned into a regular expression. +// A regexp is made at the end which joins each array with an +// escaped /, and another full one which joins each regexp with |. +// +// Following the lead of Bash 4.1, note that "**" only has special meaning +// when it is the *only* thing in a path portion. Otherwise, any series +// of * is equivalent to a single *. Globstar behavior is enabled by +// default, and can be disabled by setting options.noglobstar. +Minimatch.prototype.parse = parse +var SUBPARSE = {} +function parse (pattern, isSub) { + if (pattern.length > 1024 * 64) { + throw new TypeError('pattern is too long') + } + + var options = this.options + + // shortcuts + if (!options.noglobstar && pattern === '**') return GLOBSTAR + if (pattern === '') return '' + + var re = '' + var hasMagic = !!options.nocase + var escaping = false + // ? => one single character + var patternListStack = [] + var negativeLists = [] + var stateChar + var inClass = false + var reClassStart = -1 + var classStart = -1 + // . and .. never match anything that doesn't start with ., + // even when options.dot is set. + var patternStart = pattern.charAt(0) === '.' ? '' // anything + // not (start or / followed by . or .. followed by / or end) + : options.dot ? '(?!(?:^|\\\/)\\.{1,2}(?:$|\\\/))' + : '(?!\\.)' + var self = this + + function clearStateChar () { + if (stateChar) { + // we had some state-tracking character + // that wasn't consumed by this pass. + switch (stateChar) { + case '*': + re += star + hasMagic = true + break + case '?': + re += qmark + hasMagic = true + break + default: + re += '\\' + stateChar + break + } + self.debug('clearStateChar %j %j', stateChar, re) + stateChar = false + } + } + + for (var i = 0, len = pattern.length, c + ; (i < len) && (c = pattern.charAt(i)) + ; i++) { + this.debug('%s\t%s %s %j', pattern, i, re, c) + + // skip over any that are escaped. + if (escaping && reSpecials[c]) { + re += '\\' + c + escaping = false + continue + } + + switch (c) { + case '/': + // completely not allowed, even escaped. + // Should already be path-split by now. + return false + + case '\\': + clearStateChar() + escaping = true + continue + + // the various stateChar values + // for the "extglob" stuff. + case '?': + case '*': + case '+': + case '@': + case '!': + this.debug('%s\t%s %s %j <-- stateChar', pattern, i, re, c) + + // all of those are literals inside a class, except that + // the glob [!a] means [^a] in regexp + if (inClass) { + this.debug(' in class') + if (c === '!' && i === classStart + 1) c = '^' + re += c + continue + } + + // if we already have a stateChar, then it means + // that there was something like ** or +? in there. + // Handle the stateChar, then proceed with this one. + self.debug('call clearStateChar %j', stateChar) + clearStateChar() + stateChar = c + // if extglob is disabled, then +(asdf|foo) isn't a thing. + // just clear the statechar *now*, rather than even diving into + // the patternList stuff. + if (options.noext) clearStateChar() + continue + + case '(': + if (inClass) { + re += '(' + continue + } + + if (!stateChar) { + re += '\\(' + continue + } + + patternListStack.push({ + type: stateChar, + start: i - 1, + reStart: re.length, + open: plTypes[stateChar].open, + close: plTypes[stateChar].close + }) + // negation is (?:(?!js)[^/]*) + re += stateChar === '!' ? '(?:(?!(?:' : '(?:' + this.debug('plType %j %j', stateChar, re) + stateChar = false + continue + + case ')': + if (inClass || !patternListStack.length) { + re += '\\)' + continue + } + + clearStateChar() + hasMagic = true + var pl = patternListStack.pop() + // negation is (?:(?!js)[^/]*) + // The others are (?:) + re += pl.close + if (pl.type === '!') { + negativeLists.push(pl) + } + pl.reEnd = re.length + continue + + case '|': + if (inClass || !patternListStack.length || escaping) { + re += '\\|' + escaping = false + continue + } + + clearStateChar() + re += '|' + continue + + // these are mostly the same in regexp and glob + case '[': + // swallow any state-tracking char before the [ + clearStateChar() + + if (inClass) { + re += '\\' + c + continue + } + + inClass = true + classStart = i + reClassStart = re.length + re += c + continue + + case ']': + // a right bracket shall lose its special + // meaning and represent itself in + // a bracket expression if it occurs + // first in the list. -- POSIX.2 2.8.3.2 + if (i === classStart + 1 || !inClass) { + re += '\\' + c + escaping = false + continue + } + + // handle the case where we left a class open. + // "[z-a]" is valid, equivalent to "\[z-a\]" + if (inClass) { + // split where the last [ was, make sure we don't have + // an invalid re. if so, re-walk the contents of the + // would-be class to re-translate any characters that + // were passed through as-is + // TODO: It would probably be faster to determine this + // without a try/catch and a new RegExp, but it's tricky + // to do safely. For now, this is safe and works. + var cs = pattern.substring(classStart + 1, i) + try { + RegExp('[' + cs + ']') + } catch (er) { + // not a valid class! + var sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + '\\]' + hasMagic = hasMagic || sp[1] + inClass = false + continue + } + } + + // finish up the class. + hasMagic = true + inClass = false + re += c + continue + + default: + // swallow any state char that wasn't consumed + clearStateChar() + + if (escaping) { + // no need + escaping = false + } else if (reSpecials[c] + && !(c === '^' && inClass)) { + re += '\\' + } + + re += c + + } // switch + } // for + + // handle the case where we left a class open. + // "[abc" is valid, equivalent to "\[abc" + if (inClass) { + // split where the last [ was, and escape it + // this is a huge pita. We now have to re-walk + // the contents of the would-be class to re-translate + // any characters that were passed through as-is + cs = pattern.substr(classStart + 1) + sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + hasMagic = hasMagic || sp[1] + } + + // handle the case where we had a +( thing at the *end* + // of the pattern. + // each pattern list stack adds 3 chars, and we need to go through + // and escape any | chars that were passed through as-is for the regexp. + // Go through and escape them, taking care not to double-escape any + // | chars that were already escaped. + for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) { + var tail = re.slice(pl.reStart + pl.open.length) + this.debug('setting tail', re, pl) + // maybe some even number of \, then maybe 1 \, followed by a | + tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function (_, $1, $2) { + if (!$2) { + // the | isn't already escaped, so escape it. + $2 = '\\' + } + + // need to escape all those slashes *again*, without escaping the + // one that we need for escaping the | character. As it works out, + // escaping an even number of slashes can be done by simply repeating + // it exactly after itself. That's why this trick works. + // + // I am sorry that you have to see this. + return $1 + $1 + $2 + '|' + }) + + this.debug('tail=%j\n %s', tail, tail, pl, re) + var t = pl.type === '*' ? star + : pl.type === '?' ? qmark + : '\\' + pl.type + + hasMagic = true + re = re.slice(0, pl.reStart) + t + '\\(' + tail + } + + // handle trailing things that only matter at the very end. + clearStateChar() + if (escaping) { + // trailing \\ + re += '\\\\' + } + + // only need to apply the nodot start if the re starts with + // something that could conceivably capture a dot + var addPatternStart = false + switch (re.charAt(0)) { + case '.': + case '[': + case '(': addPatternStart = true + } + + // Hack to work around lack of negative lookbehind in JS + // A pattern like: *.!(x).!(y|z) needs to ensure that a name + // like 'a.xyz.yz' doesn't match. So, the first negative + // lookahead, has to look ALL the way ahead, to the end of + // the pattern. + for (var n = negativeLists.length - 1; n > -1; n--) { + var nl = negativeLists[n] + + var nlBefore = re.slice(0, nl.reStart) + var nlFirst = re.slice(nl.reStart, nl.reEnd - 8) + var nlLast = re.slice(nl.reEnd - 8, nl.reEnd) + var nlAfter = re.slice(nl.reEnd) + + nlLast += nlAfter + + // Handle nested stuff like *(*.js|!(*.json)), where open parens + // mean that we should *not* include the ) in the bit that is considered + // "after" the negated section. + var openParensBefore = nlBefore.split('(').length - 1 + var cleanAfter = nlAfter + for (i = 0; i < openParensBefore; i++) { + cleanAfter = cleanAfter.replace(/\)[+*?]?/, '') + } + nlAfter = cleanAfter + + var dollar = '' + if (nlAfter === '' && isSub !== SUBPARSE) { + dollar = '$' + } + var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast + re = newRe + } + + // if the re is not "" at this point, then we need to make sure + // it doesn't match against an empty path part. + // Otherwise a/* will match a/, which it should not. + if (re !== '' && hasMagic) { + re = '(?=.)' + re + } + + if (addPatternStart) { + re = patternStart + re + } + + // parsing just a piece of a larger pattern. + if (isSub === SUBPARSE) { + return [re, hasMagic] + } + + // skip the regexp for non-magical patterns + // unescape anything in it, though, so that it'll be + // an exact match against a file etc. + if (!hasMagic) { + return globUnescape(pattern) + } + + var flags = options.nocase ? 'i' : '' + try { + var regExp = new RegExp('^' + re + '$', flags) + } catch (er) { + // If it was an invalid regular expression, then it can't match + // anything. This trick looks for a character after the end of + // the string, which is of course impossible, except in multi-line + // mode, but it's not a /m regex. + return new RegExp('$.') + } + + regExp._glob = pattern + regExp._src = re + + return regExp +} + +minimatch.makeRe = function (pattern, options) { + return new Minimatch(pattern, options || {}).makeRe() +} + +Minimatch.prototype.makeRe = makeRe +function makeRe () { + if (this.regexp || this.regexp === false) return this.regexp + + // at this point, this.set is a 2d array of partial + // pattern strings, or "**". + // + // It's better to use .match(). This function shouldn't + // be used, really, but it's pretty convenient sometimes, + // when you just want to work with a regex. + var set = this.set + + if (!set.length) { + this.regexp = false + return this.regexp + } + var options = this.options + + var twoStar = options.noglobstar ? star + : options.dot ? twoStarDot + : twoStarNoDot + var flags = options.nocase ? 'i' : '' + + var re = set.map(function (pattern) { + return pattern.map(function (p) { + return (p === GLOBSTAR) ? twoStar + : (typeof p === 'string') ? regExpEscape(p) + : p._src + }).join('\\\/') + }).join('|') + + // must match entire pattern + // ending in a * or ** will make it less strict. + re = '^(?:' + re + ')$' + + // can match anything, as long as it's not this. + if (this.negate) re = '^(?!' + re + ').*$' + + try { + this.regexp = new RegExp(re, flags) + } catch (ex) { + this.regexp = false + } + return this.regexp +} + +minimatch.match = function (list, pattern, options) { + options = options || {} + var mm = new Minimatch(pattern, options) + list = list.filter(function (f) { + return mm.match(f) + }) + if (mm.options.nonull && !list.length) { + list.push(pattern) + } + return list +} + +Minimatch.prototype.match = match +function match (f, partial) { + this.debug('match', f, this.pattern) + // short-circuit in the case of busted things. + // comments, etc. + if (this.comment) return false + if (this.empty) return f === '' + + if (f === '/' && partial) return true + + var options = this.options + + // windows: need to use /, not \ + if (path.sep !== '/') { + f = f.split(path.sep).join('/') + } + + // treat the test path as a set of pathparts. + f = f.split(slashSplit) + this.debug(this.pattern, 'split', f) + + // just ONE of the pattern sets in this.set needs to match + // in order for it to be valid. If negating, then just one + // match means that we have failed. + // Either way, return on the first hit. + + var set = this.set + this.debug(this.pattern, 'set', set) + + // Find the basename of the path by looking for the last non-empty segment + var filename + var i + for (i = f.length - 1; i >= 0; i--) { + filename = f[i] + if (filename) break + } + + for (i = 0; i < set.length; i++) { + var pattern = set[i] + var file = f + if (options.matchBase && pattern.length === 1) { + file = [filename] + } + var hit = this.matchOne(file, pattern, partial) + if (hit) { + if (options.flipNegate) return true + return !this.negate + } + } + + // didn't get any hits. this is success if it's a negative + // pattern, failure otherwise. + if (options.flipNegate) return false + return this.negate +} + +// set partial to true to test if, for example, +// "/a/b" matches the start of "/*/b/*/d" +// Partial means, if you run out of file before you run +// out of pattern, then that's fine, as long as all +// the parts match. +Minimatch.prototype.matchOne = function (file, pattern, partial) { + var options = this.options + + this.debug('matchOne', + { 'this': this, file: file, pattern: pattern }) + + this.debug('matchOne', file.length, pattern.length) + + for (var fi = 0, + pi = 0, + fl = file.length, + pl = pattern.length + ; (fi < fl) && (pi < pl) + ; fi++, pi++) { + this.debug('matchOne loop') + var p = pattern[pi] + var f = file[fi] + + this.debug(pattern, p, f) + + // should be impossible. + // some invalid regexp stuff in the set. + if (p === false) return false + + if (p === GLOBSTAR) { + this.debug('GLOBSTAR', [pattern, p, f]) + + // "**" + // a/**/b/**/c would match the following: + // a/b/x/y/z/c + // a/x/y/z/b/c + // a/b/x/b/x/c + // a/b/c + // To do this, take the rest of the pattern after + // the **, and see if it would match the file remainder. + // If so, return success. + // If not, the ** "swallows" a segment, and try again. + // This is recursively awful. + // + // a/**/b/**/c matching a/b/x/y/z/c + // - a matches a + // - doublestar + // - matchOne(b/x/y/z/c, b/**/c) + // - b matches b + // - doublestar + // - matchOne(x/y/z/c, c) -> no + // - matchOne(y/z/c, c) -> no + // - matchOne(z/c, c) -> no + // - matchOne(c, c) yes, hit + var fr = fi + var pr = pi + 1 + if (pr === pl) { + this.debug('** at the end') + // a ** at the end will just swallow the rest. + // We have found a match. + // however, it will not swallow /.x, unless + // options.dot is set. + // . and .. are *never* matched by **, for explosively + // exponential reasons. + for (; fi < fl; fi++) { + if (file[fi] === '.' || file[fi] === '..' || + (!options.dot && file[fi].charAt(0) === '.')) return false + } + return true + } + + // ok, let's see if we can swallow whatever we can. + while (fr < fl) { + var swallowee = file[fr] + + this.debug('\nglobstar while', file, fr, pattern, pr, swallowee) + + // XXX remove this slice. Just pass the start index. + if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) { + this.debug('globstar found match!', fr, fl, swallowee) + // found a match. + return true + } else { + // can't swallow "." or ".." ever. + // can only swallow ".foo" when explicitly asked. + if (swallowee === '.' || swallowee === '..' || + (!options.dot && swallowee.charAt(0) === '.')) { + this.debug('dot detected!', file, fr, pattern, pr) + break + } + + // ** swallows a segment, and continue. + this.debug('globstar swallow a segment, and continue') + fr++ + } + } + + // no match was found. + // However, in partial mode, we can't say this is necessarily over. + // If there's more *pattern* left, then + if (partial) { + // ran out of file + this.debug('\n>>> no match, partial?', file, fr, pattern, pr) + if (fr === fl) return true + } + return false + } + + // something other than ** + // non-magic patterns just have to match exactly + // patterns with magic have been turned into regexps. + var hit + if (typeof p === 'string') { + if (options.nocase) { + hit = f.toLowerCase() === p.toLowerCase() + } else { + hit = f === p + } + this.debug('string match', p, f, hit) + } else { + hit = f.match(p) + this.debug('pattern match', p, f, hit) + } + + if (!hit) return false + } + + // Note: ending in / means that we'll get a final "" + // at the end of the pattern. This can only match a + // corresponding "" at the end of the file. + // If the file ends in /, then it can only match a + // a pattern that ends in /, unless the pattern just + // doesn't have any more for it. But, a/b/ should *not* + // match "a/b/*", even though "" matches against the + // [^/]*? pattern, except in partial mode, where it might + // simply not be reached yet. + // However, a/b/ should still satisfy a/* + + // now either we fell off the end of the pattern, or we're done. + if (fi === fl && pi === pl) { + // ran out of pattern and filename at the same time. + // an exact hit! + return true + } else if (fi === fl) { + // ran out of file, but still had pattern left. + // this is ok if we're doing the match as part of + // a glob fs traversal. + return partial + } else if (pi === pl) { + // ran out of pattern, still have file left. + // this is only acceptable if we're on the very last + // empty segment of a file with a trailing slash. + // a/* should match a/b/ + var emptyFileEnd = (fi === fl - 1) && (file[fi] === '') + return emptyFileEnd + } + + // should be unreachable. + throw new Error('wtf?') +} + +// replace stuff like \* with * +function globUnescape (s) { + return s.replace(/\\(.)/g, '$1') +} + +function regExpEscape (s) { + return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&') +} + +},{"brace-expansion":11,"path":22}],21:[function(require,module,exports){ +var wrappy = require('wrappy') +module.exports = wrappy(once) +module.exports.strict = wrappy(onceStrict) + +once.proto = once(function () { + Object.defineProperty(Function.prototype, 'once', { + value: function () { + return once(this) + }, + configurable: true + }) + + Object.defineProperty(Function.prototype, 'onceStrict', { + value: function () { + return onceStrict(this) + }, + configurable: true + }) +}) + +function once (fn) { + var f = function () { + if (f.called) return f.value + f.called = true + return f.value = fn.apply(this, arguments) + } + f.called = false + return f +} + +function onceStrict (fn) { + var f = function () { + if (f.called) + throw new Error(f.onceError) + f.called = true + return f.value = fn.apply(this, arguments) + } + var name = fn.name || 'Function wrapped with `once`' + f.onceError = name + " shouldn't be called more than once" + f.called = false + return f +} + +},{"wrappy":29}],22:[function(require,module,exports){ +(function (process){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +// resolves . and .. elements in a path array with directory names there +// must be no slashes, empty elements, or device names (c:\) in the array +// (so also no leading and trailing slashes - it does not distinguish +// relative and absolute paths) +function normalizeArray(parts, allowAboveRoot) { + // if the path tries to go above the root, `up` ends up > 0 + var up = 0; + for (var i = parts.length - 1; i >= 0; i--) { + var last = parts[i]; + if (last === '.') { + parts.splice(i, 1); + } else if (last === '..') { + parts.splice(i, 1); + up++; + } else if (up) { + parts.splice(i, 1); + up--; + } + } + + // if the path is allowed to go above the root, restore leading ..s + if (allowAboveRoot) { + for (; up--; up) { + parts.unshift('..'); + } + } + + return parts; +} + +// Split a filename into [root, dir, basename, ext], unix version +// 'root' is just a slash, or nothing. +var splitPathRe = + /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/; +var splitPath = function(filename) { + return splitPathRe.exec(filename).slice(1); +}; + +// path.resolve([from ...], to) +// posix version +exports.resolve = function() { + var resolvedPath = '', + resolvedAbsolute = false; + + for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) { + var path = (i >= 0) ? arguments[i] : process.cwd(); + + // Skip empty and invalid entries + if (typeof path !== 'string') { + throw new TypeError('Arguments to path.resolve must be strings'); + } else if (!path) { + continue; + } + + resolvedPath = path + '/' + resolvedPath; + resolvedAbsolute = path.charAt(0) === '/'; + } + + // At this point the path should be resolved to a full absolute path, but + // handle relative paths to be safe (might happen when process.cwd() fails) + + // Normalize the path + resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function(p) { + return !!p; + }), !resolvedAbsolute).join('/'); + + return ((resolvedAbsolute ? '/' : '') + resolvedPath) || '.'; +}; + +// path.normalize(path) +// posix version +exports.normalize = function(path) { + var isAbsolute = exports.isAbsolute(path), + trailingSlash = substr(path, -1) === '/'; + + // Normalize the path + path = normalizeArray(filter(path.split('/'), function(p) { + return !!p; + }), !isAbsolute).join('/'); + + if (!path && !isAbsolute) { + path = '.'; + } + if (path && trailingSlash) { + path += '/'; + } + + return (isAbsolute ? '/' : '') + path; +}; + +// posix version +exports.isAbsolute = function(path) { + return path.charAt(0) === '/'; +}; + +// posix version +exports.join = function() { + var paths = Array.prototype.slice.call(arguments, 0); + return exports.normalize(filter(paths, function(p, index) { + if (typeof p !== 'string') { + throw new TypeError('Arguments to path.join must be strings'); + } + return p; + }).join('/')); +}; + + +// path.relative(from, to) +// posix version +exports.relative = function(from, to) { + from = exports.resolve(from).substr(1); + to = exports.resolve(to).substr(1); + + function trim(arr) { + var start = 0; + for (; start < arr.length; start++) { + if (arr[start] !== '') break; + } + + var end = arr.length - 1; + for (; end >= 0; end--) { + if (arr[end] !== '') break; + } + + if (start > end) return []; + return arr.slice(start, end - start + 1); + } + + var fromParts = trim(from.split('/')); + var toParts = trim(to.split('/')); + + var length = Math.min(fromParts.length, toParts.length); + var samePartsLength = length; + for (var i = 0; i < length; i++) { + if (fromParts[i] !== toParts[i]) { + samePartsLength = i; + break; + } + } + + var outputParts = []; + for (var i = samePartsLength; i < fromParts.length; i++) { + outputParts.push('..'); + } + + outputParts = outputParts.concat(toParts.slice(samePartsLength)); + + return outputParts.join('/'); +}; + +exports.sep = '/'; +exports.delimiter = ':'; + +exports.dirname = function(path) { + var result = splitPath(path), + root = result[0], + dir = result[1]; + + if (!root && !dir) { + // No dirname whatsoever + return '.'; + } + + if (dir) { + // It has a dirname, strip trailing slash + dir = dir.substr(0, dir.length - 1); + } + + return root + dir; +}; + + +exports.basename = function(path, ext) { + var f = splitPath(path)[2]; + // TODO: make this comparison case-insensitive on windows? + if (ext && f.substr(-1 * ext.length) === ext) { + f = f.substr(0, f.length - ext.length); + } + return f; +}; + + +exports.extname = function(path) { + return splitPath(path)[3]; +}; + +function filter (xs, f) { + if (xs.filter) return xs.filter(f); + var res = []; + for (var i = 0; i < xs.length; i++) { + if (f(xs[i], i, xs)) res.push(xs[i]); + } + return res; +} + +// String.prototype.substr - negative index don't work in IE8 +var substr = 'ab'.substr(-1) === 'b' + ? function (str, start, len) { return str.substr(start, len) } + : function (str, start, len) { + if (start < 0) start = str.length + start; + return str.substr(start, len); + } +; + +}).call(this,require('_process')) +},{"_process":24}],23:[function(require,module,exports){ +(function (process){ +'use strict'; + +function posix(path) { + return path.charAt(0) === '/'; +} + +function win32(path) { + // https://github.com/nodejs/node/blob/b3fcc245fb25539909ef1d5eaa01dbf92e168633/lib/path.js#L56 + var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/; + var result = splitDeviceRe.exec(path); + var device = result[1] || ''; + var isUnc = Boolean(device && device.charAt(1) !== ':'); + + // UNC paths are always absolute + return Boolean(result[2] || isUnc); +} + +module.exports = process.platform === 'win32' ? win32 : posix; +module.exports.posix = posix; +module.exports.win32 = win32; + +}).call(this,require('_process')) +},{"_process":24}],24:[function(require,module,exports){ +// shim for using process in browser +var process = module.exports = {}; + +// cached from whatever global is present so that test runners that stub it +// don't break things. But we need to wrap it in a try catch in case it is +// wrapped in strict mode code which doesn't define any globals. It's inside a +// function because try/catches deoptimize in certain engines. + +var cachedSetTimeout; +var cachedClearTimeout; + +function defaultSetTimout() { + throw new Error('setTimeout has not been defined'); +} +function defaultClearTimeout () { + throw new Error('clearTimeout has not been defined'); +} +(function () { + try { + if (typeof setTimeout === 'function') { + cachedSetTimeout = setTimeout; + } else { + cachedSetTimeout = defaultSetTimout; + } + } catch (e) { + cachedSetTimeout = defaultSetTimout; + } + try { + if (typeof clearTimeout === 'function') { + cachedClearTimeout = clearTimeout; + } else { + cachedClearTimeout = defaultClearTimeout; + } + } catch (e) { + cachedClearTimeout = defaultClearTimeout; + } +} ()) +function runTimeout(fun) { + if (cachedSetTimeout === setTimeout) { + //normal enviroments in sane situations + return setTimeout(fun, 0); + } + // if setTimeout wasn't available but was latter defined + if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) { + cachedSetTimeout = setTimeout; + return setTimeout(fun, 0); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedSetTimeout(fun, 0); + } catch(e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedSetTimeout.call(null, fun, 0); + } catch(e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error + return cachedSetTimeout.call(this, fun, 0); + } + } + + +} +function runClearTimeout(marker) { + if (cachedClearTimeout === clearTimeout) { + //normal enviroments in sane situations + return clearTimeout(marker); + } + // if clearTimeout wasn't available but was latter defined + if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) { + cachedClearTimeout = clearTimeout; + return clearTimeout(marker); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedClearTimeout(marker); + } catch (e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedClearTimeout.call(null, marker); + } catch (e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error. + // Some versions of I.E. have different rules for clearTimeout vs setTimeout + return cachedClearTimeout.call(this, marker); + } + } + + + +} +var queue = []; +var draining = false; +var currentQueue; +var queueIndex = -1; + +function cleanUpNextTick() { + if (!draining || !currentQueue) { + return; + } + draining = false; + if (currentQueue.length) { + queue = currentQueue.concat(queue); + } else { + queueIndex = -1; + } + if (queue.length) { + drainQueue(); + } +} + +function drainQueue() { + if (draining) { + return; + } + var timeout = runTimeout(cleanUpNextTick); + draining = true; + + var len = queue.length; + while(len) { + currentQueue = queue; + queue = []; + while (++queueIndex < len) { + if (currentQueue) { + currentQueue[queueIndex].run(); + } + } + queueIndex = -1; + len = queue.length; + } + currentQueue = null; + draining = false; + runClearTimeout(timeout); +} + +process.nextTick = function (fun) { + var args = new Array(arguments.length - 1); + if (arguments.length > 1) { + for (var i = 1; i < arguments.length; i++) { + args[i - 1] = arguments[i]; + } + } + queue.push(new Item(fun, args)); + if (queue.length === 1 && !draining) { + runTimeout(drainQueue); + } +}; + +// v8 likes predictible objects +function Item(fun, array) { + this.fun = fun; + this.array = array; +} +Item.prototype.run = function () { + this.fun.apply(null, this.array); +}; +process.title = 'browser'; +process.browser = true; +process.env = {}; +process.argv = []; +process.version = ''; // empty string to avoid regexp issues +process.versions = {}; + +function noop() {} + +process.on = noop; +process.addListener = noop; +process.once = noop; +process.off = noop; +process.removeListener = noop; +process.removeAllListeners = noop; +process.emit = noop; +process.prependListener = noop; +process.prependOnceListener = noop; + +process.listeners = function (name) { return [] } + +process.binding = function (name) { + throw new Error('process.binding is not supported'); +}; + +process.cwd = function () { return '/' }; +process.chdir = function (dir) { + throw new Error('process.chdir is not supported'); +}; +process.umask = function() { return 0; }; + +},{}],25:[function(require,module,exports){ +// Underscore.js 1.8.3 +// http://underscorejs.org +// (c) 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors +// Underscore may be freely distributed under the MIT license. + +(function() { + + // Baseline setup + // -------------- + + // Establish the root object, `window` in the browser, or `exports` on the server. + var root = this; + + // Save the previous value of the `_` variable. + var previousUnderscore = root._; + + // Save bytes in the minified (but not gzipped) version: + var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype; + + // Create quick reference variables for speed access to core prototypes. + var + push = ArrayProto.push, + slice = ArrayProto.slice, + toString = ObjProto.toString, + hasOwnProperty = ObjProto.hasOwnProperty; + + // All **ECMAScript 5** native function implementations that we hope to use + // are declared here. + var + nativeIsArray = Array.isArray, + nativeKeys = Object.keys, + nativeBind = FuncProto.bind, + nativeCreate = Object.create; + + // Naked function reference for surrogate-prototype-swapping. + var Ctor = function(){}; + + // Create a safe reference to the Underscore object for use below. + var _ = function(obj) { + if (obj instanceof _) return obj; + if (!(this instanceof _)) return new _(obj); + this._wrapped = obj; + }; + + // Export the Underscore object for **Node.js**, with + // backwards-compatibility for the old `require()` API. If we're in + // the browser, add `_` as a global object. + if (typeof exports !== 'undefined') { + if (typeof module !== 'undefined' && module.exports) { + exports = module.exports = _; + } + exports._ = _; + } else { + root._ = _; + } + + // Current version. + _.VERSION = '1.8.3'; + + // Internal function that returns an efficient (for current engines) version + // of the passed-in callback, to be repeatedly applied in other Underscore + // functions. + var optimizeCb = function(func, context, argCount) { + if (context === void 0) return func; + switch (argCount == null ? 3 : argCount) { + case 1: return function(value) { + return func.call(context, value); + }; + case 2: return function(value, other) { + return func.call(context, value, other); + }; + case 3: return function(value, index, collection) { + return func.call(context, value, index, collection); + }; + case 4: return function(accumulator, value, index, collection) { + return func.call(context, accumulator, value, index, collection); + }; + } + return function() { + return func.apply(context, arguments); + }; + }; + + // A mostly-internal function to generate callbacks that can be applied + // to each element in a collection, returning the desired result — either + // identity, an arbitrary callback, a property matcher, or a property accessor. + var cb = function(value, context, argCount) { + if (value == null) return _.identity; + if (_.isFunction(value)) return optimizeCb(value, context, argCount); + if (_.isObject(value)) return _.matcher(value); + return _.property(value); + }; + _.iteratee = function(value, context) { + return cb(value, context, Infinity); + }; + + // An internal function for creating assigner functions. + var createAssigner = function(keysFunc, undefinedOnly) { + return function(obj) { + var length = arguments.length; + if (length < 2 || obj == null) return obj; + for (var index = 1; index < length; index++) { + var source = arguments[index], + keys = keysFunc(source), + l = keys.length; + for (var i = 0; i < l; i++) { + var key = keys[i]; + if (!undefinedOnly || obj[key] === void 0) obj[key] = source[key]; + } + } + return obj; + }; + }; + + // An internal function for creating a new object that inherits from another. + var baseCreate = function(prototype) { + if (!_.isObject(prototype)) return {}; + if (nativeCreate) return nativeCreate(prototype); + Ctor.prototype = prototype; + var result = new Ctor; + Ctor.prototype = null; + return result; + }; + + var property = function(key) { + return function(obj) { + return obj == null ? void 0 : obj[key]; + }; + }; + + // Helper for collection methods to determine whether a collection + // should be iterated as an array or as an object + // Related: http://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength + // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094 + var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1; + var getLength = property('length'); + var isArrayLike = function(collection) { + var length = getLength(collection); + return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX; + }; + + // Collection Functions + // -------------------- + + // The cornerstone, an `each` implementation, aka `forEach`. + // Handles raw objects in addition to array-likes. Treats all + // sparse array-likes as if they were dense. + _.each = _.forEach = function(obj, iteratee, context) { + iteratee = optimizeCb(iteratee, context); + var i, length; + if (isArrayLike(obj)) { + for (i = 0, length = obj.length; i < length; i++) { + iteratee(obj[i], i, obj); + } + } else { + var keys = _.keys(obj); + for (i = 0, length = keys.length; i < length; i++) { + iteratee(obj[keys[i]], keys[i], obj); + } + } + return obj; + }; + + // Return the results of applying the iteratee to each element. + _.map = _.collect = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + results = Array(length); + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + results[index] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Create a reducing function iterating left or right. + function createReduce(dir) { + // Optimized iterator function as using arguments.length + // in the main function will deoptimize the, see #1991. + function iterator(obj, iteratee, memo, keys, index, length) { + for (; index >= 0 && index < length; index += dir) { + var currentKey = keys ? keys[index] : index; + memo = iteratee(memo, obj[currentKey], currentKey, obj); + } + return memo; + } + + return function(obj, iteratee, memo, context) { + iteratee = optimizeCb(iteratee, context, 4); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + index = dir > 0 ? 0 : length - 1; + // Determine the initial value if none is provided. + if (arguments.length < 3) { + memo = obj[keys ? keys[index] : index]; + index += dir; + } + return iterator(obj, iteratee, memo, keys, index, length); + }; + } + + // **Reduce** builds up a single result from a list of values, aka `inject`, + // or `foldl`. + _.reduce = _.foldl = _.inject = createReduce(1); + + // The right-associative version of reduce, also known as `foldr`. + _.reduceRight = _.foldr = createReduce(-1); + + // Return the first value which passes a truth test. Aliased as `detect`. + _.find = _.detect = function(obj, predicate, context) { + var key; + if (isArrayLike(obj)) { + key = _.findIndex(obj, predicate, context); + } else { + key = _.findKey(obj, predicate, context); + } + if (key !== void 0 && key !== -1) return obj[key]; + }; + + // Return all the elements that pass a truth test. + // Aliased as `select`. + _.filter = _.select = function(obj, predicate, context) { + var results = []; + predicate = cb(predicate, context); + _.each(obj, function(value, index, list) { + if (predicate(value, index, list)) results.push(value); + }); + return results; + }; + + // Return all the elements for which a truth test fails. + _.reject = function(obj, predicate, context) { + return _.filter(obj, _.negate(cb(predicate)), context); + }; + + // Determine whether all of the elements match a truth test. + // Aliased as `all`. + _.every = _.all = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (!predicate(obj[currentKey], currentKey, obj)) return false; + } + return true; + }; + + // Determine if at least one element in the object matches a truth test. + // Aliased as `any`. + _.some = _.any = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (predicate(obj[currentKey], currentKey, obj)) return true; + } + return false; + }; + + // Determine if the array or object contains a given item (using `===`). + // Aliased as `includes` and `include`. + _.contains = _.includes = _.include = function(obj, item, fromIndex, guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + if (typeof fromIndex != 'number' || guard) fromIndex = 0; + return _.indexOf(obj, item, fromIndex) >= 0; + }; + + // Invoke a method (with arguments) on every item in a collection. + _.invoke = function(obj, method) { + var args = slice.call(arguments, 2); + var isFunc = _.isFunction(method); + return _.map(obj, function(value) { + var func = isFunc ? method : value[method]; + return func == null ? func : func.apply(value, args); + }); + }; + + // Convenience version of a common use case of `map`: fetching a property. + _.pluck = function(obj, key) { + return _.map(obj, _.property(key)); + }; + + // Convenience version of a common use case of `filter`: selecting only objects + // containing specific `key:value` pairs. + _.where = function(obj, attrs) { + return _.filter(obj, _.matcher(attrs)); + }; + + // Convenience version of a common use case of `find`: getting the first object + // containing specific `key:value` pairs. + _.findWhere = function(obj, attrs) { + return _.find(obj, _.matcher(attrs)); + }; + + // Return the maximum element (or element-based computation). + _.max = function(obj, iteratee, context) { + var result = -Infinity, lastComputed = -Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value > result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed > lastComputed || computed === -Infinity && result === -Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Return the minimum element (or element-based computation). + _.min = function(obj, iteratee, context) { + var result = Infinity, lastComputed = Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value < result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed < lastComputed || computed === Infinity && result === Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Shuffle a collection, using the modern version of the + // [Fisher-Yates shuffle](http://en.wikipedia.org/wiki/Fisher–Yates_shuffle). + _.shuffle = function(obj) { + var set = isArrayLike(obj) ? obj : _.values(obj); + var length = set.length; + var shuffled = Array(length); + for (var index = 0, rand; index < length; index++) { + rand = _.random(0, index); + if (rand !== index) shuffled[index] = shuffled[rand]; + shuffled[rand] = set[index]; + } + return shuffled; + }; + + // Sample **n** random values from a collection. + // If **n** is not specified, returns a single random element. + // The internal `guard` argument allows it to work with `map`. + _.sample = function(obj, n, guard) { + if (n == null || guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + return obj[_.random(obj.length - 1)]; + } + return _.shuffle(obj).slice(0, Math.max(0, n)); + }; + + // Sort the object's values by a criterion produced by an iteratee. + _.sortBy = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + return _.pluck(_.map(obj, function(value, index, list) { + return { + value: value, + index: index, + criteria: iteratee(value, index, list) + }; + }).sort(function(left, right) { + var a = left.criteria; + var b = right.criteria; + if (a !== b) { + if (a > b || a === void 0) return 1; + if (a < b || b === void 0) return -1; + } + return left.index - right.index; + }), 'value'); + }; + + // An internal function used for aggregate "group by" operations. + var group = function(behavior) { + return function(obj, iteratee, context) { + var result = {}; + iteratee = cb(iteratee, context); + _.each(obj, function(value, index) { + var key = iteratee(value, index, obj); + behavior(result, value, key); + }); + return result; + }; + }; + + // Groups the object's values by a criterion. Pass either a string attribute + // to group by, or a function that returns the criterion. + _.groupBy = group(function(result, value, key) { + if (_.has(result, key)) result[key].push(value); else result[key] = [value]; + }); + + // Indexes the object's values by a criterion, similar to `groupBy`, but for + // when you know that your index values will be unique. + _.indexBy = group(function(result, value, key) { + result[key] = value; + }); + + // Counts instances of an object that group by a certain criterion. Pass + // either a string attribute to count by, or a function that returns the + // criterion. + _.countBy = group(function(result, value, key) { + if (_.has(result, key)) result[key]++; else result[key] = 1; + }); + + // Safely create a real, live array from anything iterable. + _.toArray = function(obj) { + if (!obj) return []; + if (_.isArray(obj)) return slice.call(obj); + if (isArrayLike(obj)) return _.map(obj, _.identity); + return _.values(obj); + }; + + // Return the number of elements in an object. + _.size = function(obj) { + if (obj == null) return 0; + return isArrayLike(obj) ? obj.length : _.keys(obj).length; + }; + + // Split a collection into two arrays: one whose elements all satisfy the given + // predicate, and one whose elements all do not satisfy the predicate. + _.partition = function(obj, predicate, context) { + predicate = cb(predicate, context); + var pass = [], fail = []; + _.each(obj, function(value, key, obj) { + (predicate(value, key, obj) ? pass : fail).push(value); + }); + return [pass, fail]; + }; + + // Array Functions + // --------------- + + // Get the first element of an array. Passing **n** will return the first N + // values in the array. Aliased as `head` and `take`. The **guard** check + // allows it to work with `_.map`. + _.first = _.head = _.take = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[0]; + return _.initial(array, array.length - n); + }; + + // Returns everything but the last entry of the array. Especially useful on + // the arguments object. Passing **n** will return all the values in + // the array, excluding the last N. + _.initial = function(array, n, guard) { + return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n))); + }; + + // Get the last element of an array. Passing **n** will return the last N + // values in the array. + _.last = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[array.length - 1]; + return _.rest(array, Math.max(0, array.length - n)); + }; + + // Returns everything but the first entry of the array. Aliased as `tail` and `drop`. + // Especially useful on the arguments object. Passing an **n** will return + // the rest N values in the array. + _.rest = _.tail = _.drop = function(array, n, guard) { + return slice.call(array, n == null || guard ? 1 : n); + }; + + // Trim out all falsy values from an array. + _.compact = function(array) { + return _.filter(array, _.identity); + }; + + // Internal implementation of a recursive `flatten` function. + var flatten = function(input, shallow, strict, startIndex) { + var output = [], idx = 0; + for (var i = startIndex || 0, length = getLength(input); i < length; i++) { + var value = input[i]; + if (isArrayLike(value) && (_.isArray(value) || _.isArguments(value))) { + //flatten current level of array or arguments object + if (!shallow) value = flatten(value, shallow, strict); + var j = 0, len = value.length; + output.length += len; + while (j < len) { + output[idx++] = value[j++]; + } + } else if (!strict) { + output[idx++] = value; + } + } + return output; + }; + + // Flatten out an array, either recursively (by default), or just one level. + _.flatten = function(array, shallow) { + return flatten(array, shallow, false); + }; + + // Return a version of the array that does not contain the specified value(s). + _.without = function(array) { + return _.difference(array, slice.call(arguments, 1)); + }; + + // Produce a duplicate-free version of the array. If the array has already + // been sorted, you have the option of using a faster algorithm. + // Aliased as `unique`. + _.uniq = _.unique = function(array, isSorted, iteratee, context) { + if (!_.isBoolean(isSorted)) { + context = iteratee; + iteratee = isSorted; + isSorted = false; + } + if (iteratee != null) iteratee = cb(iteratee, context); + var result = []; + var seen = []; + for (var i = 0, length = getLength(array); i < length; i++) { + var value = array[i], + computed = iteratee ? iteratee(value, i, array) : value; + if (isSorted) { + if (!i || seen !== computed) result.push(value); + seen = computed; + } else if (iteratee) { + if (!_.contains(seen, computed)) { + seen.push(computed); + result.push(value); + } + } else if (!_.contains(result, value)) { + result.push(value); + } + } + return result; + }; + + // Produce an array that contains the union: each distinct element from all of + // the passed-in arrays. + _.union = function() { + return _.uniq(flatten(arguments, true, true)); + }; + + // Produce an array that contains every item shared between all the + // passed-in arrays. + _.intersection = function(array) { + var result = []; + var argsLength = arguments.length; + for (var i = 0, length = getLength(array); i < length; i++) { + var item = array[i]; + if (_.contains(result, item)) continue; + for (var j = 1; j < argsLength; j++) { + if (!_.contains(arguments[j], item)) break; + } + if (j === argsLength) result.push(item); + } + return result; + }; + + // Take the difference between one array and a number of other arrays. + // Only the elements present in just the first array will remain. + _.difference = function(array) { + var rest = flatten(arguments, true, true, 1); + return _.filter(array, function(value){ + return !_.contains(rest, value); + }); + }; + + // Zip together multiple lists into a single array -- elements that share + // an index go together. + _.zip = function() { + return _.unzip(arguments); + }; + + // Complement of _.zip. Unzip accepts an array of arrays and groups + // each array's elements on shared indices + _.unzip = function(array) { + var length = array && _.max(array, getLength).length || 0; + var result = Array(length); + + for (var index = 0; index < length; index++) { + result[index] = _.pluck(array, index); + } + return result; + }; + + // Converts lists into objects. Pass either a single array of `[key, value]` + // pairs, or two parallel arrays of the same length -- one of keys, and one of + // the corresponding values. + _.object = function(list, values) { + var result = {}; + for (var i = 0, length = getLength(list); i < length; i++) { + if (values) { + result[list[i]] = values[i]; + } else { + result[list[i][0]] = list[i][1]; + } + } + return result; + }; + + // Generator function to create the findIndex and findLastIndex functions + function createPredicateIndexFinder(dir) { + return function(array, predicate, context) { + predicate = cb(predicate, context); + var length = getLength(array); + var index = dir > 0 ? 0 : length - 1; + for (; index >= 0 && index < length; index += dir) { + if (predicate(array[index], index, array)) return index; + } + return -1; + }; + } + + // Returns the first index on an array-like that passes a predicate test + _.findIndex = createPredicateIndexFinder(1); + _.findLastIndex = createPredicateIndexFinder(-1); + + // Use a comparator function to figure out the smallest index at which + // an object should be inserted so as to maintain order. Uses binary search. + _.sortedIndex = function(array, obj, iteratee, context) { + iteratee = cb(iteratee, context, 1); + var value = iteratee(obj); + var low = 0, high = getLength(array); + while (low < high) { + var mid = Math.floor((low + high) / 2); + if (iteratee(array[mid]) < value) low = mid + 1; else high = mid; + } + return low; + }; + + // Generator function to create the indexOf and lastIndexOf functions + function createIndexFinder(dir, predicateFind, sortedIndex) { + return function(array, item, idx) { + var i = 0, length = getLength(array); + if (typeof idx == 'number') { + if (dir > 0) { + i = idx >= 0 ? idx : Math.max(idx + length, i); + } else { + length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1; + } + } else if (sortedIndex && idx && length) { + idx = sortedIndex(array, item); + return array[idx] === item ? idx : -1; + } + if (item !== item) { + idx = predicateFind(slice.call(array, i, length), _.isNaN); + return idx >= 0 ? idx + i : -1; + } + for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) { + if (array[idx] === item) return idx; + } + return -1; + }; + } + + // Return the position of the first occurrence of an item in an array, + // or -1 if the item is not included in the array. + // If the array is large and already in sort order, pass `true` + // for **isSorted** to use binary search. + _.indexOf = createIndexFinder(1, _.findIndex, _.sortedIndex); + _.lastIndexOf = createIndexFinder(-1, _.findLastIndex); + + // Generate an integer Array containing an arithmetic progression. A port of + // the native Python `range()` function. See + // [the Python documentation](http://docs.python.org/library/functions.html#range). + _.range = function(start, stop, step) { + if (stop == null) { + stop = start || 0; + start = 0; + } + step = step || 1; + + var length = Math.max(Math.ceil((stop - start) / step), 0); + var range = Array(length); + + for (var idx = 0; idx < length; idx++, start += step) { + range[idx] = start; + } + + return range; + }; + + // Function (ahem) Functions + // ------------------ + + // Determines whether to execute a function as a constructor + // or a normal function with the provided arguments + var executeBound = function(sourceFunc, boundFunc, context, callingContext, args) { + if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args); + var self = baseCreate(sourceFunc.prototype); + var result = sourceFunc.apply(self, args); + if (_.isObject(result)) return result; + return self; + }; + + // Create a function bound to a given object (assigning `this`, and arguments, + // optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if + // available. + _.bind = function(func, context) { + if (nativeBind && func.bind === nativeBind) return nativeBind.apply(func, slice.call(arguments, 1)); + if (!_.isFunction(func)) throw new TypeError('Bind must be called on a function'); + var args = slice.call(arguments, 2); + var bound = function() { + return executeBound(func, bound, context, this, args.concat(slice.call(arguments))); + }; + return bound; + }; + + // Partially apply a function by creating a version that has had some of its + // arguments pre-filled, without changing its dynamic `this` context. _ acts + // as a placeholder, allowing any combination of arguments to be pre-filled. + _.partial = function(func) { + var boundArgs = slice.call(arguments, 1); + var bound = function() { + var position = 0, length = boundArgs.length; + var args = Array(length); + for (var i = 0; i < length; i++) { + args[i] = boundArgs[i] === _ ? arguments[position++] : boundArgs[i]; + } + while (position < arguments.length) args.push(arguments[position++]); + return executeBound(func, bound, this, this, args); + }; + return bound; + }; + + // Bind a number of an object's methods to that object. Remaining arguments + // are the method names to be bound. Useful for ensuring that all callbacks + // defined on an object belong to it. + _.bindAll = function(obj) { + var i, length = arguments.length, key; + if (length <= 1) throw new Error('bindAll must be passed function names'); + for (i = 1; i < length; i++) { + key = arguments[i]; + obj[key] = _.bind(obj[key], obj); + } + return obj; + }; + + // Memoize an expensive function by storing its results. + _.memoize = function(func, hasher) { + var memoize = function(key) { + var cache = memoize.cache; + var address = '' + (hasher ? hasher.apply(this, arguments) : key); + if (!_.has(cache, address)) cache[address] = func.apply(this, arguments); + return cache[address]; + }; + memoize.cache = {}; + return memoize; + }; + + // Delays a function for the given number of milliseconds, and then calls + // it with the arguments supplied. + _.delay = function(func, wait) { + var args = slice.call(arguments, 2); + return setTimeout(function(){ + return func.apply(null, args); + }, wait); + }; + + // Defers a function, scheduling it to run after the current call stack has + // cleared. + _.defer = _.partial(_.delay, _, 1); + + // Returns a function, that, when invoked, will only be triggered at most once + // during a given window of time. Normally, the throttled function will run + // as much as it can, without ever going more than once per `wait` duration; + // but if you'd like to disable the execution on the leading edge, pass + // `{leading: false}`. To disable execution on the trailing edge, ditto. + _.throttle = function(func, wait, options) { + var context, args, result; + var timeout = null; + var previous = 0; + if (!options) options = {}; + var later = function() { + previous = options.leading === false ? 0 : _.now(); + timeout = null; + result = func.apply(context, args); + if (!timeout) context = args = null; + }; + return function() { + var now = _.now(); + if (!previous && options.leading === false) previous = now; + var remaining = wait - (now - previous); + context = this; + args = arguments; + if (remaining <= 0 || remaining > wait) { + if (timeout) { + clearTimeout(timeout); + timeout = null; + } + previous = now; + result = func.apply(context, args); + if (!timeout) context = args = null; + } else if (!timeout && options.trailing !== false) { + timeout = setTimeout(later, remaining); + } + return result; + }; + }; + + // Returns a function, that, as long as it continues to be invoked, will not + // be triggered. The function will be called after it stops being called for + // N milliseconds. If `immediate` is passed, trigger the function on the + // leading edge, instead of the trailing. + _.debounce = function(func, wait, immediate) { + var timeout, args, context, timestamp, result; + + var later = function() { + var last = _.now() - timestamp; + + if (last < wait && last >= 0) { + timeout = setTimeout(later, wait - last); + } else { + timeout = null; + if (!immediate) { + result = func.apply(context, args); + if (!timeout) context = args = null; + } + } + }; + + return function() { + context = this; + args = arguments; + timestamp = _.now(); + var callNow = immediate && !timeout; + if (!timeout) timeout = setTimeout(later, wait); + if (callNow) { + result = func.apply(context, args); + context = args = null; + } + + return result; + }; + }; + + // Returns the first function passed as an argument to the second, + // allowing you to adjust arguments, run code before and after, and + // conditionally execute the original function. + _.wrap = function(func, wrapper) { + return _.partial(wrapper, func); + }; + + // Returns a negated version of the passed-in predicate. + _.negate = function(predicate) { + return function() { + return !predicate.apply(this, arguments); + }; + }; + + // Returns a function that is the composition of a list of functions, each + // consuming the return value of the function that follows. + _.compose = function() { + var args = arguments; + var start = args.length - 1; + return function() { + var i = start; + var result = args[start].apply(this, arguments); + while (i--) result = args[i].call(this, result); + return result; + }; + }; + + // Returns a function that will only be executed on and after the Nth call. + _.after = function(times, func) { + return function() { + if (--times < 1) { + return func.apply(this, arguments); + } + }; + }; + + // Returns a function that will only be executed up to (but not including) the Nth call. + _.before = function(times, func) { + var memo; + return function() { + if (--times > 0) { + memo = func.apply(this, arguments); + } + if (times <= 1) func = null; + return memo; + }; + }; + + // Returns a function that will be executed at most one time, no matter how + // often you call it. Useful for lazy initialization. + _.once = _.partial(_.before, 2); + + // Object Functions + // ---------------- + + // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed. + var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString'); + var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString', + 'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString']; + + function collectNonEnumProps(obj, keys) { + var nonEnumIdx = nonEnumerableProps.length; + var constructor = obj.constructor; + var proto = (_.isFunction(constructor) && constructor.prototype) || ObjProto; + + // Constructor is a special case. + var prop = 'constructor'; + if (_.has(obj, prop) && !_.contains(keys, prop)) keys.push(prop); + + while (nonEnumIdx--) { + prop = nonEnumerableProps[nonEnumIdx]; + if (prop in obj && obj[prop] !== proto[prop] && !_.contains(keys, prop)) { + keys.push(prop); + } + } + } + + // Retrieve the names of an object's own properties. + // Delegates to **ECMAScript 5**'s native `Object.keys` + _.keys = function(obj) { + if (!_.isObject(obj)) return []; + if (nativeKeys) return nativeKeys(obj); + var keys = []; + for (var key in obj) if (_.has(obj, key)) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve all the property names of an object. + _.allKeys = function(obj) { + if (!_.isObject(obj)) return []; + var keys = []; + for (var key in obj) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve the values of an object's properties. + _.values = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var values = Array(length); + for (var i = 0; i < length; i++) { + values[i] = obj[keys[i]]; + } + return values; + }; + + // Returns the results of applying the iteratee to each element of the object + // In contrast to _.map it returns an object + _.mapObject = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = _.keys(obj), + length = keys.length, + results = {}, + currentKey; + for (var index = 0; index < length; index++) { + currentKey = keys[index]; + results[currentKey] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Convert an object into a list of `[key, value]` pairs. + _.pairs = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var pairs = Array(length); + for (var i = 0; i < length; i++) { + pairs[i] = [keys[i], obj[keys[i]]]; + } + return pairs; + }; + + // Invert the keys and values of an object. The values must be serializable. + _.invert = function(obj) { + var result = {}; + var keys = _.keys(obj); + for (var i = 0, length = keys.length; i < length; i++) { + result[obj[keys[i]]] = keys[i]; + } + return result; + }; + + // Return a sorted list of the function names available on the object. + // Aliased as `methods` + _.functions = _.methods = function(obj) { + var names = []; + for (var key in obj) { + if (_.isFunction(obj[key])) names.push(key); + } + return names.sort(); + }; + + // Extend a given object with all the properties in passed-in object(s). + _.extend = createAssigner(_.allKeys); + + // Assigns a given object with all the own properties in the passed-in object(s) + // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign) + _.extendOwn = _.assign = createAssigner(_.keys); + + // Returns the first key on an object that passes a predicate test + _.findKey = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = _.keys(obj), key; + for (var i = 0, length = keys.length; i < length; i++) { + key = keys[i]; + if (predicate(obj[key], key, obj)) return key; + } + }; + + // Return a copy of the object only containing the whitelisted properties. + _.pick = function(object, oiteratee, context) { + var result = {}, obj = object, iteratee, keys; + if (obj == null) return result; + if (_.isFunction(oiteratee)) { + keys = _.allKeys(obj); + iteratee = optimizeCb(oiteratee, context); + } else { + keys = flatten(arguments, false, false, 1); + iteratee = function(value, key, obj) { return key in obj; }; + obj = Object(obj); + } + for (var i = 0, length = keys.length; i < length; i++) { + var key = keys[i]; + var value = obj[key]; + if (iteratee(value, key, obj)) result[key] = value; + } + return result; + }; + + // Return a copy of the object without the blacklisted properties. + _.omit = function(obj, iteratee, context) { + if (_.isFunction(iteratee)) { + iteratee = _.negate(iteratee); + } else { + var keys = _.map(flatten(arguments, false, false, 1), String); + iteratee = function(value, key) { + return !_.contains(keys, key); + }; + } + return _.pick(obj, iteratee, context); + }; + + // Fill in a given object with default properties. + _.defaults = createAssigner(_.allKeys, true); + + // Creates an object that inherits from the given prototype object. + // If additional properties are provided then they will be added to the + // created object. + _.create = function(prototype, props) { + var result = baseCreate(prototype); + if (props) _.extendOwn(result, props); + return result; + }; + + // Create a (shallow-cloned) duplicate of an object. + _.clone = function(obj) { + if (!_.isObject(obj)) return obj; + return _.isArray(obj) ? obj.slice() : _.extend({}, obj); + }; + + // Invokes interceptor with the obj, and then returns obj. + // The primary purpose of this method is to "tap into" a method chain, in + // order to perform operations on intermediate results within the chain. + _.tap = function(obj, interceptor) { + interceptor(obj); + return obj; + }; + + // Returns whether an object has a given set of `key:value` pairs. + _.isMatch = function(object, attrs) { + var keys = _.keys(attrs), length = keys.length; + if (object == null) return !length; + var obj = Object(object); + for (var i = 0; i < length; i++) { + var key = keys[i]; + if (attrs[key] !== obj[key] || !(key in obj)) return false; + } + return true; + }; + + + // Internal recursive comparison function for `isEqual`. + var eq = function(a, b, aStack, bStack) { + // Identical objects are equal. `0 === -0`, but they aren't identical. + // See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal). + if (a === b) return a !== 0 || 1 / a === 1 / b; + // A strict comparison is necessary because `null == undefined`. + if (a == null || b == null) return a === b; + // Unwrap any wrapped objects. + if (a instanceof _) a = a._wrapped; + if (b instanceof _) b = b._wrapped; + // Compare `[[Class]]` names. + var className = toString.call(a); + if (className !== toString.call(b)) return false; + switch (className) { + // Strings, numbers, regular expressions, dates, and booleans are compared by value. + case '[object RegExp]': + // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i') + case '[object String]': + // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is + // equivalent to `new String("5")`. + return '' + a === '' + b; + case '[object Number]': + // `NaN`s are equivalent, but non-reflexive. + // Object(NaN) is equivalent to NaN + if (+a !== +a) return +b !== +b; + // An `egal` comparison is performed for other numeric values. + return +a === 0 ? 1 / +a === 1 / b : +a === +b; + case '[object Date]': + case '[object Boolean]': + // Coerce dates and booleans to numeric primitive values. Dates are compared by their + // millisecond representations. Note that invalid dates with millisecond representations + // of `NaN` are not equivalent. + return +a === +b; + } + + var areArrays = className === '[object Array]'; + if (!areArrays) { + if (typeof a != 'object' || typeof b != 'object') return false; + + // Objects with different constructors are not equivalent, but `Object`s or `Array`s + // from different frames are. + var aCtor = a.constructor, bCtor = b.constructor; + if (aCtor !== bCtor && !(_.isFunction(aCtor) && aCtor instanceof aCtor && + _.isFunction(bCtor) && bCtor instanceof bCtor) + && ('constructor' in a && 'constructor' in b)) { + return false; + } + } + // Assume equality for cyclic structures. The algorithm for detecting cyclic + // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`. + + // Initializing stack of traversed objects. + // It's done here since we only need them for objects and arrays comparison. + aStack = aStack || []; + bStack = bStack || []; + var length = aStack.length; + while (length--) { + // Linear search. Performance is inversely proportional to the number of + // unique nested structures. + if (aStack[length] === a) return bStack[length] === b; + } + + // Add the first object to the stack of traversed objects. + aStack.push(a); + bStack.push(b); + + // Recursively compare objects and arrays. + if (areArrays) { + // Compare array lengths to determine if a deep comparison is necessary. + length = a.length; + if (length !== b.length) return false; + // Deep compare the contents, ignoring non-numeric properties. + while (length--) { + if (!eq(a[length], b[length], aStack, bStack)) return false; + } + } else { + // Deep compare objects. + var keys = _.keys(a), key; + length = keys.length; + // Ensure that both objects contain the same number of properties before comparing deep equality. + if (_.keys(b).length !== length) return false; + while (length--) { + // Deep compare each member + key = keys[length]; + if (!(_.has(b, key) && eq(a[key], b[key], aStack, bStack))) return false; + } + } + // Remove the first object from the stack of traversed objects. + aStack.pop(); + bStack.pop(); + return true; + }; + + // Perform a deep comparison to check if two objects are equal. + _.isEqual = function(a, b) { + return eq(a, b); + }; + + // Is a given array, string, or object empty? + // An "empty" object has no enumerable own-properties. + _.isEmpty = function(obj) { + if (obj == null) return true; + if (isArrayLike(obj) && (_.isArray(obj) || _.isString(obj) || _.isArguments(obj))) return obj.length === 0; + return _.keys(obj).length === 0; + }; + + // Is a given value a DOM element? + _.isElement = function(obj) { + return !!(obj && obj.nodeType === 1); + }; + + // Is a given value an array? + // Delegates to ECMA5's native Array.isArray + _.isArray = nativeIsArray || function(obj) { + return toString.call(obj) === '[object Array]'; + }; + + // Is a given variable an object? + _.isObject = function(obj) { + var type = typeof obj; + return type === 'function' || type === 'object' && !!obj; + }; + + // Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp, isError. + _.each(['Arguments', 'Function', 'String', 'Number', 'Date', 'RegExp', 'Error'], function(name) { + _['is' + name] = function(obj) { + return toString.call(obj) === '[object ' + name + ']'; + }; + }); + + // Define a fallback version of the method in browsers (ahem, IE < 9), where + // there isn't any inspectable "Arguments" type. + if (!_.isArguments(arguments)) { + _.isArguments = function(obj) { + return _.has(obj, 'callee'); + }; + } + + // Optimize `isFunction` if appropriate. Work around some typeof bugs in old v8, + // IE 11 (#1621), and in Safari 8 (#1929). + if (typeof /./ != 'function' && typeof Int8Array != 'object') { + _.isFunction = function(obj) { + return typeof obj == 'function' || false; + }; + } + + // Is a given object a finite number? + _.isFinite = function(obj) { + return isFinite(obj) && !isNaN(parseFloat(obj)); + }; + + // Is the given value `NaN`? (NaN is the only number which does not equal itself). + _.isNaN = function(obj) { + return _.isNumber(obj) && obj !== +obj; + }; + + // Is a given value a boolean? + _.isBoolean = function(obj) { + return obj === true || obj === false || toString.call(obj) === '[object Boolean]'; + }; + + // Is a given value equal to null? + _.isNull = function(obj) { + return obj === null; + }; + + // Is a given variable undefined? + _.isUndefined = function(obj) { + return obj === void 0; + }; + + // Shortcut function for checking if an object has a given property directly + // on itself (in other words, not on a prototype). + _.has = function(obj, key) { + return obj != null && hasOwnProperty.call(obj, key); + }; + + // Utility Functions + // ----------------- + + // Run Underscore.js in *noConflict* mode, returning the `_` variable to its + // previous owner. Returns a reference to the Underscore object. + _.noConflict = function() { + root._ = previousUnderscore; + return this; + }; + + // Keep the identity function around for default iteratees. + _.identity = function(value) { + return value; + }; + + // Predicate-generating functions. Often useful outside of Underscore. + _.constant = function(value) { + return function() { + return value; + }; + }; + + _.noop = function(){}; + + _.property = property; + + // Generates a function for a given object that returns a given property. + _.propertyOf = function(obj) { + return obj == null ? function(){} : function(key) { + return obj[key]; + }; + }; + + // Returns a predicate for checking whether an object has a given set of + // `key:value` pairs. + _.matcher = _.matches = function(attrs) { + attrs = _.extendOwn({}, attrs); + return function(obj) { + return _.isMatch(obj, attrs); + }; + }; + + // Run a function **n** times. + _.times = function(n, iteratee, context) { + var accum = Array(Math.max(0, n)); + iteratee = optimizeCb(iteratee, context, 1); + for (var i = 0; i < n; i++) accum[i] = iteratee(i); + return accum; + }; + + // Return a random integer between min and max (inclusive). + _.random = function(min, max) { + if (max == null) { + max = min; + min = 0; + } + return min + Math.floor(Math.random() * (max - min + 1)); + }; + + // A (possibly faster) way to get the current timestamp as an integer. + _.now = Date.now || function() { + return new Date().getTime(); + }; + + // List of HTML entities for escaping. + var escapeMap = { + '&': '&', + '<': '<', + '>': '>', + '"': '"', + "'": ''', + '`': '`' + }; + var unescapeMap = _.invert(escapeMap); + + // Functions for escaping and unescaping strings to/from HTML interpolation. + var createEscaper = function(map) { + var escaper = function(match) { + return map[match]; + }; + // Regexes for identifying a key that needs to be escaped + var source = '(?:' + _.keys(map).join('|') + ')'; + var testRegexp = RegExp(source); + var replaceRegexp = RegExp(source, 'g'); + return function(string) { + string = string == null ? '' : '' + string; + return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string; + }; + }; + _.escape = createEscaper(escapeMap); + _.unescape = createEscaper(unescapeMap); + + // If the value of the named `property` is a function then invoke it with the + // `object` as context; otherwise, return it. + _.result = function(object, property, fallback) { + var value = object == null ? void 0 : object[property]; + if (value === void 0) { + value = fallback; + } + return _.isFunction(value) ? value.call(object) : value; + }; + + // Generate a unique integer id (unique within the entire client session). + // Useful for temporary DOM ids. + var idCounter = 0; + _.uniqueId = function(prefix) { + var id = ++idCounter + ''; + return prefix ? prefix + id : id; + }; + + // By default, Underscore uses ERB-style template delimiters, change the + // following template settings to use alternative delimiters. + _.templateSettings = { + evaluate : /<%([\s\S]+?)%>/g, + interpolate : /<%=([\s\S]+?)%>/g, + escape : /<%-([\s\S]+?)%>/g + }; + + // When customizing `templateSettings`, if you don't want to define an + // interpolation, evaluation or escaping regex, we need one that is + // guaranteed not to match. + var noMatch = /(.)^/; + + // Certain characters need to be escaped so that they can be put into a + // string literal. + var escapes = { + "'": "'", + '\\': '\\', + '\r': 'r', + '\n': 'n', + '\u2028': 'u2028', + '\u2029': 'u2029' + }; + + var escaper = /\\|'|\r|\n|\u2028|\u2029/g; + + var escapeChar = function(match) { + return '\\' + escapes[match]; + }; + + // JavaScript micro-templating, similar to John Resig's implementation. + // Underscore templating handles arbitrary delimiters, preserves whitespace, + // and correctly escapes quotes within interpolated code. + // NB: `oldSettings` only exists for backwards compatibility. + _.template = function(text, settings, oldSettings) { + if (!settings && oldSettings) settings = oldSettings; + settings = _.defaults({}, settings, _.templateSettings); + + // Combine delimiters into one regular expression via alternation. + var matcher = RegExp([ + (settings.escape || noMatch).source, + (settings.interpolate || noMatch).source, + (settings.evaluate || noMatch).source + ].join('|') + '|$', 'g'); + + // Compile the template source, escaping string literals appropriately. + var index = 0; + var source = "__p+='"; + text.replace(matcher, function(match, escape, interpolate, evaluate, offset) { + source += text.slice(index, offset).replace(escaper, escapeChar); + index = offset + match.length; + + if (escape) { + source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'"; + } else if (interpolate) { + source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'"; + } else if (evaluate) { + source += "';\n" + evaluate + "\n__p+='"; + } + + // Adobe VMs need the match returned to produce the correct offest. + return match; + }); + source += "';\n"; + + // If a variable is not specified, place data values in local scope. + if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n'; + + source = "var __t,__p='',__j=Array.prototype.join," + + "print=function(){__p+=__j.call(arguments,'');};\n" + + source + 'return __p;\n'; + + try { + var render = new Function(settings.variable || 'obj', '_', source); + } catch (e) { + e.source = source; + throw e; + } + + var template = function(data) { + return render.call(this, data, _); + }; + + // Provide the compiled source as a convenience for precompilation. + var argument = settings.variable || 'obj'; + template.source = 'function(' + argument + '){\n' + source + '}'; + + return template; + }; + + // Add a "chain" function. Start chaining a wrapped Underscore object. + _.chain = function(obj) { + var instance = _(obj); + instance._chain = true; + return instance; + }; + + // OOP + // --------------- + // If Underscore is called as a function, it returns a wrapped object that + // can be used OO-style. This wrapper holds altered versions of all the + // underscore functions. Wrapped objects may be chained. + + // Helper function to continue chaining intermediate results. + var result = function(instance, obj) { + return instance._chain ? _(obj).chain() : obj; + }; + + // Add your own custom functions to the Underscore object. + _.mixin = function(obj) { + _.each(_.functions(obj), function(name) { + var func = _[name] = obj[name]; + _.prototype[name] = function() { + var args = [this._wrapped]; + push.apply(args, arguments); + return result(this, func.apply(_, args)); + }; + }); + }; + + // Add all of the Underscore functions to the wrapper object. + _.mixin(_); + + // Add all mutator Array functions to the wrapper. + _.each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + var obj = this._wrapped; + method.apply(obj, arguments); + if ((name === 'shift' || name === 'splice') && obj.length === 0) delete obj[0]; + return result(this, obj); + }; + }); + + // Add all accessor Array functions to the wrapper. + _.each(['concat', 'join', 'slice'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + return result(this, method.apply(this._wrapped, arguments)); + }; + }); + + // Extracts the result from a wrapped and chained object. + _.prototype.value = function() { + return this._wrapped; + }; + + // Provide unwrapping proxy for some methods used in engine operations + // such as arithmetic and JSON stringification. + _.prototype.valueOf = _.prototype.toJSON = _.prototype.value; + + _.prototype.toString = function() { + return '' + this._wrapped; + }; + + // AMD registration happens at the end for compatibility with AMD loaders + // that may not enforce next-turn semantics on modules. Even though general + // practice for AMD registration is to be anonymous, underscore registers + // as a named module because, like jQuery, it is a base library that is + // popular enough to be bundled in a third party lib, but not be part of + // an AMD load request. Those cases could generate an error when an + // anonymous define() is called outside of a loader request. + if (typeof define === 'function' && define.amd) { + define('underscore', [], function() { + return _; + }); + } +}.call(this)); + +},{}],26:[function(require,module,exports){ +arguments[4][19][0].apply(exports,arguments) +},{"dup":19}],27:[function(require,module,exports){ +module.exports = function isBuffer(arg) { + return arg && typeof arg === 'object' + && typeof arg.copy === 'function' + && typeof arg.fill === 'function' + && typeof arg.readUInt8 === 'function'; +} +},{}],28:[function(require,module,exports){ +(function (process,global){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +var formatRegExp = /%[sdj%]/g; +exports.format = function(f) { + if (!isString(f)) { + var objects = []; + for (var i = 0; i < arguments.length; i++) { + objects.push(inspect(arguments[i])); + } + return objects.join(' '); + } + + var i = 1; + var args = arguments; + var len = args.length; + var str = String(f).replace(formatRegExp, function(x) { + if (x === '%%') return '%'; + if (i >= len) return x; + switch (x) { + case '%s': return String(args[i++]); + case '%d': return Number(args[i++]); + case '%j': + try { + return JSON.stringify(args[i++]); + } catch (_) { + return '[Circular]'; + } + default: + return x; + } + }); + for (var x = args[i]; i < len; x = args[++i]) { + if (isNull(x) || !isObject(x)) { + str += ' ' + x; + } else { + str += ' ' + inspect(x); + } + } + return str; +}; + + +// Mark that a method should not be used. +// Returns a modified function which warns once by default. +// If --no-deprecation is set, then it is a no-op. +exports.deprecate = function(fn, msg) { + // Allow for deprecating things in the process of starting up. + if (isUndefined(global.process)) { + return function() { + return exports.deprecate(fn, msg).apply(this, arguments); + }; + } + + if (process.noDeprecation === true) { + return fn; + } + + var warned = false; + function deprecated() { + if (!warned) { + if (process.throwDeprecation) { + throw new Error(msg); + } else if (process.traceDeprecation) { + console.trace(msg); + } else { + console.error(msg); + } + warned = true; + } + return fn.apply(this, arguments); + } + + return deprecated; +}; + + +var debugs = {}; +var debugEnviron; +exports.debuglog = function(set) { + if (isUndefined(debugEnviron)) + debugEnviron = process.env.NODE_DEBUG || ''; + set = set.toUpperCase(); + if (!debugs[set]) { + if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) { + var pid = process.pid; + debugs[set] = function() { + var msg = exports.format.apply(exports, arguments); + console.error('%s %d: %s', set, pid, msg); + }; + } else { + debugs[set] = function() {}; + } + } + return debugs[set]; +}; + + +/** + * Echos the value of a value. Trys to print the value out + * in the best way possible given the different types. + * + * @param {Object} obj The object to print out. + * @param {Object} opts Optional options object that alters the output. + */ +/* legacy: obj, showHidden, depth, colors*/ +function inspect(obj, opts) { + // default options + var ctx = { + seen: [], + stylize: stylizeNoColor + }; + // legacy... + if (arguments.length >= 3) ctx.depth = arguments[2]; + if (arguments.length >= 4) ctx.colors = arguments[3]; + if (isBoolean(opts)) { + // legacy... + ctx.showHidden = opts; + } else if (opts) { + // got an "options" object + exports._extend(ctx, opts); + } + // set default options + if (isUndefined(ctx.showHidden)) ctx.showHidden = false; + if (isUndefined(ctx.depth)) ctx.depth = 2; + if (isUndefined(ctx.colors)) ctx.colors = false; + if (isUndefined(ctx.customInspect)) ctx.customInspect = true; + if (ctx.colors) ctx.stylize = stylizeWithColor; + return formatValue(ctx, obj, ctx.depth); +} +exports.inspect = inspect; + + +// http://en.wikipedia.org/wiki/ANSI_escape_code#graphics +inspect.colors = { + 'bold' : [1, 22], + 'italic' : [3, 23], + 'underline' : [4, 24], + 'inverse' : [7, 27], + 'white' : [37, 39], + 'grey' : [90, 39], + 'black' : [30, 39], + 'blue' : [34, 39], + 'cyan' : [36, 39], + 'green' : [32, 39], + 'magenta' : [35, 39], + 'red' : [31, 39], + 'yellow' : [33, 39] +}; + +// Don't use 'blue' not visible on cmd.exe +inspect.styles = { + 'special': 'cyan', + 'number': 'yellow', + 'boolean': 'yellow', + 'undefined': 'grey', + 'null': 'bold', + 'string': 'green', + 'date': 'magenta', + // "name": intentionally not styling + 'regexp': 'red' +}; + + +function stylizeWithColor(str, styleType) { + var style = inspect.styles[styleType]; + + if (style) { + return '\u001b[' + inspect.colors[style][0] + 'm' + str + + '\u001b[' + inspect.colors[style][1] + 'm'; + } else { + return str; + } +} + + +function stylizeNoColor(str, styleType) { + return str; +} + + +function arrayToHash(array) { + var hash = {}; + + array.forEach(function(val, idx) { + hash[val] = true; + }); + + return hash; +} + + +function formatValue(ctx, value, recurseTimes) { + // Provide a hook for user-specified inspect functions. + // Check that value is an object with an inspect function on it + if (ctx.customInspect && + value && + isFunction(value.inspect) && + // Filter out the util module, it's inspect function is special + value.inspect !== exports.inspect && + // Also filter out any prototype objects using the circular check. + !(value.constructor && value.constructor.prototype === value)) { + var ret = value.inspect(recurseTimes, ctx); + if (!isString(ret)) { + ret = formatValue(ctx, ret, recurseTimes); + } + return ret; + } + + // Primitive types cannot have properties + var primitive = formatPrimitive(ctx, value); + if (primitive) { + return primitive; + } + + // Look up the keys of the object. + var keys = Object.keys(value); + var visibleKeys = arrayToHash(keys); + + if (ctx.showHidden) { + keys = Object.getOwnPropertyNames(value); + } + + // IE doesn't make error fields non-enumerable + // http://msdn.microsoft.com/en-us/library/ie/dww52sbt(v=vs.94).aspx + if (isError(value) + && (keys.indexOf('message') >= 0 || keys.indexOf('description') >= 0)) { + return formatError(value); + } + + // Some type of object without properties can be shortcutted. + if (keys.length === 0) { + if (isFunction(value)) { + var name = value.name ? ': ' + value.name : ''; + return ctx.stylize('[Function' + name + ']', 'special'); + } + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } + if (isDate(value)) { + return ctx.stylize(Date.prototype.toString.call(value), 'date'); + } + if (isError(value)) { + return formatError(value); + } + } + + var base = '', array = false, braces = ['{', '}']; + + // Make Array say that they are Array + if (isArray(value)) { + array = true; + braces = ['[', ']']; + } + + // Make functions say that they are functions + if (isFunction(value)) { + var n = value.name ? ': ' + value.name : ''; + base = ' [Function' + n + ']'; + } + + // Make RegExps say that they are RegExps + if (isRegExp(value)) { + base = ' ' + RegExp.prototype.toString.call(value); + } + + // Make dates with properties first say the date + if (isDate(value)) { + base = ' ' + Date.prototype.toUTCString.call(value); + } + + // Make error with message first say the error + if (isError(value)) { + base = ' ' + formatError(value); + } + + if (keys.length === 0 && (!array || value.length == 0)) { + return braces[0] + base + braces[1]; + } + + if (recurseTimes < 0) { + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } else { + return ctx.stylize('[Object]', 'special'); + } + } + + ctx.seen.push(value); + + var output; + if (array) { + output = formatArray(ctx, value, recurseTimes, visibleKeys, keys); + } else { + output = keys.map(function(key) { + return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array); + }); + } + + ctx.seen.pop(); + + return reduceToSingleString(output, base, braces); +} + + +function formatPrimitive(ctx, value) { + if (isUndefined(value)) + return ctx.stylize('undefined', 'undefined'); + if (isString(value)) { + var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '') + .replace(/'/g, "\\'") + .replace(/\\"/g, '"') + '\''; + return ctx.stylize(simple, 'string'); + } + if (isNumber(value)) + return ctx.stylize('' + value, 'number'); + if (isBoolean(value)) + return ctx.stylize('' + value, 'boolean'); + // For some reason typeof null is "object", so special case here. + if (isNull(value)) + return ctx.stylize('null', 'null'); +} + + +function formatError(value) { + return '[' + Error.prototype.toString.call(value) + ']'; +} + + +function formatArray(ctx, value, recurseTimes, visibleKeys, keys) { + var output = []; + for (var i = 0, l = value.length; i < l; ++i) { + if (hasOwnProperty(value, String(i))) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + String(i), true)); + } else { + output.push(''); + } + } + keys.forEach(function(key) { + if (!key.match(/^\d+$/)) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + key, true)); + } + }); + return output; +} + + +function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) { + var name, str, desc; + desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] }; + if (desc.get) { + if (desc.set) { + str = ctx.stylize('[Getter/Setter]', 'special'); + } else { + str = ctx.stylize('[Getter]', 'special'); + } + } else { + if (desc.set) { + str = ctx.stylize('[Setter]', 'special'); + } + } + if (!hasOwnProperty(visibleKeys, key)) { + name = '[' + key + ']'; + } + if (!str) { + if (ctx.seen.indexOf(desc.value) < 0) { + if (isNull(recurseTimes)) { + str = formatValue(ctx, desc.value, null); + } else { + str = formatValue(ctx, desc.value, recurseTimes - 1); + } + if (str.indexOf('\n') > -1) { + if (array) { + str = str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n').substr(2); + } else { + str = '\n' + str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n'); + } + } + } else { + str = ctx.stylize('[Circular]', 'special'); + } + } + if (isUndefined(name)) { + if (array && key.match(/^\d+$/)) { + return str; + } + name = JSON.stringify('' + key); + if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) { + name = name.substr(1, name.length - 2); + name = ctx.stylize(name, 'name'); + } else { + name = name.replace(/'/g, "\\'") + .replace(/\\"/g, '"') + .replace(/(^"|"$)/g, "'"); + name = ctx.stylize(name, 'string'); + } + } + + return name + ': ' + str; +} + + +function reduceToSingleString(output, base, braces) { + var numLinesEst = 0; + var length = output.reduce(function(prev, cur) { + numLinesEst++; + if (cur.indexOf('\n') >= 0) numLinesEst++; + return prev + cur.replace(/\u001b\[\d\d?m/g, '').length + 1; + }, 0); + + if (length > 60) { + return braces[0] + + (base === '' ? '' : base + '\n ') + + ' ' + + output.join(',\n ') + + ' ' + + braces[1]; + } + + return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1]; +} + + +// NOTE: These type checking functions intentionally don't use `instanceof` +// because it is fragile and can be easily faked with `Object.create()`. +function isArray(ar) { + return Array.isArray(ar); +} +exports.isArray = isArray; + +function isBoolean(arg) { + return typeof arg === 'boolean'; +} +exports.isBoolean = isBoolean; + +function isNull(arg) { + return arg === null; +} +exports.isNull = isNull; + +function isNullOrUndefined(arg) { + return arg == null; +} +exports.isNullOrUndefined = isNullOrUndefined; + +function isNumber(arg) { + return typeof arg === 'number'; +} +exports.isNumber = isNumber; + +function isString(arg) { + return typeof arg === 'string'; +} +exports.isString = isString; + +function isSymbol(arg) { + return typeof arg === 'symbol'; +} +exports.isSymbol = isSymbol; + +function isUndefined(arg) { + return arg === void 0; +} +exports.isUndefined = isUndefined; + +function isRegExp(re) { + return isObject(re) && objectToString(re) === '[object RegExp]'; +} +exports.isRegExp = isRegExp; + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} +exports.isObject = isObject; + +function isDate(d) { + return isObject(d) && objectToString(d) === '[object Date]'; +} +exports.isDate = isDate; + +function isError(e) { + return isObject(e) && + (objectToString(e) === '[object Error]' || e instanceof Error); +} +exports.isError = isError; + +function isFunction(arg) { + return typeof arg === 'function'; +} +exports.isFunction = isFunction; + +function isPrimitive(arg) { + return arg === null || + typeof arg === 'boolean' || + typeof arg === 'number' || + typeof arg === 'string' || + typeof arg === 'symbol' || // ES6 symbol + typeof arg === 'undefined'; +} +exports.isPrimitive = isPrimitive; + +exports.isBuffer = require('./support/isBuffer'); + +function objectToString(o) { + return Object.prototype.toString.call(o); +} + + +function pad(n) { + return n < 10 ? '0' + n.toString(10) : n.toString(10); +} + + +var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', + 'Oct', 'Nov', 'Dec']; + +// 26 Feb 16:19:34 +function timestamp() { + var d = new Date(); + var time = [pad(d.getHours()), + pad(d.getMinutes()), + pad(d.getSeconds())].join(':'); + return [d.getDate(), months[d.getMonth()], time].join(' '); +} + + +// log is just a thin wrapper to console.log that prepends a timestamp +exports.log = function() { + console.log('%s - %s', timestamp(), exports.format.apply(exports, arguments)); +}; + + +/** + * Inherit the prototype methods from one constructor into another. + * + * The Function.prototype.inherits from lang.js rewritten as a standalone + * function (not on Function.prototype). NOTE: If this file is to be loaded + * during bootstrapping this function needs to be rewritten using some native + * functions as prototype setup using normal JavaScript does not work as + * expected during bootstrapping (see mirror.js in r114903). + * + * @param {function} ctor Constructor function which needs to inherit the + * prototype. + * @param {function} superCtor Constructor function to inherit prototype from. + */ +exports.inherits = require('inherits'); + +exports._extend = function(origin, add) { + // Don't do anything if add isn't an object + if (!add || !isObject(add)) return origin; + + var keys = Object.keys(add); + var i = keys.length; + while (i--) { + origin[keys[i]] = add[keys[i]]; + } + return origin; +}; + +function hasOwnProperty(obj, prop) { + return Object.prototype.hasOwnProperty.call(obj, prop); +} + +}).call(this,require('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {}) +},{"./support/isBuffer":27,"_process":24,"inherits":26}],29:[function(require,module,exports){ +// Returns a wrapper function that returns a wrapped callback +// The wrapper function should do some stuff, and return a +// presumably different callback function. +// This makes sure that own properties are retained, so that +// decorations and such are not lost along the way. +module.exports = wrappy +function wrappy (fn, cb) { + if (fn && cb) return wrappy(fn)(cb) + + if (typeof fn !== 'function') + throw new TypeError('need wrapper function') + + Object.keys(fn).forEach(function (k) { + wrapper[k] = fn[k] + }) + + return wrapper + + function wrapper() { + var args = new Array(arguments.length) + for (var i = 0; i < args.length; i++) { + args[i] = arguments[i] + } + var ret = fn.apply(this, args) + var cb = args[args.length-1] + if (typeof ret === 'function' && ret !== cb) { + Object.keys(cb).forEach(function (k) { + ret[k] = cb[k] + }) + } + return ret + } +} + +},{}]},{},[7])(7) +}); \ No newline at end of file diff --git a/3.25.0/assets/javascripts/workers/search.361d90f1.min.js b/3.25.0/assets/javascripts/workers/search.361d90f1.min.js new file mode 100644 index 0000000000..acf8ad1139 --- /dev/null +++ b/3.25.0/assets/javascripts/workers/search.361d90f1.min.js @@ -0,0 +1,48 @@ +(()=>{var de=Object.create;var B=Object.defineProperty;var ge=Object.getOwnPropertyDescriptor;var ye=Object.getOwnPropertyNames,Y=Object.getOwnPropertySymbols,me=Object.getPrototypeOf,G=Object.prototype.hasOwnProperty,ve=Object.prototype.propertyIsEnumerable;var J=(t,e,r)=>e in t?B(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,X=(t,e)=>{for(var r in e||(e={}))G.call(e,r)&&J(t,r,e[r]);if(Y)for(var r of Y(e))ve.call(e,r)&&J(t,r,e[r]);return t};var xe=t=>B(t,"__esModule",{value:!0});var Z=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var Se=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of ye(e))!G.call(t,i)&&(r||i!=="default")&&B(t,i,{get:()=>e[i],enumerable:!(n=ge(e,i))||n.enumerable});return t},U=(t,e)=>Se(xe(B(t!=null?de(me(t)):{},"default",!e&&t&&t.__esModule?{get:()=>t.default,enumerable:!0}:{value:t,enumerable:!0})),t);var z=(t,e,r)=>new Promise((n,i)=>{var s=u=>{try{a(r.next(u))}catch(c){i(c)}},o=u=>{try{a(r.throw(u))}catch(c){i(c)}},a=u=>u.done?n(u.value):Promise.resolve(u.value).then(s,o);a((r=r.apply(t,e)).next())});var te=Z((K,ee)=>{/** + * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9 + * Copyright (C) 2020 Oliver Nightingale + * @license MIT + */(function(){var t=function(e){var r=new t.Builder;return r.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),r.searchPipeline.add(t.stemmer),e.call(r,r),r.build()};t.version="2.3.9";/*! + * lunr.utils + * Copyright (C) 2020 Oliver Nightingale + */t.utils={},t.utils.warn=function(e){return function(r){e.console&&console.warn&&console.warn(r)}}(this),t.utils.asString=function(e){return e==null?"":e.toString()},t.utils.clone=function(e){if(e==null)return e;for(var r=Object.create(null),n=Object.keys(e),i=0;i0){var h=t.utils.clone(r)||{};h.position=[a,c],h.index=s.length,s.push(new t.Token(n.slice(a,o),h))}a=o+1}}return s},t.tokenizer.separator=/[\s\-]+/;/*! + * lunr.Pipeline + * Copyright (C) 2020 Oliver Nightingale + */t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions=Object.create(null),t.Pipeline.registerFunction=function(e,r){r in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+r),e.label=r,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var r=e.label&&e.label in this.registeredFunctions;r||t.utils.warn(`Function is not registered with pipeline. This may cause problems when serialising the index. +`,e)},t.Pipeline.load=function(e){var r=new t.Pipeline;return e.forEach(function(n){var i=t.Pipeline.registeredFunctions[n];if(i)r.add(i);else throw new Error("Cannot load unregistered function: "+n)}),r},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(r){t.Pipeline.warnIfFunctionNotRegistered(r),this._stack.push(r)},this)},t.Pipeline.prototype.after=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");n=n+1,this._stack.splice(n,0,r)},t.Pipeline.prototype.before=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");this._stack.splice(n,0,r)},t.Pipeline.prototype.remove=function(e){var r=this._stack.indexOf(e);r!=-1&&this._stack.splice(r,1)},t.Pipeline.prototype.run=function(e){for(var r=this._stack.length,n=0;n1&&(oe&&(n=s),o!=e);)i=n-r,s=r+Math.floor(i/2),o=this.elements[s*2];if(o==e||o>e)return s*2;if(ou?h+=2:a==u&&(r+=n[c+1]*i[h+1],c+=2,h+=2);return r},t.Vector.prototype.similarity=function(e){return this.dot(e)/this.magnitude()||0},t.Vector.prototype.toArray=function(){for(var e=new Array(this.elements.length/2),r=1,n=0;r0){var o=s.str.charAt(0),a;o in s.node.edges?a=s.node.edges[o]:(a=new t.TokenSet,s.node.edges[o]=a),s.str.length==1&&(a.final=!0),i.push({node:a,editsRemaining:s.editsRemaining,str:s.str.slice(1)})}if(s.editsRemaining!=0){if("*"in s.node.edges)var u=s.node.edges["*"];else{var u=new t.TokenSet;s.node.edges["*"]=u}if(s.str.length==0&&(u.final=!0),i.push({node:u,editsRemaining:s.editsRemaining-1,str:s.str}),s.str.length>1&&i.push({node:s.node,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)}),s.str.length==1&&(s.node.final=!0),s.str.length>=1){if("*"in s.node.edges)var c=s.node.edges["*"];else{var c=new t.TokenSet;s.node.edges["*"]=c}s.str.length==1&&(c.final=!0),i.push({node:c,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)})}if(s.str.length>1){var h=s.str.charAt(0),y=s.str.charAt(1),g;y in s.node.edges?g=s.node.edges[y]:(g=new t.TokenSet,s.node.edges[y]=g),s.str.length==1&&(g.final=!0),i.push({node:g,editsRemaining:s.editsRemaining-1,str:h+s.str.slice(2)})}}}return n},t.TokenSet.fromString=function(e){for(var r=new t.TokenSet,n=r,i=0,s=e.length;i=e;r--){var n=this.uncheckedNodes[r],i=n.child.toString();i in this.minimizedNodes?n.parent.edges[n.char]=this.minimizedNodes[i]:(n.child._str=i,this.minimizedNodes[i]=n.child),this.uncheckedNodes.pop()}};/*! + * lunr.Index + * Copyright (C) 2020 Oliver Nightingale + */t.Index=function(e){this.invertedIndex=e.invertedIndex,this.fieldVectors=e.fieldVectors,this.tokenSet=e.tokenSet,this.fields=e.fields,this.pipeline=e.pipeline},t.Index.prototype.search=function(e){return this.query(function(r){var n=new t.QueryParser(e,r);n.parse()})},t.Index.prototype.query=function(e){for(var r=new t.Query(this.fields),n=Object.create(null),i=Object.create(null),s=Object.create(null),o=Object.create(null),a=Object.create(null),u=0;u1?this._b=1:this._b=e},t.Builder.prototype.k1=function(e){this._k1=e},t.Builder.prototype.add=function(e,r){var n=e[this._ref],i=Object.keys(this._fields);this._documents[n]=r||{},this.documentCount+=1;for(var s=0;s=this.length)return t.QueryLexer.EOS;var e=this.str.charAt(this.pos);return this.pos+=1,e},t.QueryLexer.prototype.width=function(){return this.pos-this.start},t.QueryLexer.prototype.ignore=function(){this.start==this.pos&&(this.pos+=1),this.start=this.pos},t.QueryLexer.prototype.backup=function(){this.pos-=1},t.QueryLexer.prototype.acceptDigitRun=function(){var e,r;do e=this.next(),r=e.charCodeAt(0);while(r>47&&r<58);e!=t.QueryLexer.EOS&&this.backup()},t.QueryLexer.prototype.more=function(){return this.pos1&&(e.backup(),e.emit(t.QueryLexer.TERM)),e.ignore(),e.more())return t.QueryLexer.lexText},t.QueryLexer.lexEditDistance=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.EDIT_DISTANCE),t.QueryLexer.lexText},t.QueryLexer.lexBoost=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.BOOST),t.QueryLexer.lexText},t.QueryLexer.lexEOS=function(e){e.width()>0&&e.emit(t.QueryLexer.TERM)},t.QueryLexer.termSeparator=t.tokenizer.separator,t.QueryLexer.lexText=function(e){for(;;){var r=e.next();if(r==t.QueryLexer.EOS)return t.QueryLexer.lexEOS;if(r.charCodeAt(0)==92){e.escapeCharacter();continue}if(r==":")return t.QueryLexer.lexField;if(r=="~")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexEditDistance;if(r=="^")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexBoost;if(r=="+"&&e.width()===1||r=="-"&&e.width()===1)return e.emit(t.QueryLexer.PRESENCE),t.QueryLexer.lexText;if(r.match(t.QueryLexer.termSeparator))return t.QueryLexer.lexTerm}},t.QueryParser=function(e,r){this.lexer=new t.QueryLexer(e),this.query=r,this.currentClause={},this.lexemeIdx=0},t.QueryParser.prototype.parse=function(){this.lexer.run(),this.lexemes=this.lexer.lexemes;for(var e=t.QueryParser.parseClause;e;)e=e(this);return this.query},t.QueryParser.prototype.peekLexeme=function(){return this.lexemes[this.lexemeIdx]},t.QueryParser.prototype.consumeLexeme=function(){var e=this.peekLexeme();return this.lexemeIdx+=1,e},t.QueryParser.prototype.nextClause=function(){var e=this.currentClause;this.query.clause(e),this.currentClause={}},t.QueryParser.parseClause=function(e){var r=e.peekLexeme();if(r!=null)switch(r.type){case t.QueryLexer.PRESENCE:return t.QueryParser.parsePresence;case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expected either a field or a term, found "+r.type;throw r.str.length>=1&&(n+=" with value '"+r.str+"'"),new t.QueryParseError(n,r.start,r.end)}},t.QueryParser.parsePresence=function(e){var r=e.consumeLexeme();if(r!=null){switch(r.str){case"-":e.currentClause.presence=t.Query.presence.PROHIBITED;break;case"+":e.currentClause.presence=t.Query.presence.REQUIRED;break;default:var n="unrecognised presence operator'"+r.str+"'";throw new t.QueryParseError(n,r.start,r.end)}var i=e.peekLexeme();if(i==null){var n="expecting term or field, found nothing";throw new t.QueryParseError(n,r.start,r.end)}switch(i.type){case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expecting term or field, found '"+i.type+"'";throw new t.QueryParseError(n,i.start,i.end)}}},t.QueryParser.parseField=function(e){var r=e.consumeLexeme();if(r!=null){if(e.query.allFields.indexOf(r.str)==-1){var n=e.query.allFields.map(function(o){return"'"+o+"'"}).join(", "),i="unrecognised field '"+r.str+"', possible fields: "+n;throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.fields=[r.str];var s=e.peekLexeme();if(s==null){var i="expecting term, found nothing";throw new t.QueryParseError(i,r.start,r.end)}switch(s.type){case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var i="expecting term, found '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseTerm=function(e){var r=e.consumeLexeme();if(r!=null){e.currentClause.term=r.str.toLowerCase(),r.str.indexOf("*")!=-1&&(e.currentClause.usePipeline=!1);var n=e.peekLexeme();if(n==null){e.nextClause();return}switch(n.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+n.type+"'";throw new t.QueryParseError(i,n.start,n.end)}}},t.QueryParser.parseEditDistance=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="edit distance must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.editDistance=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseBoost=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="boost must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.boost=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},function(e,r){typeof define=="function"&&define.amd?define(r):typeof K=="object"?ee.exports=r():e.lunr=r()}(this,function(){return t})})()});var W=Z((Te,re)=>{"use strict";/*! + * escape-html + * Copyright(c) 2012-2013 TJ Holowaychuk + * Copyright(c) 2015 Andreas Lubbe + * Copyright(c) 2015 Tiancheng "Timothy" Gu + * MIT Licensed + */var Qe=/["'&<>]/;re.exports=be;function be(t){var e=""+t,r=Qe.exec(e);if(!r)return e;var n,i="",s=0,o=0;for(s=r.index;s`${s}${o}`;return i=>{i=i.replace(/[\s*+\-:~^]+/g," ").trim();let s=new RegExp(`(^|${t.separator})(${i.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return o=>(e?(0,se.default)(o):o).replace(s,n).replace(/<\/mark>(\s+)]*>/img,"$1")}}function ae(t){let e=new lunr.Query(["title","text"]);return new lunr.QueryParser(t,e).parse(),e.clauses}function ue(t,e){var i;let r=new Set(t),n={};for(let s=0;s!n.has(i)))]}var H=class{constructor({config:e,docs:r,options:n}){this.options=n,this.documents=ie(r),this.highlight=oe(e,!1),lunr.tokenizer.separator=new RegExp(e.separator),this.index=lunr(function(){e.lang.length===1&&e.lang[0]!=="en"?this.use(lunr[e.lang[0]]):e.lang.length>1&&this.use(lunr.multiLanguage(...e.lang));let i=we(["trimmer","stopWordFilter","stemmer"],n.pipeline);for(let s of e.lang.map(o=>o==="en"?lunr:lunr[o]))for(let o of i)this.pipeline.remove(s[o]),this.searchPipeline.remove(s[o]);this.ref("location"),this.field("title",{boost:1e3}),this.field("text");for(let s of r)this.add(s)})}search(e){if(e)try{let r=this.highlight(e),n=ae(e).filter(o=>o.presence!==lunr.Query.presence.PROHIBITED),i=this.index.search(`${e}*`).reduce((o,{ref:a,score:u,matchData:c})=>{let h=this.documents.get(a);if(typeof h!="undefined"){let{location:y,title:g,text:b,parent:v}=h,Q=ue(n,Object.keys(c.metadata)),p=+!v+ +Object.values(Q).every(d=>d);o.push({location:y,title:r(g),text:r(b),score:u*(1+p),terms:Q})}return o},[]).sort((o,a)=>a.score-o.score).reduce((o,a)=>{let u=this.documents.get(a.location);if(typeof u!="undefined"){let c="parent"in u?u.parent.location:u.location;o.set(c,[...o.get(c)||[],a])}return o},new Map),s;if(this.options.suggestions){let o=this.index.query(a=>{for(let u of n)a.term(u.term,{fields:["title"],presence:lunr.Query.presence.REQUIRED,wildcard:lunr.Query.wildcard.TRAILING})});s=o.length?Object.keys(o[0].matchData.metadata):[]}return X({items:[...i.values()]},typeof s!="undefined"&&{suggestions:s})}catch(r){console.warn(`Invalid query: ${e} \u2013 see https://bit.ly/2s3ChXG`)}return{items:[]}}};var q;function Le(t){return z(this,null,function*(){let e="../lunr";if(typeof parent!="undefined"&&"IFrameWorker"in parent){let n=document.querySelector("script[src]"),[i]=n.src.split("/worker");e=e.replace("..",i)}let r=[];for(let n of t.lang){switch(n){case"ja":r.push(`${e}/tinyseg.js`);break;case"hi":case"th":r.push(`${e}/wordcut.js`);break}n!=="en"&&r.push(`${e}/min/lunr.${n}.min.js`)}t.lang.length>1&&r.push(`${e}/min/lunr.multi.min.js`),r.length&&(yield importScripts(`${e}/min/lunr.stemmer.support.min.js`,...r))})}function Ee(t){return z(this,null,function*(){switch(t.type){case 0:return yield Le(t.data.config),q=new H(t.data),{type:1};case 2:return{type:3,data:q?q.search(t.data):{items:[]}};default:throw new TypeError("Invalid message type")}})}self.lunr=ce.default;addEventListener("message",t=>z(void 0,null,function*(){postMessage(yield Ee(t.data))}));})(); +//# sourceMappingURL=search.361d90f1.min.js.map + diff --git a/3.25.0/assets/javascripts/workers/search.361d90f1.min.js.map b/3.25.0/assets/javascripts/workers/search.361d90f1.min.js.map new file mode 100644 index 0000000000..165aa7e4c8 --- /dev/null +++ b/3.25.0/assets/javascripts/workers/search.361d90f1.min.js.map @@ -0,0 +1,8 @@ +{ + "version": 3, + "sources": ["node_modules/lunr/lunr.js", "node_modules/escape-html/index.js", "src/assets/javascripts/integrations/search/worker/main/index.ts", "src/assets/javascripts/integrations/search/document/index.ts", "src/assets/javascripts/integrations/search/highlighter/index.ts", "src/assets/javascripts/integrations/search/query/_/index.ts", "src/assets/javascripts/integrations/search/_/index.ts"], + "sourceRoot": "../../../..", + "sourcesContent": ["/**\n * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9\n * Copyright (C) 2020 Oliver Nightingale\n * @license MIT\n */\n\n;(function(){\n\n/**\n * A convenience function for configuring and constructing\n * a new lunr Index.\n *\n * A lunr.Builder instance is created and the pipeline setup\n * with a trimmer, stop word filter and stemmer.\n *\n * This builder object is yielded to the configuration function\n * that is passed as a parameter, allowing the list of fields\n * and other builder parameters to be customised.\n *\n * All documents _must_ be added within the passed config function.\n *\n * @example\n * var idx = lunr(function () {\n * this.field('title')\n * this.field('body')\n * this.ref('id')\n *\n * documents.forEach(function (doc) {\n * this.add(doc)\n * }, this)\n * })\n *\n * @see {@link lunr.Builder}\n * @see {@link lunr.Pipeline}\n * @see {@link lunr.trimmer}\n * @see {@link lunr.stopWordFilter}\n * @see {@link lunr.stemmer}\n * @namespace {function} lunr\n */\nvar lunr = function (config) {\n var builder = new lunr.Builder\n\n builder.pipeline.add(\n lunr.trimmer,\n lunr.stopWordFilter,\n lunr.stemmer\n )\n\n builder.searchPipeline.add(\n lunr.stemmer\n )\n\n config.call(builder, builder)\n return builder.build()\n}\n\nlunr.version = \"2.3.9\"\n/*!\n * lunr.utils\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A namespace containing utils for the rest of the lunr library\n * @namespace lunr.utils\n */\nlunr.utils = {}\n\n/**\n * Print a warning message to the console.\n *\n * @param {String} message The message to be printed.\n * @memberOf lunr.utils\n * @function\n */\nlunr.utils.warn = (function (global) {\n /* eslint-disable no-console */\n return function (message) {\n if (global.console && console.warn) {\n console.warn(message)\n }\n }\n /* eslint-enable no-console */\n})(this)\n\n/**\n * Convert an object to a string.\n *\n * In the case of `null` and `undefined` the function returns\n * the empty string, in all other cases the result of calling\n * `toString` on the passed object is returned.\n *\n * @param {Any} obj The object to convert to a string.\n * @return {String} string representation of the passed object.\n * @memberOf lunr.utils\n */\nlunr.utils.asString = function (obj) {\n if (obj === void 0 || obj === null) {\n return \"\"\n } else {\n return obj.toString()\n }\n}\n\n/**\n * Clones an object.\n *\n * Will create a copy of an existing object such that any mutations\n * on the copy cannot affect the original.\n *\n * Only shallow objects are supported, passing a nested object to this\n * function will cause a TypeError.\n *\n * Objects with primitives, and arrays of primitives are supported.\n *\n * @param {Object} obj The object to clone.\n * @return {Object} a clone of the passed object.\n * @throws {TypeError} when a nested object is passed.\n * @memberOf Utils\n */\nlunr.utils.clone = function (obj) {\n if (obj === null || obj === undefined) {\n return obj\n }\n\n var clone = Object.create(null),\n keys = Object.keys(obj)\n\n for (var i = 0; i < keys.length; i++) {\n var key = keys[i],\n val = obj[key]\n\n if (Array.isArray(val)) {\n clone[key] = val.slice()\n continue\n }\n\n if (typeof val === 'string' ||\n typeof val === 'number' ||\n typeof val === 'boolean') {\n clone[key] = val\n continue\n }\n\n throw new TypeError(\"clone is not deep and does not support nested objects\")\n }\n\n return clone\n}\nlunr.FieldRef = function (docRef, fieldName, stringValue) {\n this.docRef = docRef\n this.fieldName = fieldName\n this._stringValue = stringValue\n}\n\nlunr.FieldRef.joiner = \"/\"\n\nlunr.FieldRef.fromString = function (s) {\n var n = s.indexOf(lunr.FieldRef.joiner)\n\n if (n === -1) {\n throw \"malformed field ref string\"\n }\n\n var fieldRef = s.slice(0, n),\n docRef = s.slice(n + 1)\n\n return new lunr.FieldRef (docRef, fieldRef, s)\n}\n\nlunr.FieldRef.prototype.toString = function () {\n if (this._stringValue == undefined) {\n this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef\n }\n\n return this._stringValue\n}\n/*!\n * lunr.Set\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A lunr set.\n *\n * @constructor\n */\nlunr.Set = function (elements) {\n this.elements = Object.create(null)\n\n if (elements) {\n this.length = elements.length\n\n for (var i = 0; i < this.length; i++) {\n this.elements[elements[i]] = true\n }\n } else {\n this.length = 0\n }\n}\n\n/**\n * A complete set that contains all elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.complete = {\n intersect: function (other) {\n return other\n },\n\n union: function () {\n return this\n },\n\n contains: function () {\n return true\n }\n}\n\n/**\n * An empty set that contains no elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.empty = {\n intersect: function () {\n return this\n },\n\n union: function (other) {\n return other\n },\n\n contains: function () {\n return false\n }\n}\n\n/**\n * Returns true if this set contains the specified object.\n *\n * @param {object} object - Object whose presence in this set is to be tested.\n * @returns {boolean} - True if this set contains the specified object.\n */\nlunr.Set.prototype.contains = function (object) {\n return !!this.elements[object]\n}\n\n/**\n * Returns a new set containing only the elements that are present in both\n * this set and the specified set.\n *\n * @param {lunr.Set} other - set to intersect with this set.\n * @returns {lunr.Set} a new set that is the intersection of this and the specified set.\n */\n\nlunr.Set.prototype.intersect = function (other) {\n var a, b, elements, intersection = []\n\n if (other === lunr.Set.complete) {\n return this\n }\n\n if (other === lunr.Set.empty) {\n return other\n }\n\n if (this.length < other.length) {\n a = this\n b = other\n } else {\n a = other\n b = this\n }\n\n elements = Object.keys(a.elements)\n\n for (var i = 0; i < elements.length; i++) {\n var element = elements[i]\n if (element in b.elements) {\n intersection.push(element)\n }\n }\n\n return new lunr.Set (intersection)\n}\n\n/**\n * Returns a new set combining the elements of this and the specified set.\n *\n * @param {lunr.Set} other - set to union with this set.\n * @return {lunr.Set} a new set that is the union of this and the specified set.\n */\n\nlunr.Set.prototype.union = function (other) {\n if (other === lunr.Set.complete) {\n return lunr.Set.complete\n }\n\n if (other === lunr.Set.empty) {\n return this\n }\n\n return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))\n}\n/**\n * A function to calculate the inverse document frequency for\n * a posting. This is shared between the builder and the index\n *\n * @private\n * @param {object} posting - The posting for a given term\n * @param {number} documentCount - The total number of documents.\n */\nlunr.idf = function (posting, documentCount) {\n var documentsWithTerm = 0\n\n for (var fieldName in posting) {\n if (fieldName == '_index') continue // Ignore the term index, its not a field\n documentsWithTerm += Object.keys(posting[fieldName]).length\n }\n\n var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)\n\n return Math.log(1 + Math.abs(x))\n}\n\n/**\n * A token wraps a string representation of a token\n * as it is passed through the text processing pipeline.\n *\n * @constructor\n * @param {string} [str=''] - The string token being wrapped.\n * @param {object} [metadata={}] - Metadata associated with this token.\n */\nlunr.Token = function (str, metadata) {\n this.str = str || \"\"\n this.metadata = metadata || {}\n}\n\n/**\n * Returns the token string that is being wrapped by this object.\n *\n * @returns {string}\n */\nlunr.Token.prototype.toString = function () {\n return this.str\n}\n\n/**\n * A token update function is used when updating or optionally\n * when cloning a token.\n *\n * @callback lunr.Token~updateFunction\n * @param {string} str - The string representation of the token.\n * @param {Object} metadata - All metadata associated with this token.\n */\n\n/**\n * Applies the given function to the wrapped string token.\n *\n * @example\n * token.update(function (str, metadata) {\n * return str.toUpperCase()\n * })\n *\n * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.update = function (fn) {\n this.str = fn(this.str, this.metadata)\n return this\n}\n\n/**\n * Creates a clone of this token. Optionally a function can be\n * applied to the cloned token.\n *\n * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.clone = function (fn) {\n fn = fn || function (s) { return s }\n return new lunr.Token (fn(this.str, this.metadata), this.metadata)\n}\n/*!\n * lunr.tokenizer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A function for splitting a string into tokens ready to be inserted into\n * the search index. Uses `lunr.tokenizer.separator` to split strings, change\n * the value of this property to change how strings are split into tokens.\n *\n * This tokenizer will convert its parameter to a string by calling `toString` and\n * then will split this string on the character in `lunr.tokenizer.separator`.\n * Arrays will have their elements converted to strings and wrapped in a lunr.Token.\n *\n * Optional metadata can be passed to the tokenizer, this metadata will be cloned and\n * added as metadata to every token that is created from the object to be tokenized.\n *\n * @static\n * @param {?(string|object|object[])} obj - The object to convert into tokens\n * @param {?object} metadata - Optional metadata to associate with every token\n * @returns {lunr.Token[]}\n * @see {@link lunr.Pipeline}\n */\nlunr.tokenizer = function (obj, metadata) {\n if (obj == null || obj == undefined) {\n return []\n }\n\n if (Array.isArray(obj)) {\n return obj.map(function (t) {\n return new lunr.Token(\n lunr.utils.asString(t).toLowerCase(),\n lunr.utils.clone(metadata)\n )\n })\n }\n\n var str = obj.toString().toLowerCase(),\n len = str.length,\n tokens = []\n\n for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {\n var char = str.charAt(sliceEnd),\n sliceLength = sliceEnd - sliceStart\n\n if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {\n\n if (sliceLength > 0) {\n var tokenMetadata = lunr.utils.clone(metadata) || {}\n tokenMetadata[\"position\"] = [sliceStart, sliceLength]\n tokenMetadata[\"index\"] = tokens.length\n\n tokens.push(\n new lunr.Token (\n str.slice(sliceStart, sliceEnd),\n tokenMetadata\n )\n )\n }\n\n sliceStart = sliceEnd + 1\n }\n\n }\n\n return tokens\n}\n\n/**\n * The separator used to split a string into tokens. Override this property to change the behaviour of\n * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.\n *\n * @static\n * @see lunr.tokenizer\n */\nlunr.tokenizer.separator = /[\\s\\-]+/\n/*!\n * lunr.Pipeline\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Pipelines maintain an ordered list of functions to be applied to all\n * tokens in documents entering the search index and queries being ran against\n * the index.\n *\n * An instance of lunr.Index created with the lunr shortcut will contain a\n * pipeline with a stop word filter and an English language stemmer. Extra\n * functions can be added before or after either of these functions or these\n * default functions can be removed.\n *\n * When run the pipeline will call each function in turn, passing a token, the\n * index of that token in the original list of all tokens and finally a list of\n * all the original tokens.\n *\n * The output of functions in the pipeline will be passed to the next function\n * in the pipeline. To exclude a token from entering the index the function\n * should return undefined, the rest of the pipeline will not be called with\n * this token.\n *\n * For serialisation of pipelines to work, all functions used in an instance of\n * a pipeline should be registered with lunr.Pipeline. Registered functions can\n * then be loaded. If trying to load a serialised pipeline that uses functions\n * that are not registered an error will be thrown.\n *\n * If not planning on serialising the pipeline then registering pipeline functions\n * is not necessary.\n *\n * @constructor\n */\nlunr.Pipeline = function () {\n this._stack = []\n}\n\nlunr.Pipeline.registeredFunctions = Object.create(null)\n\n/**\n * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token\n * string as well as all known metadata. A pipeline function can mutate the token string\n * or mutate (or add) metadata for a given token.\n *\n * A pipeline function can indicate that the passed token should be discarded by returning\n * null, undefined or an empty string. This token will not be passed to any downstream pipeline\n * functions and will not be added to the index.\n *\n * Multiple tokens can be returned by returning an array of tokens. Each token will be passed\n * to any downstream pipeline functions and all will returned tokens will be added to the index.\n *\n * Any number of pipeline functions may be chained together using a lunr.Pipeline.\n *\n * @interface lunr.PipelineFunction\n * @param {lunr.Token} token - A token from the document being processed.\n * @param {number} i - The index of this token in the complete list of tokens for this document/field.\n * @param {lunr.Token[]} tokens - All tokens for this document/field.\n * @returns {(?lunr.Token|lunr.Token[])}\n */\n\n/**\n * Register a function with the pipeline.\n *\n * Functions that are used in the pipeline should be registered if the pipeline\n * needs to be serialised, or a serialised pipeline needs to be loaded.\n *\n * Registering a function does not add it to a pipeline, functions must still be\n * added to instances of the pipeline for them to be used when running a pipeline.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @param {String} label - The label to register this function with\n */\nlunr.Pipeline.registerFunction = function (fn, label) {\n if (label in this.registeredFunctions) {\n lunr.utils.warn('Overwriting existing registered function: ' + label)\n }\n\n fn.label = label\n lunr.Pipeline.registeredFunctions[fn.label] = fn\n}\n\n/**\n * Warns if the function is not registered as a Pipeline function.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @private\n */\nlunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {\n var isRegistered = fn.label && (fn.label in this.registeredFunctions)\n\n if (!isRegistered) {\n lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\\n', fn)\n }\n}\n\n/**\n * Loads a previously serialised pipeline.\n *\n * All functions to be loaded must already be registered with lunr.Pipeline.\n * If any function from the serialised data has not been registered then an\n * error will be thrown.\n *\n * @param {Object} serialised - The serialised pipeline to load.\n * @returns {lunr.Pipeline}\n */\nlunr.Pipeline.load = function (serialised) {\n var pipeline = new lunr.Pipeline\n\n serialised.forEach(function (fnName) {\n var fn = lunr.Pipeline.registeredFunctions[fnName]\n\n if (fn) {\n pipeline.add(fn)\n } else {\n throw new Error('Cannot load unregistered function: ' + fnName)\n }\n })\n\n return pipeline\n}\n\n/**\n * Adds new functions to the end of the pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.\n */\nlunr.Pipeline.prototype.add = function () {\n var fns = Array.prototype.slice.call(arguments)\n\n fns.forEach(function (fn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n this._stack.push(fn)\n }, this)\n}\n\n/**\n * Adds a single function after a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.after = function (existingFn, newFn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n var pos = this._stack.indexOf(existingFn)\n if (pos == -1) {\n throw new Error('Cannot find existingFn')\n }\n\n pos = pos + 1\n this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Adds a single function before a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.before = function (existingFn, newFn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n var pos = this._stack.indexOf(existingFn)\n if (pos == -1) {\n throw new Error('Cannot find existingFn')\n }\n\n this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Removes a function from the pipeline.\n *\n * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.\n */\nlunr.Pipeline.prototype.remove = function (fn) {\n var pos = this._stack.indexOf(fn)\n if (pos == -1) {\n return\n }\n\n this._stack.splice(pos, 1)\n}\n\n/**\n * Runs the current list of functions that make up the pipeline against the\n * passed tokens.\n *\n * @param {Array} tokens The tokens to run through the pipeline.\n * @returns {Array}\n */\nlunr.Pipeline.prototype.run = function (tokens) {\n var stackLength = this._stack.length\n\n for (var i = 0; i < stackLength; i++) {\n var fn = this._stack[i]\n var memo = []\n\n for (var j = 0; j < tokens.length; j++) {\n var result = fn(tokens[j], j, tokens)\n\n if (result === null || result === void 0 || result === '') continue\n\n if (Array.isArray(result)) {\n for (var k = 0; k < result.length; k++) {\n memo.push(result[k])\n }\n } else {\n memo.push(result)\n }\n }\n\n tokens = memo\n }\n\n return tokens\n}\n\n/**\n * Convenience method for passing a string through a pipeline and getting\n * strings out. This method takes care of wrapping the passed string in a\n * token and mapping the resulting tokens back to strings.\n *\n * @param {string} str - The string to pass through the pipeline.\n * @param {?object} metadata - Optional metadata to associate with the token\n * passed to the pipeline.\n * @returns {string[]}\n */\nlunr.Pipeline.prototype.runString = function (str, metadata) {\n var token = new lunr.Token (str, metadata)\n\n return this.run([token]).map(function (t) {\n return t.toString()\n })\n}\n\n/**\n * Resets the pipeline by removing any existing processors.\n *\n */\nlunr.Pipeline.prototype.reset = function () {\n this._stack = []\n}\n\n/**\n * Returns a representation of the pipeline ready for serialisation.\n *\n * Logs a warning if the function has not been registered.\n *\n * @returns {Array}\n */\nlunr.Pipeline.prototype.toJSON = function () {\n return this._stack.map(function (fn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n\n return fn.label\n })\n}\n/*!\n * lunr.Vector\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A vector is used to construct the vector space of documents and queries. These\n * vectors support operations to determine the similarity between two documents or\n * a document and a query.\n *\n * Normally no parameters are required for initializing a vector, but in the case of\n * loading a previously dumped vector the raw elements can be provided to the constructor.\n *\n * For performance reasons vectors are implemented with a flat array, where an elements\n * index is immediately followed by its value. E.g. [index, value, index, value]. This\n * allows the underlying array to be as sparse as possible and still offer decent\n * performance when being used for vector calculations.\n *\n * @constructor\n * @param {Number[]} [elements] - The flat list of element index and element value pairs.\n */\nlunr.Vector = function (elements) {\n this._magnitude = 0\n this.elements = elements || []\n}\n\n\n/**\n * Calculates the position within the vector to insert a given index.\n *\n * This is used internally by insert and upsert. If there are duplicate indexes then\n * the position is returned as if the value for that index were to be updated, but it\n * is the callers responsibility to check whether there is a duplicate at that index\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @returns {Number}\n */\nlunr.Vector.prototype.positionForIndex = function (index) {\n // For an empty vector the tuple can be inserted at the beginning\n if (this.elements.length == 0) {\n return 0\n }\n\n var start = 0,\n end = this.elements.length / 2,\n sliceLength = end - start,\n pivotPoint = Math.floor(sliceLength / 2),\n pivotIndex = this.elements[pivotPoint * 2]\n\n while (sliceLength > 1) {\n if (pivotIndex < index) {\n start = pivotPoint\n }\n\n if (pivotIndex > index) {\n end = pivotPoint\n }\n\n if (pivotIndex == index) {\n break\n }\n\n sliceLength = end - start\n pivotPoint = start + Math.floor(sliceLength / 2)\n pivotIndex = this.elements[pivotPoint * 2]\n }\n\n if (pivotIndex == index) {\n return pivotPoint * 2\n }\n\n if (pivotIndex > index) {\n return pivotPoint * 2\n }\n\n if (pivotIndex < index) {\n return (pivotPoint + 1) * 2\n }\n}\n\n/**\n * Inserts an element at an index within the vector.\n *\n * Does not allow duplicates, will throw an error if there is already an entry\n * for this index.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n */\nlunr.Vector.prototype.insert = function (insertIdx, val) {\n this.upsert(insertIdx, val, function () {\n throw \"duplicate index\"\n })\n}\n\n/**\n * Inserts or updates an existing index within the vector.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n * @param {function} fn - A function that is called for updates, the existing value and the\n * requested value are passed as arguments\n */\nlunr.Vector.prototype.upsert = function (insertIdx, val, fn) {\n this._magnitude = 0\n var position = this.positionForIndex(insertIdx)\n\n if (this.elements[position] == insertIdx) {\n this.elements[position + 1] = fn(this.elements[position + 1], val)\n } else {\n this.elements.splice(position, 0, insertIdx, val)\n }\n}\n\n/**\n * Calculates the magnitude of this vector.\n *\n * @returns {Number}\n */\nlunr.Vector.prototype.magnitude = function () {\n if (this._magnitude) return this._magnitude\n\n var sumOfSquares = 0,\n elementsLength = this.elements.length\n\n for (var i = 1; i < elementsLength; i += 2) {\n var val = this.elements[i]\n sumOfSquares += val * val\n }\n\n return this._magnitude = Math.sqrt(sumOfSquares)\n}\n\n/**\n * Calculates the dot product of this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The vector to compute the dot product with.\n * @returns {Number}\n */\nlunr.Vector.prototype.dot = function (otherVector) {\n var dotProduct = 0,\n a = this.elements, b = otherVector.elements,\n aLen = a.length, bLen = b.length,\n aVal = 0, bVal = 0,\n i = 0, j = 0\n\n while (i < aLen && j < bLen) {\n aVal = a[i], bVal = b[j]\n if (aVal < bVal) {\n i += 2\n } else if (aVal > bVal) {\n j += 2\n } else if (aVal == bVal) {\n dotProduct += a[i + 1] * b[j + 1]\n i += 2\n j += 2\n }\n }\n\n return dotProduct\n}\n\n/**\n * Calculates the similarity between this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The other vector to calculate the\n * similarity with.\n * @returns {Number}\n */\nlunr.Vector.prototype.similarity = function (otherVector) {\n return this.dot(otherVector) / this.magnitude() || 0\n}\n\n/**\n * Converts the vector to an array of the elements within the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toArray = function () {\n var output = new Array (this.elements.length / 2)\n\n for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {\n output[j] = this.elements[i]\n }\n\n return output\n}\n\n/**\n * A JSON serializable representation of the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toJSON = function () {\n return this.elements\n}\n/* eslint-disable */\n/*!\n * lunr.stemmer\n * Copyright (C) 2020 Oliver Nightingale\n * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt\n */\n\n/**\n * lunr.stemmer is an english language stemmer, this is a JavaScript\n * implementation of the PorterStemmer taken from http://tartarus.org/~martin\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token - The string to stem\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n * @function\n */\nlunr.stemmer = (function(){\n var step2list = {\n \"ational\" : \"ate\",\n \"tional\" : \"tion\",\n \"enci\" : \"ence\",\n \"anci\" : \"ance\",\n \"izer\" : \"ize\",\n \"bli\" : \"ble\",\n \"alli\" : \"al\",\n \"entli\" : \"ent\",\n \"eli\" : \"e\",\n \"ousli\" : \"ous\",\n \"ization\" : \"ize\",\n \"ation\" : \"ate\",\n \"ator\" : \"ate\",\n \"alism\" : \"al\",\n \"iveness\" : \"ive\",\n \"fulness\" : \"ful\",\n \"ousness\" : \"ous\",\n \"aliti\" : \"al\",\n \"iviti\" : \"ive\",\n \"biliti\" : \"ble\",\n \"logi\" : \"log\"\n },\n\n step3list = {\n \"icate\" : \"ic\",\n \"ative\" : \"\",\n \"alize\" : \"al\",\n \"iciti\" : \"ic\",\n \"ical\" : \"ic\",\n \"ful\" : \"\",\n \"ness\" : \"\"\n },\n\n c = \"[^aeiou]\", // consonant\n v = \"[aeiouy]\", // vowel\n C = c + \"[^aeiouy]*\", // consonant sequence\n V = v + \"[aeiou]*\", // vowel sequence\n\n mgr0 = \"^(\" + C + \")?\" + V + C, // [C]VC... is m>0\n meq1 = \"^(\" + C + \")?\" + V + C + \"(\" + V + \")?$\", // [C]VC[V] is m=1\n mgr1 = \"^(\" + C + \")?\" + V + C + V + C, // [C]VCVC... is m>1\n s_v = \"^(\" + C + \")?\" + v; // vowel in stem\n\n var re_mgr0 = new RegExp(mgr0);\n var re_mgr1 = new RegExp(mgr1);\n var re_meq1 = new RegExp(meq1);\n var re_s_v = new RegExp(s_v);\n\n var re_1a = /^(.+?)(ss|i)es$/;\n var re2_1a = /^(.+?)([^s])s$/;\n var re_1b = /^(.+?)eed$/;\n var re2_1b = /^(.+?)(ed|ing)$/;\n var re_1b_2 = /.$/;\n var re2_1b_2 = /(at|bl|iz)$/;\n var re3_1b_2 = new RegExp(\"([^aeiouylsz])\\\\1$\");\n var re4_1b_2 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n var re_1c = /^(.+?[^aeiou])y$/;\n var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;\n\n var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;\n\n var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;\n var re2_4 = /^(.+?)(s|t)(ion)$/;\n\n var re_5 = /^(.+?)e$/;\n var re_5_1 = /ll$/;\n var re3_5 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n var porterStemmer = function porterStemmer(w) {\n var stem,\n suffix,\n firstch,\n re,\n re2,\n re3,\n re4;\n\n if (w.length < 3) { return w; }\n\n firstch = w.substr(0,1);\n if (firstch == \"y\") {\n w = firstch.toUpperCase() + w.substr(1);\n }\n\n // Step 1a\n re = re_1a\n re2 = re2_1a;\n\n if (re.test(w)) { w = w.replace(re,\"$1$2\"); }\n else if (re2.test(w)) { w = w.replace(re2,\"$1$2\"); }\n\n // Step 1b\n re = re_1b;\n re2 = re2_1b;\n if (re.test(w)) {\n var fp = re.exec(w);\n re = re_mgr0;\n if (re.test(fp[1])) {\n re = re_1b_2;\n w = w.replace(re,\"\");\n }\n } else if (re2.test(w)) {\n var fp = re2.exec(w);\n stem = fp[1];\n re2 = re_s_v;\n if (re2.test(stem)) {\n w = stem;\n re2 = re2_1b_2;\n re3 = re3_1b_2;\n re4 = re4_1b_2;\n if (re2.test(w)) { w = w + \"e\"; }\n else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,\"\"); }\n else if (re4.test(w)) { w = w + \"e\"; }\n }\n }\n\n // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)\n re = re_1c;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n w = stem + \"i\";\n }\n\n // Step 2\n re = re_2;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n suffix = fp[2];\n re = re_mgr0;\n if (re.test(stem)) {\n w = stem + step2list[suffix];\n }\n }\n\n // Step 3\n re = re_3;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n suffix = fp[2];\n re = re_mgr0;\n if (re.test(stem)) {\n w = stem + step3list[suffix];\n }\n }\n\n // Step 4\n re = re_4;\n re2 = re2_4;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n re = re_mgr1;\n if (re.test(stem)) {\n w = stem;\n }\n } else if (re2.test(w)) {\n var fp = re2.exec(w);\n stem = fp[1] + fp[2];\n re2 = re_mgr1;\n if (re2.test(stem)) {\n w = stem;\n }\n }\n\n // Step 5\n re = re_5;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n re = re_mgr1;\n re2 = re_meq1;\n re3 = re3_5;\n if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {\n w = stem;\n }\n }\n\n re = re_5_1;\n re2 = re_mgr1;\n if (re.test(w) && re2.test(w)) {\n re = re_1b_2;\n w = w.replace(re,\"\");\n }\n\n // and turn initial Y back to y\n\n if (firstch == \"y\") {\n w = firstch.toLowerCase() + w.substr(1);\n }\n\n return w;\n };\n\n return function (token) {\n return token.update(porterStemmer);\n }\n})();\n\nlunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')\n/*!\n * lunr.stopWordFilter\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.generateStopWordFilter builds a stopWordFilter function from the provided\n * list of stop words.\n *\n * The built in lunr.stopWordFilter is built using this generator and can be used\n * to generate custom stopWordFilters for applications or non English languages.\n *\n * @function\n * @param {Array} token The token to pass through the filter\n * @returns {lunr.PipelineFunction}\n * @see lunr.Pipeline\n * @see lunr.stopWordFilter\n */\nlunr.generateStopWordFilter = function (stopWords) {\n var words = stopWords.reduce(function (memo, stopWord) {\n memo[stopWord] = stopWord\n return memo\n }, {})\n\n return function (token) {\n if (token && words[token.toString()] !== token.toString()) return token\n }\n}\n\n/**\n * lunr.stopWordFilter is an English language stop word list filter, any words\n * contained in the list will not be passed through the filter.\n *\n * This is intended to be used in the Pipeline. If the token does not pass the\n * filter then undefined will be returned.\n *\n * @function\n * @implements {lunr.PipelineFunction}\n * @params {lunr.Token} token - A token to check for being a stop word.\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n */\nlunr.stopWordFilter = lunr.generateStopWordFilter([\n 'a',\n 'able',\n 'about',\n 'across',\n 'after',\n 'all',\n 'almost',\n 'also',\n 'am',\n 'among',\n 'an',\n 'and',\n 'any',\n 'are',\n 'as',\n 'at',\n 'be',\n 'because',\n 'been',\n 'but',\n 'by',\n 'can',\n 'cannot',\n 'could',\n 'dear',\n 'did',\n 'do',\n 'does',\n 'either',\n 'else',\n 'ever',\n 'every',\n 'for',\n 'from',\n 'get',\n 'got',\n 'had',\n 'has',\n 'have',\n 'he',\n 'her',\n 'hers',\n 'him',\n 'his',\n 'how',\n 'however',\n 'i',\n 'if',\n 'in',\n 'into',\n 'is',\n 'it',\n 'its',\n 'just',\n 'least',\n 'let',\n 'like',\n 'likely',\n 'may',\n 'me',\n 'might',\n 'most',\n 'must',\n 'my',\n 'neither',\n 'no',\n 'nor',\n 'not',\n 'of',\n 'off',\n 'often',\n 'on',\n 'only',\n 'or',\n 'other',\n 'our',\n 'own',\n 'rather',\n 'said',\n 'say',\n 'says',\n 'she',\n 'should',\n 'since',\n 'so',\n 'some',\n 'than',\n 'that',\n 'the',\n 'their',\n 'them',\n 'then',\n 'there',\n 'these',\n 'they',\n 'this',\n 'tis',\n 'to',\n 'too',\n 'twas',\n 'us',\n 'wants',\n 'was',\n 'we',\n 'were',\n 'what',\n 'when',\n 'where',\n 'which',\n 'while',\n 'who',\n 'whom',\n 'why',\n 'will',\n 'with',\n 'would',\n 'yet',\n 'you',\n 'your'\n])\n\nlunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')\n/*!\n * lunr.trimmer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.trimmer is a pipeline function for trimming non word\n * characters from the beginning and end of tokens before they\n * enter the index.\n *\n * This implementation may not work correctly for non latin\n * characters and should either be removed or adapted for use\n * with languages with non-latin characters.\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token The token to pass through the filter\n * @returns {lunr.Token}\n * @see lunr.Pipeline\n */\nlunr.trimmer = function (token) {\n return token.update(function (s) {\n return s.replace(/^\\W+/, '').replace(/\\W+$/, '')\n })\n}\n\nlunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')\n/*!\n * lunr.TokenSet\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A token set is used to store the unique list of all tokens\n * within an index. Token sets are also used to represent an\n * incoming query to the index, this query token set and index\n * token set are then intersected to find which tokens to look\n * up in the inverted index.\n *\n * A token set can hold multiple tokens, as in the case of the\n * index token set, or it can hold a single token as in the\n * case of a simple query token set.\n *\n * Additionally token sets are used to perform wildcard matching.\n * Leading, contained and trailing wildcards are supported, and\n * from this edit distance matching can also be provided.\n *\n * Token sets are implemented as a minimal finite state automata,\n * where both common prefixes and suffixes are shared between tokens.\n * This helps to reduce the space used for storing the token set.\n *\n * @constructor\n */\nlunr.TokenSet = function () {\n this.final = false\n this.edges = {}\n this.id = lunr.TokenSet._nextId\n lunr.TokenSet._nextId += 1\n}\n\n/**\n * Keeps track of the next, auto increment, identifier to assign\n * to a new tokenSet.\n *\n * TokenSets require a unique identifier to be correctly minimised.\n *\n * @private\n */\nlunr.TokenSet._nextId = 1\n\n/**\n * Creates a TokenSet instance from the given sorted array of words.\n *\n * @param {String[]} arr - A sorted array of strings to create the set from.\n * @returns {lunr.TokenSet}\n * @throws Will throw an error if the input array is not sorted.\n */\nlunr.TokenSet.fromArray = function (arr) {\n var builder = new lunr.TokenSet.Builder\n\n for (var i = 0, len = arr.length; i < len; i++) {\n builder.insert(arr[i])\n }\n\n builder.finish()\n return builder.root\n}\n\n/**\n * Creates a token set from a query clause.\n *\n * @private\n * @param {Object} clause - A single clause from lunr.Query.\n * @param {string} clause.term - The query clause term.\n * @param {number} [clause.editDistance] - The optional edit distance for the term.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromClause = function (clause) {\n if ('editDistance' in clause) {\n return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)\n } else {\n return lunr.TokenSet.fromString(clause.term)\n }\n}\n\n/**\n * Creates a token set representing a single string with a specified\n * edit distance.\n *\n * Insertions, deletions, substitutions and transpositions are each\n * treated as an edit distance of 1.\n *\n * Increasing the allowed edit distance will have a dramatic impact\n * on the performance of both creating and intersecting these TokenSets.\n * It is advised to keep the edit distance less than 3.\n *\n * @param {string} str - The string to create the token set from.\n * @param {number} editDistance - The allowed edit distance to match.\n * @returns {lunr.Vector}\n */\nlunr.TokenSet.fromFuzzyString = function (str, editDistance) {\n var root = new lunr.TokenSet\n\n var stack = [{\n node: root,\n editsRemaining: editDistance,\n str: str\n }]\n\n while (stack.length) {\n var frame = stack.pop()\n\n // no edit\n if (frame.str.length > 0) {\n var char = frame.str.charAt(0),\n noEditNode\n\n if (char in frame.node.edges) {\n noEditNode = frame.node.edges[char]\n } else {\n noEditNode = new lunr.TokenSet\n frame.node.edges[char] = noEditNode\n }\n\n if (frame.str.length == 1) {\n noEditNode.final = true\n }\n\n stack.push({\n node: noEditNode,\n editsRemaining: frame.editsRemaining,\n str: frame.str.slice(1)\n })\n }\n\n if (frame.editsRemaining == 0) {\n continue\n }\n\n // insertion\n if (\"*\" in frame.node.edges) {\n var insertionNode = frame.node.edges[\"*\"]\n } else {\n var insertionNode = new lunr.TokenSet\n frame.node.edges[\"*\"] = insertionNode\n }\n\n if (frame.str.length == 0) {\n insertionNode.final = true\n }\n\n stack.push({\n node: insertionNode,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str\n })\n\n // deletion\n // can only do a deletion if we have enough edits remaining\n // and if there are characters left to delete in the string\n if (frame.str.length > 1) {\n stack.push({\n node: frame.node,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str.slice(1)\n })\n }\n\n // deletion\n // just removing the last character from the str\n if (frame.str.length == 1) {\n frame.node.final = true\n }\n\n // substitution\n // can only do a substitution if we have enough edits remaining\n // and if there are characters left to substitute\n if (frame.str.length >= 1) {\n if (\"*\" in frame.node.edges) {\n var substitutionNode = frame.node.edges[\"*\"]\n } else {\n var substitutionNode = new lunr.TokenSet\n frame.node.edges[\"*\"] = substitutionNode\n }\n\n if (frame.str.length == 1) {\n substitutionNode.final = true\n }\n\n stack.push({\n node: substitutionNode,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str.slice(1)\n })\n }\n\n // transposition\n // can only do a transposition if there are edits remaining\n // and there are enough characters to transpose\n if (frame.str.length > 1) {\n var charA = frame.str.charAt(0),\n charB = frame.str.charAt(1),\n transposeNode\n\n if (charB in frame.node.edges) {\n transposeNode = frame.node.edges[charB]\n } else {\n transposeNode = new lunr.TokenSet\n frame.node.edges[charB] = transposeNode\n }\n\n if (frame.str.length == 1) {\n transposeNode.final = true\n }\n\n stack.push({\n node: transposeNode,\n editsRemaining: frame.editsRemaining - 1,\n str: charA + frame.str.slice(2)\n })\n }\n }\n\n return root\n}\n\n/**\n * Creates a TokenSet from a string.\n *\n * The string may contain one or more wildcard characters (*)\n * that will allow wildcard matching when intersecting with\n * another TokenSet.\n *\n * @param {string} str - The string to create a TokenSet from.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromString = function (str) {\n var node = new lunr.TokenSet,\n root = node\n\n /*\n * Iterates through all characters within the passed string\n * appending a node for each character.\n *\n * When a wildcard character is found then a self\n * referencing edge is introduced to continually match\n * any number of any characters.\n */\n for (var i = 0, len = str.length; i < len; i++) {\n var char = str[i],\n final = (i == len - 1)\n\n if (char == \"*\") {\n node.edges[char] = node\n node.final = final\n\n } else {\n var next = new lunr.TokenSet\n next.final = final\n\n node.edges[char] = next\n node = next\n }\n }\n\n return root\n}\n\n/**\n * Converts this TokenSet into an array of strings\n * contained within the TokenSet.\n *\n * This is not intended to be used on a TokenSet that\n * contains wildcards, in these cases the results are\n * undefined and are likely to cause an infinite loop.\n *\n * @returns {string[]}\n */\nlunr.TokenSet.prototype.toArray = function () {\n var words = []\n\n var stack = [{\n prefix: \"\",\n node: this\n }]\n\n while (stack.length) {\n var frame = stack.pop(),\n edges = Object.keys(frame.node.edges),\n len = edges.length\n\n if (frame.node.final) {\n /* In Safari, at this point the prefix is sometimes corrupted, see:\n * https://github.com/olivernn/lunr.js/issues/279 Calling any\n * String.prototype method forces Safari to \"cast\" this string to what\n * it's supposed to be, fixing the bug. */\n frame.prefix.charAt(0)\n words.push(frame.prefix)\n }\n\n for (var i = 0; i < len; i++) {\n var edge = edges[i]\n\n stack.push({\n prefix: frame.prefix.concat(edge),\n node: frame.node.edges[edge]\n })\n }\n }\n\n return words\n}\n\n/**\n * Generates a string representation of a TokenSet.\n *\n * This is intended to allow TokenSets to be used as keys\n * in objects, largely to aid the construction and minimisation\n * of a TokenSet. As such it is not designed to be a human\n * friendly representation of the TokenSet.\n *\n * @returns {string}\n */\nlunr.TokenSet.prototype.toString = function () {\n // NOTE: Using Object.keys here as this.edges is very likely\n // to enter 'hash-mode' with many keys being added\n //\n // avoiding a for-in loop here as it leads to the function\n // being de-optimised (at least in V8). From some simple\n // benchmarks the performance is comparable, but allowing\n // V8 to optimize may mean easy performance wins in the future.\n\n if (this._str) {\n return this._str\n }\n\n var str = this.final ? '1' : '0',\n labels = Object.keys(this.edges).sort(),\n len = labels.length\n\n for (var i = 0; i < len; i++) {\n var label = labels[i],\n node = this.edges[label]\n\n str = str + label + node.id\n }\n\n return str\n}\n\n/**\n * Returns a new TokenSet that is the intersection of\n * this TokenSet and the passed TokenSet.\n *\n * This intersection will take into account any wildcards\n * contained within the TokenSet.\n *\n * @param {lunr.TokenSet} b - An other TokenSet to intersect with.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.prototype.intersect = function (b) {\n var output = new lunr.TokenSet,\n frame = undefined\n\n var stack = [{\n qNode: b,\n output: output,\n node: this\n }]\n\n while (stack.length) {\n frame = stack.pop()\n\n // NOTE: As with the #toString method, we are using\n // Object.keys and a for loop instead of a for-in loop\n // as both of these objects enter 'hash' mode, causing\n // the function to be de-optimised in V8\n var qEdges = Object.keys(frame.qNode.edges),\n qLen = qEdges.length,\n nEdges = Object.keys(frame.node.edges),\n nLen = nEdges.length\n\n for (var q = 0; q < qLen; q++) {\n var qEdge = qEdges[q]\n\n for (var n = 0; n < nLen; n++) {\n var nEdge = nEdges[n]\n\n if (nEdge == qEdge || qEdge == '*') {\n var node = frame.node.edges[nEdge],\n qNode = frame.qNode.edges[qEdge],\n final = node.final && qNode.final,\n next = undefined\n\n if (nEdge in frame.output.edges) {\n // an edge already exists for this character\n // no need to create a new node, just set the finality\n // bit unless this node is already final\n next = frame.output.edges[nEdge]\n next.final = next.final || final\n\n } else {\n // no edge exists yet, must create one\n // set the finality bit and insert it\n // into the output\n next = new lunr.TokenSet\n next.final = final\n frame.output.edges[nEdge] = next\n }\n\n stack.push({\n qNode: qNode,\n output: next,\n node: node\n })\n }\n }\n }\n }\n\n return output\n}\nlunr.TokenSet.Builder = function () {\n this.previousWord = \"\"\n this.root = new lunr.TokenSet\n this.uncheckedNodes = []\n this.minimizedNodes = {}\n}\n\nlunr.TokenSet.Builder.prototype.insert = function (word) {\n var node,\n commonPrefix = 0\n\n if (word < this.previousWord) {\n throw new Error (\"Out of order word insertion\")\n }\n\n for (var i = 0; i < word.length && i < this.previousWord.length; i++) {\n if (word[i] != this.previousWord[i]) break\n commonPrefix++\n }\n\n this.minimize(commonPrefix)\n\n if (this.uncheckedNodes.length == 0) {\n node = this.root\n } else {\n node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child\n }\n\n for (var i = commonPrefix; i < word.length; i++) {\n var nextNode = new lunr.TokenSet,\n char = word[i]\n\n node.edges[char] = nextNode\n\n this.uncheckedNodes.push({\n parent: node,\n char: char,\n child: nextNode\n })\n\n node = nextNode\n }\n\n node.final = true\n this.previousWord = word\n}\n\nlunr.TokenSet.Builder.prototype.finish = function () {\n this.minimize(0)\n}\n\nlunr.TokenSet.Builder.prototype.minimize = function (downTo) {\n for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {\n var node = this.uncheckedNodes[i],\n childKey = node.child.toString()\n\n if (childKey in this.minimizedNodes) {\n node.parent.edges[node.char] = this.minimizedNodes[childKey]\n } else {\n // Cache the key for this node since\n // we know it can't change anymore\n node.child._str = childKey\n\n this.minimizedNodes[childKey] = node.child\n }\n\n this.uncheckedNodes.pop()\n }\n}\n/*!\n * lunr.Index\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * An index contains the built index of all documents and provides a query interface\n * to the index.\n *\n * Usually instances of lunr.Index will not be created using this constructor, instead\n * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be\n * used to load previously built and serialized indexes.\n *\n * @constructor\n * @param {Object} attrs - The attributes of the built search index.\n * @param {Object} attrs.invertedIndex - An index of term/field to document reference.\n * @param {Object} attrs.fieldVectors - Field vectors\n * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens.\n * @param {string[]} attrs.fields - The names of indexed document fields.\n * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms.\n */\nlunr.Index = function (attrs) {\n this.invertedIndex = attrs.invertedIndex\n this.fieldVectors = attrs.fieldVectors\n this.tokenSet = attrs.tokenSet\n this.fields = attrs.fields\n this.pipeline = attrs.pipeline\n}\n\n/**\n * A result contains details of a document matching a search query.\n * @typedef {Object} lunr.Index~Result\n * @property {string} ref - The reference of the document this result represents.\n * @property {number} score - A number between 0 and 1 representing how similar this document is to the query.\n * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match.\n */\n\n/**\n * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple\n * query language which itself is parsed into an instance of lunr.Query.\n *\n * For programmatically building queries it is advised to directly use lunr.Query, the query language\n * is best used for human entered text rather than program generated text.\n *\n * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported\n * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello'\n * or 'world', though those that contain both will rank higher in the results.\n *\n * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can\n * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding\n * wildcards will increase the number of documents that will be found but can also have a negative\n * impact on query performance, especially with wildcards at the beginning of a term.\n *\n * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term\n * hello in the title field will match this query. Using a field not present in the index will lead\n * to an error being thrown.\n *\n * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term\n * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported\n * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2.\n * Avoid large values for edit distance to improve query performance.\n *\n * Each term also supports a presence modifier. By default a term's presence in document is optional, however\n * this can be changed to either required or prohibited. For a term's presence to be required in a document the\n * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and\n * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not\n * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'.\n *\n * To escape special characters the backslash character '\\' can be used, this allows searches to include\n * characters that would normally be considered modifiers, e.g. `foo\\~2` will search for a term \"foo~2\" instead\n * of attempting to apply a boost of 2 to the search term \"foo\".\n *\n * @typedef {string} lunr.Index~QueryString\n * @example Simple single term query\n * hello\n * @example Multiple term query\n * hello world\n * @example term scoped to a field\n * title:hello\n * @example term with a boost of 10\n * hello^10\n * @example term with an edit distance of 2\n * hello~2\n * @example terms with presence modifiers\n * -foo +bar baz\n */\n\n/**\n * Performs a search against the index using lunr query syntax.\n *\n * Results will be returned sorted by their score, the most relevant results\n * will be returned first. For details on how the score is calculated, please see\n * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}.\n *\n * For more programmatic querying use lunr.Index#query.\n *\n * @param {lunr.Index~QueryString} queryString - A string containing a lunr query.\n * @throws {lunr.QueryParseError} If the passed query string cannot be parsed.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.search = function (queryString) {\n return this.query(function (query) {\n var parser = new lunr.QueryParser(queryString, query)\n parser.parse()\n })\n}\n\n/**\n * A query builder callback provides a query object to be used to express\n * the query to perform on the index.\n *\n * @callback lunr.Index~queryBuilder\n * @param {lunr.Query} query - The query object to build up.\n * @this lunr.Query\n */\n\n/**\n * Performs a query against the index using the yielded lunr.Query object.\n *\n * If performing programmatic queries against the index, this method is preferred\n * over lunr.Index#search so as to avoid the additional query parsing overhead.\n *\n * A query object is yielded to the supplied function which should be used to\n * express the query to be run against the index.\n *\n * Note that although this function takes a callback parameter it is _not_ an\n * asynchronous operation, the callback is just yielded a query object to be\n * customized.\n *\n * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.query = function (fn) {\n // for each query clause\n // * process terms\n // * expand terms from token set\n // * find matching documents and metadata\n // * get document vectors\n // * score documents\n\n var query = new lunr.Query(this.fields),\n matchingFields = Object.create(null),\n queryVectors = Object.create(null),\n termFieldCache = Object.create(null),\n requiredMatches = Object.create(null),\n prohibitedMatches = Object.create(null)\n\n /*\n * To support field level boosts a query vector is created per\n * field. An empty vector is eagerly created to support negated\n * queries.\n */\n for (var i = 0; i < this.fields.length; i++) {\n queryVectors[this.fields[i]] = new lunr.Vector\n }\n\n fn.call(query, query)\n\n for (var i = 0; i < query.clauses.length; i++) {\n /*\n * Unless the pipeline has been disabled for this term, which is\n * the case for terms with wildcards, we need to pass the clause\n * term through the search pipeline. A pipeline returns an array\n * of processed terms. Pipeline functions may expand the passed\n * term, which means we may end up performing multiple index lookups\n * for a single query term.\n */\n var clause = query.clauses[i],\n terms = null,\n clauseMatches = lunr.Set.empty\n\n if (clause.usePipeline) {\n terms = this.pipeline.runString(clause.term, {\n fields: clause.fields\n })\n } else {\n terms = [clause.term]\n }\n\n for (var m = 0; m < terms.length; m++) {\n var term = terms[m]\n\n /*\n * Each term returned from the pipeline needs to use the same query\n * clause object, e.g. the same boost and or edit distance. The\n * simplest way to do this is to re-use the clause object but mutate\n * its term property.\n */\n clause.term = term\n\n /*\n * From the term in the clause we create a token set which will then\n * be used to intersect the indexes token set to get a list of terms\n * to lookup in the inverted index\n */\n var termTokenSet = lunr.TokenSet.fromClause(clause),\n expandedTerms = this.tokenSet.intersect(termTokenSet).toArray()\n\n /*\n * If a term marked as required does not exist in the tokenSet it is\n * impossible for the search to return any matches. We set all the field\n * scoped required matches set to empty and stop examining any further\n * clauses.\n */\n if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) {\n for (var k = 0; k < clause.fields.length; k++) {\n var field = clause.fields[k]\n requiredMatches[field] = lunr.Set.empty\n }\n\n break\n }\n\n for (var j = 0; j < expandedTerms.length; j++) {\n /*\n * For each term get the posting and termIndex, this is required for\n * building the query vector.\n */\n var expandedTerm = expandedTerms[j],\n posting = this.invertedIndex[expandedTerm],\n termIndex = posting._index\n\n for (var k = 0; k < clause.fields.length; k++) {\n /*\n * For each field that this query term is scoped by (by default\n * all fields are in scope) we need to get all the document refs\n * that have this term in that field.\n *\n * The posting is the entry in the invertedIndex for the matching\n * term from above.\n */\n var field = clause.fields[k],\n fieldPosting = posting[field],\n matchingDocumentRefs = Object.keys(fieldPosting),\n termField = expandedTerm + \"/\" + field,\n matchingDocumentsSet = new lunr.Set(matchingDocumentRefs)\n\n /*\n * if the presence of this term is required ensure that the matching\n * documents are added to the set of required matches for this clause.\n *\n */\n if (clause.presence == lunr.Query.presence.REQUIRED) {\n clauseMatches = clauseMatches.union(matchingDocumentsSet)\n\n if (requiredMatches[field] === undefined) {\n requiredMatches[field] = lunr.Set.complete\n }\n }\n\n /*\n * if the presence of this term is prohibited ensure that the matching\n * documents are added to the set of prohibited matches for this field,\n * creating that set if it does not yet exist.\n */\n if (clause.presence == lunr.Query.presence.PROHIBITED) {\n if (prohibitedMatches[field] === undefined) {\n prohibitedMatches[field] = lunr.Set.empty\n }\n\n prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet)\n\n /*\n * Prohibited matches should not be part of the query vector used for\n * similarity scoring and no metadata should be extracted so we continue\n * to the next field\n */\n continue\n }\n\n /*\n * The query field vector is populated using the termIndex found for\n * the term and a unit value with the appropriate boost applied.\n * Using upsert because there could already be an entry in the vector\n * for the term we are working with. In that case we just add the scores\n * together.\n */\n queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b })\n\n /**\n * If we've already seen this term, field combo then we've already collected\n * the matching documents and metadata, no need to go through all that again\n */\n if (termFieldCache[termField]) {\n continue\n }\n\n for (var l = 0; l < matchingDocumentRefs.length; l++) {\n /*\n * All metadata for this term/field/document triple\n * are then extracted and collected into an instance\n * of lunr.MatchData ready to be returned in the query\n * results\n */\n var matchingDocumentRef = matchingDocumentRefs[l],\n matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field),\n metadata = fieldPosting[matchingDocumentRef],\n fieldMatch\n\n if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) {\n matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata)\n } else {\n fieldMatch.add(expandedTerm, field, metadata)\n }\n\n }\n\n termFieldCache[termField] = true\n }\n }\n }\n\n /**\n * If the presence was required we need to update the requiredMatches field sets.\n * We do this after all fields for the term have collected their matches because\n * the clause terms presence is required in _any_ of the fields not _all_ of the\n * fields.\n */\n if (clause.presence === lunr.Query.presence.REQUIRED) {\n for (var k = 0; k < clause.fields.length; k++) {\n var field = clause.fields[k]\n requiredMatches[field] = requiredMatches[field].intersect(clauseMatches)\n }\n }\n }\n\n /**\n * Need to combine the field scoped required and prohibited\n * matching documents into a global set of required and prohibited\n * matches\n */\n var allRequiredMatches = lunr.Set.complete,\n allProhibitedMatches = lunr.Set.empty\n\n for (var i = 0; i < this.fields.length; i++) {\n var field = this.fields[i]\n\n if (requiredMatches[field]) {\n allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field])\n }\n\n if (prohibitedMatches[field]) {\n allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field])\n }\n }\n\n var matchingFieldRefs = Object.keys(matchingFields),\n results = [],\n matches = Object.create(null)\n\n /*\n * If the query is negated (contains only prohibited terms)\n * we need to get _all_ fieldRefs currently existing in the\n * index. This is only done when we know that the query is\n * entirely prohibited terms to avoid any cost of getting all\n * fieldRefs unnecessarily.\n *\n * Additionally, blank MatchData must be created to correctly\n * populate the results.\n */\n if (query.isNegated()) {\n matchingFieldRefs = Object.keys(this.fieldVectors)\n\n for (var i = 0; i < matchingFieldRefs.length; i++) {\n var matchingFieldRef = matchingFieldRefs[i]\n var fieldRef = lunr.FieldRef.fromString(matchingFieldRef)\n matchingFields[matchingFieldRef] = new lunr.MatchData\n }\n }\n\n for (var i = 0; i < matchingFieldRefs.length; i++) {\n /*\n * Currently we have document fields that match the query, but we\n * need to return documents. The matchData and scores are combined\n * from multiple fields belonging to the same document.\n *\n * Scores are calculated by field, using the query vectors created\n * above, and combined into a final document score using addition.\n */\n var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]),\n docRef = fieldRef.docRef\n\n if (!allRequiredMatches.contains(docRef)) {\n continue\n }\n\n if (allProhibitedMatches.contains(docRef)) {\n continue\n }\n\n var fieldVector = this.fieldVectors[fieldRef],\n score = queryVectors[fieldRef.fieldName].similarity(fieldVector),\n docMatch\n\n if ((docMatch = matches[docRef]) !== undefined) {\n docMatch.score += score\n docMatch.matchData.combine(matchingFields[fieldRef])\n } else {\n var match = {\n ref: docRef,\n score: score,\n matchData: matchingFields[fieldRef]\n }\n matches[docRef] = match\n results.push(match)\n }\n }\n\n /*\n * Sort the results objects by score, highest first.\n */\n return results.sort(function (a, b) {\n return b.score - a.score\n })\n}\n\n/**\n * Prepares the index for JSON serialization.\n *\n * The schema for this JSON blob will be described in a\n * separate JSON schema file.\n *\n * @returns {Object}\n */\nlunr.Index.prototype.toJSON = function () {\n var invertedIndex = Object.keys(this.invertedIndex)\n .sort()\n .map(function (term) {\n return [term, this.invertedIndex[term]]\n }, this)\n\n var fieldVectors = Object.keys(this.fieldVectors)\n .map(function (ref) {\n return [ref, this.fieldVectors[ref].toJSON()]\n }, this)\n\n return {\n version: lunr.version,\n fields: this.fields,\n fieldVectors: fieldVectors,\n invertedIndex: invertedIndex,\n pipeline: this.pipeline.toJSON()\n }\n}\n\n/**\n * Loads a previously serialized lunr.Index\n *\n * @param {Object} serializedIndex - A previously serialized lunr.Index\n * @returns {lunr.Index}\n */\nlunr.Index.load = function (serializedIndex) {\n var attrs = {},\n fieldVectors = {},\n serializedVectors = serializedIndex.fieldVectors,\n invertedIndex = Object.create(null),\n serializedInvertedIndex = serializedIndex.invertedIndex,\n tokenSetBuilder = new lunr.TokenSet.Builder,\n pipeline = lunr.Pipeline.load(serializedIndex.pipeline)\n\n if (serializedIndex.version != lunr.version) {\n lunr.utils.warn(\"Version mismatch when loading serialised index. Current version of lunr '\" + lunr.version + \"' does not match serialized index '\" + serializedIndex.version + \"'\")\n }\n\n for (var i = 0; i < serializedVectors.length; i++) {\n var tuple = serializedVectors[i],\n ref = tuple[0],\n elements = tuple[1]\n\n fieldVectors[ref] = new lunr.Vector(elements)\n }\n\n for (var i = 0; i < serializedInvertedIndex.length; i++) {\n var tuple = serializedInvertedIndex[i],\n term = tuple[0],\n posting = tuple[1]\n\n tokenSetBuilder.insert(term)\n invertedIndex[term] = posting\n }\n\n tokenSetBuilder.finish()\n\n attrs.fields = serializedIndex.fields\n\n attrs.fieldVectors = fieldVectors\n attrs.invertedIndex = invertedIndex\n attrs.tokenSet = tokenSetBuilder.root\n attrs.pipeline = pipeline\n\n return new lunr.Index(attrs)\n}\n/*!\n * lunr.Builder\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Builder performs indexing on a set of documents and\n * returns instances of lunr.Index ready for querying.\n *\n * All configuration of the index is done via the builder, the\n * fields to index, the document reference, the text processing\n * pipeline and document scoring parameters are all set on the\n * builder before indexing.\n *\n * @constructor\n * @property {string} _ref - Internal reference to the document reference field.\n * @property {string[]} _fields - Internal reference to the document fields to index.\n * @property {object} invertedIndex - The inverted index maps terms to document fields.\n * @property {object} documentTermFrequencies - Keeps track of document term frequencies.\n * @property {object} documentLengths - Keeps track of the length of documents added to the index.\n * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing.\n * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing.\n * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index.\n * @property {number} documentCount - Keeps track of the total number of documents indexed.\n * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75.\n * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2.\n * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space.\n * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index.\n */\nlunr.Builder = function () {\n this._ref = \"id\"\n this._fields = Object.create(null)\n this._documents = Object.create(null)\n this.invertedIndex = Object.create(null)\n this.fieldTermFrequencies = {}\n this.fieldLengths = {}\n this.tokenizer = lunr.tokenizer\n this.pipeline = new lunr.Pipeline\n this.searchPipeline = new lunr.Pipeline\n this.documentCount = 0\n this._b = 0.75\n this._k1 = 1.2\n this.termIndex = 0\n this.metadataWhitelist = []\n}\n\n/**\n * Sets the document field used as the document reference. Every document must have this field.\n * The type of this field in the document should be a string, if it is not a string it will be\n * coerced into a string by calling toString.\n *\n * The default ref is 'id'.\n *\n * The ref should _not_ be changed during indexing, it should be set before any documents are\n * added to the index. Changing it during indexing can lead to inconsistent results.\n *\n * @param {string} ref - The name of the reference field in the document.\n */\nlunr.Builder.prototype.ref = function (ref) {\n this._ref = ref\n}\n\n/**\n * A function that is used to extract a field from a document.\n *\n * Lunr expects a field to be at the top level of a document, if however the field\n * is deeply nested within a document an extractor function can be used to extract\n * the right field for indexing.\n *\n * @callback fieldExtractor\n * @param {object} doc - The document being added to the index.\n * @returns {?(string|object|object[])} obj - The object that will be indexed for this field.\n * @example Extracting a nested field\n * function (doc) { return doc.nested.field }\n */\n\n/**\n * Adds a field to the list of document fields that will be indexed. Every document being\n * indexed should have this field. Null values for this field in indexed documents will\n * not cause errors but will limit the chance of that document being retrieved by searches.\n *\n * All fields should be added before adding documents to the index. Adding fields after\n * a document has been indexed will have no effect on already indexed documents.\n *\n * Fields can be boosted at build time. This allows terms within that field to have more\n * importance when ranking search results. Use a field boost to specify that matches within\n * one field are more important than other fields.\n *\n * @param {string} fieldName - The name of a field to index in all documents.\n * @param {object} attributes - Optional attributes associated with this field.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this field.\n * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document.\n * @throws {RangeError} fieldName cannot contain unsupported characters '/'\n */\nlunr.Builder.prototype.field = function (fieldName, attributes) {\n if (/\\//.test(fieldName)) {\n throw new RangeError (\"Field '\" + fieldName + \"' contains illegal character '/'\")\n }\n\n this._fields[fieldName] = attributes || {}\n}\n\n/**\n * A parameter to tune the amount of field length normalisation that is applied when\n * calculating relevance scores. A value of 0 will completely disable any normalisation\n * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b\n * will be clamped to the range 0 - 1.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.b = function (number) {\n if (number < 0) {\n this._b = 0\n } else if (number > 1) {\n this._b = 1\n } else {\n this._b = number\n }\n}\n\n/**\n * A parameter that controls the speed at which a rise in term frequency results in term\n * frequency saturation. The default value is 1.2. Setting this to a higher value will give\n * slower saturation levels, a lower value will result in quicker saturation.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.k1 = function (number) {\n this._k1 = number\n}\n\n/**\n * Adds a document to the index.\n *\n * Before adding fields to the index the index should have been fully setup, with the document\n * ref and all fields to index already having been specified.\n *\n * The document must have a field name as specified by the ref (by default this is 'id') and\n * it should have all fields defined for indexing, though null or undefined values will not\n * cause errors.\n *\n * Entire documents can be boosted at build time. Applying a boost to a document indicates that\n * this document should rank higher in search results than other documents.\n *\n * @param {object} doc - The document to add to the index.\n * @param {object} attributes - Optional attributes associated with this document.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this document.\n */\nlunr.Builder.prototype.add = function (doc, attributes) {\n var docRef = doc[this._ref],\n fields = Object.keys(this._fields)\n\n this._documents[docRef] = attributes || {}\n this.documentCount += 1\n\n for (var i = 0; i < fields.length; i++) {\n var fieldName = fields[i],\n extractor = this._fields[fieldName].extractor,\n field = extractor ? extractor(doc) : doc[fieldName],\n tokens = this.tokenizer(field, {\n fields: [fieldName]\n }),\n terms = this.pipeline.run(tokens),\n fieldRef = new lunr.FieldRef (docRef, fieldName),\n fieldTerms = Object.create(null)\n\n this.fieldTermFrequencies[fieldRef] = fieldTerms\n this.fieldLengths[fieldRef] = 0\n\n // store the length of this field for this document\n this.fieldLengths[fieldRef] += terms.length\n\n // calculate term frequencies for this field\n for (var j = 0; j < terms.length; j++) {\n var term = terms[j]\n\n if (fieldTerms[term] == undefined) {\n fieldTerms[term] = 0\n }\n\n fieldTerms[term] += 1\n\n // add to inverted index\n // create an initial posting if one doesn't exist\n if (this.invertedIndex[term] == undefined) {\n var posting = Object.create(null)\n posting[\"_index\"] = this.termIndex\n this.termIndex += 1\n\n for (var k = 0; k < fields.length; k++) {\n posting[fields[k]] = Object.create(null)\n }\n\n this.invertedIndex[term] = posting\n }\n\n // add an entry for this term/fieldName/docRef to the invertedIndex\n if (this.invertedIndex[term][fieldName][docRef] == undefined) {\n this.invertedIndex[term][fieldName][docRef] = Object.create(null)\n }\n\n // store all whitelisted metadata about this token in the\n // inverted index\n for (var l = 0; l < this.metadataWhitelist.length; l++) {\n var metadataKey = this.metadataWhitelist[l],\n metadata = term.metadata[metadataKey]\n\n if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) {\n this.invertedIndex[term][fieldName][docRef][metadataKey] = []\n }\n\n this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata)\n }\n }\n\n }\n}\n\n/**\n * Calculates the average document length for this index\n *\n * @private\n */\nlunr.Builder.prototype.calculateAverageFieldLengths = function () {\n\n var fieldRefs = Object.keys(this.fieldLengths),\n numberOfFields = fieldRefs.length,\n accumulator = {},\n documentsWithField = {}\n\n for (var i = 0; i < numberOfFields; i++) {\n var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n field = fieldRef.fieldName\n\n documentsWithField[field] || (documentsWithField[field] = 0)\n documentsWithField[field] += 1\n\n accumulator[field] || (accumulator[field] = 0)\n accumulator[field] += this.fieldLengths[fieldRef]\n }\n\n var fields = Object.keys(this._fields)\n\n for (var i = 0; i < fields.length; i++) {\n var fieldName = fields[i]\n accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName]\n }\n\n this.averageFieldLength = accumulator\n}\n\n/**\n * Builds a vector space model of every document using lunr.Vector\n *\n * @private\n */\nlunr.Builder.prototype.createFieldVectors = function () {\n var fieldVectors = {},\n fieldRefs = Object.keys(this.fieldTermFrequencies),\n fieldRefsLength = fieldRefs.length,\n termIdfCache = Object.create(null)\n\n for (var i = 0; i < fieldRefsLength; i++) {\n var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n fieldName = fieldRef.fieldName,\n fieldLength = this.fieldLengths[fieldRef],\n fieldVector = new lunr.Vector,\n termFrequencies = this.fieldTermFrequencies[fieldRef],\n terms = Object.keys(termFrequencies),\n termsLength = terms.length\n\n\n var fieldBoost = this._fields[fieldName].boost || 1,\n docBoost = this._documents[fieldRef.docRef].boost || 1\n\n for (var j = 0; j < termsLength; j++) {\n var term = terms[j],\n tf = termFrequencies[term],\n termIndex = this.invertedIndex[term]._index,\n idf, score, scoreWithPrecision\n\n if (termIdfCache[term] === undefined) {\n idf = lunr.idf(this.invertedIndex[term], this.documentCount)\n termIdfCache[term] = idf\n } else {\n idf = termIdfCache[term]\n }\n\n score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf)\n score *= fieldBoost\n score *= docBoost\n scoreWithPrecision = Math.round(score * 1000) / 1000\n // Converts 1.23456789 to 1.234.\n // Reducing the precision so that the vectors take up less\n // space when serialised. Doing it now so that they behave\n // the same before and after serialisation. Also, this is\n // the fastest approach to reducing a number's precision in\n // JavaScript.\n\n fieldVector.insert(termIndex, scoreWithPrecision)\n }\n\n fieldVectors[fieldRef] = fieldVector\n }\n\n this.fieldVectors = fieldVectors\n}\n\n/**\n * Creates a token set of all tokens in the index using lunr.TokenSet\n *\n * @private\n */\nlunr.Builder.prototype.createTokenSet = function () {\n this.tokenSet = lunr.TokenSet.fromArray(\n Object.keys(this.invertedIndex).sort()\n )\n}\n\n/**\n * Builds the index, creating an instance of lunr.Index.\n *\n * This completes the indexing process and should only be called\n * once all documents have been added to the index.\n *\n * @returns {lunr.Index}\n */\nlunr.Builder.prototype.build = function () {\n this.calculateAverageFieldLengths()\n this.createFieldVectors()\n this.createTokenSet()\n\n return new lunr.Index({\n invertedIndex: this.invertedIndex,\n fieldVectors: this.fieldVectors,\n tokenSet: this.tokenSet,\n fields: Object.keys(this._fields),\n pipeline: this.searchPipeline\n })\n}\n\n/**\n * Applies a plugin to the index builder.\n *\n * A plugin is a function that is called with the index builder as its context.\n * Plugins can be used to customise or extend the behaviour of the index\n * in some way. A plugin is just a function, that encapsulated the custom\n * behaviour that should be applied when building the index.\n *\n * The plugin function will be called with the index builder as its argument, additional\n * arguments can also be passed when calling use. The function will be called\n * with the index builder as its context.\n *\n * @param {Function} plugin The plugin to apply.\n */\nlunr.Builder.prototype.use = function (fn) {\n var args = Array.prototype.slice.call(arguments, 1)\n args.unshift(this)\n fn.apply(this, args)\n}\n/**\n * Contains and collects metadata about a matching document.\n * A single instance of lunr.MatchData is returned as part of every\n * lunr.Index~Result.\n *\n * @constructor\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n * @property {object} metadata - A cloned collection of metadata associated with this document.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData = function (term, field, metadata) {\n var clonedMetadata = Object.create(null),\n metadataKeys = Object.keys(metadata || {})\n\n // Cloning the metadata to prevent the original\n // being mutated during match data combination.\n // Metadata is kept in an array within the inverted\n // index so cloning the data can be done with\n // Array#slice\n for (var i = 0; i < metadataKeys.length; i++) {\n var key = metadataKeys[i]\n clonedMetadata[key] = metadata[key].slice()\n }\n\n this.metadata = Object.create(null)\n\n if (term !== undefined) {\n this.metadata[term] = Object.create(null)\n this.metadata[term][field] = clonedMetadata\n }\n}\n\n/**\n * An instance of lunr.MatchData will be created for every term that matches a\n * document. However only one instance is required in a lunr.Index~Result. This\n * method combines metadata from another instance of lunr.MatchData with this\n * objects metadata.\n *\n * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData.prototype.combine = function (otherMatchData) {\n var terms = Object.keys(otherMatchData.metadata)\n\n for (var i = 0; i < terms.length; i++) {\n var term = terms[i],\n fields = Object.keys(otherMatchData.metadata[term])\n\n if (this.metadata[term] == undefined) {\n this.metadata[term] = Object.create(null)\n }\n\n for (var j = 0; j < fields.length; j++) {\n var field = fields[j],\n keys = Object.keys(otherMatchData.metadata[term][field])\n\n if (this.metadata[term][field] == undefined) {\n this.metadata[term][field] = Object.create(null)\n }\n\n for (var k = 0; k < keys.length; k++) {\n var key = keys[k]\n\n if (this.metadata[term][field][key] == undefined) {\n this.metadata[term][field][key] = otherMatchData.metadata[term][field][key]\n } else {\n this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key])\n }\n\n }\n }\n }\n}\n\n/**\n * Add metadata for a term/field pair to this instance of match data.\n *\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n */\nlunr.MatchData.prototype.add = function (term, field, metadata) {\n if (!(term in this.metadata)) {\n this.metadata[term] = Object.create(null)\n this.metadata[term][field] = metadata\n return\n }\n\n if (!(field in this.metadata[term])) {\n this.metadata[term][field] = metadata\n return\n }\n\n var metadataKeys = Object.keys(metadata)\n\n for (var i = 0; i < metadataKeys.length; i++) {\n var key = metadataKeys[i]\n\n if (key in this.metadata[term][field]) {\n this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key])\n } else {\n this.metadata[term][field][key] = metadata[key]\n }\n }\n}\n/**\n * A lunr.Query provides a programmatic way of defining queries to be performed\n * against a {@link lunr.Index}.\n *\n * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method\n * so the query object is pre-initialized with the right index fields.\n *\n * @constructor\n * @property {lunr.Query~Clause[]} clauses - An array of query clauses.\n * @property {string[]} allFields - An array of all available fields in a lunr.Index.\n */\nlunr.Query = function (allFields) {\n this.clauses = []\n this.allFields = allFields\n}\n\n/**\n * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause.\n *\n * This allows wildcards to be added to the beginning and end of a term without having to manually do any string\n * concatenation.\n *\n * The wildcard constants can be bitwise combined to select both leading and trailing wildcards.\n *\n * @constant\n * @default\n * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour\n * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists\n * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example query term with trailing wildcard\n * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING })\n * @example query term with leading and trailing wildcard\n * query.term('foo', {\n * wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING\n * })\n */\n\nlunr.Query.wildcard = new String (\"*\")\nlunr.Query.wildcard.NONE = 0\nlunr.Query.wildcard.LEADING = 1\nlunr.Query.wildcard.TRAILING = 2\n\n/**\n * Constants for indicating what kind of presence a term must have in matching documents.\n *\n * @constant\n * @enum {number}\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example query term with required presence\n * query.term('foo', { presence: lunr.Query.presence.REQUIRED })\n */\nlunr.Query.presence = {\n /**\n * Term's presence in a document is optional, this is the default value.\n */\n OPTIONAL: 1,\n\n /**\n * Term's presence in a document is required, documents that do not contain\n * this term will not be returned.\n */\n REQUIRED: 2,\n\n /**\n * Term's presence in a document is prohibited, documents that do contain\n * this term will not be returned.\n */\n PROHIBITED: 3\n}\n\n/**\n * A single clause in a {@link lunr.Query} contains a term and details on how to\n * match that term against a {@link lunr.Index}.\n *\n * @typedef {Object} lunr.Query~Clause\n * @property {string[]} fields - The fields in an index this clause should be matched against.\n * @property {number} [boost=1] - Any boost that should be applied when matching this clause.\n * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be.\n * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline.\n * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended.\n * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents.\n */\n\n/**\n * Adds a {@link lunr.Query~Clause} to this query.\n *\n * Unless the clause contains the fields to be matched all fields will be matched. In addition\n * a default boost of 1 is applied to the clause.\n *\n * @param {lunr.Query~Clause} clause - The clause to add to this query.\n * @see lunr.Query~Clause\n * @returns {lunr.Query}\n */\nlunr.Query.prototype.clause = function (clause) {\n if (!('fields' in clause)) {\n clause.fields = this.allFields\n }\n\n if (!('boost' in clause)) {\n clause.boost = 1\n }\n\n if (!('usePipeline' in clause)) {\n clause.usePipeline = true\n }\n\n if (!('wildcard' in clause)) {\n clause.wildcard = lunr.Query.wildcard.NONE\n }\n\n if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) {\n clause.term = \"*\" + clause.term\n }\n\n if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) {\n clause.term = \"\" + clause.term + \"*\"\n }\n\n if (!('presence' in clause)) {\n clause.presence = lunr.Query.presence.OPTIONAL\n }\n\n this.clauses.push(clause)\n\n return this\n}\n\n/**\n * A negated query is one in which every clause has a presence of\n * prohibited. These queries require some special processing to return\n * the expected results.\n *\n * @returns boolean\n */\nlunr.Query.prototype.isNegated = function () {\n for (var i = 0; i < this.clauses.length; i++) {\n if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) {\n return false\n }\n }\n\n return true\n}\n\n/**\n * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause}\n * to the list of clauses that make up this query.\n *\n * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion\n * to a token or token-like string should be done before calling this method.\n *\n * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an\n * array, each term in the array will share the same options.\n *\n * @param {object|object[]} term - The term(s) to add to the query.\n * @param {object} [options] - Any additional properties to add to the query clause.\n * @returns {lunr.Query}\n * @see lunr.Query#clause\n * @see lunr.Query~Clause\n * @example adding a single term to a query\n * query.term(\"foo\")\n * @example adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard\n * query.term(\"foo\", {\n * fields: [\"title\"],\n * boost: 10,\n * wildcard: lunr.Query.wildcard.TRAILING\n * })\n * @example using lunr.tokenizer to convert a string to tokens before using them as terms\n * query.term(lunr.tokenizer(\"foo bar\"))\n */\nlunr.Query.prototype.term = function (term, options) {\n if (Array.isArray(term)) {\n term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this)\n return this\n }\n\n var clause = options || {}\n clause.term = term.toString()\n\n this.clause(clause)\n\n return this\n}\nlunr.QueryParseError = function (message, start, end) {\n this.name = \"QueryParseError\"\n this.message = message\n this.start = start\n this.end = end\n}\n\nlunr.QueryParseError.prototype = new Error\nlunr.QueryLexer = function (str) {\n this.lexemes = []\n this.str = str\n this.length = str.length\n this.pos = 0\n this.start = 0\n this.escapeCharPositions = []\n}\n\nlunr.QueryLexer.prototype.run = function () {\n var state = lunr.QueryLexer.lexText\n\n while (state) {\n state = state(this)\n }\n}\n\nlunr.QueryLexer.prototype.sliceString = function () {\n var subSlices = [],\n sliceStart = this.start,\n sliceEnd = this.pos\n\n for (var i = 0; i < this.escapeCharPositions.length; i++) {\n sliceEnd = this.escapeCharPositions[i]\n subSlices.push(this.str.slice(sliceStart, sliceEnd))\n sliceStart = sliceEnd + 1\n }\n\n subSlices.push(this.str.slice(sliceStart, this.pos))\n this.escapeCharPositions.length = 0\n\n return subSlices.join('')\n}\n\nlunr.QueryLexer.prototype.emit = function (type) {\n this.lexemes.push({\n type: type,\n str: this.sliceString(),\n start: this.start,\n end: this.pos\n })\n\n this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.escapeCharacter = function () {\n this.escapeCharPositions.push(this.pos - 1)\n this.pos += 1\n}\n\nlunr.QueryLexer.prototype.next = function () {\n if (this.pos >= this.length) {\n return lunr.QueryLexer.EOS\n }\n\n var char = this.str.charAt(this.pos)\n this.pos += 1\n return char\n}\n\nlunr.QueryLexer.prototype.width = function () {\n return this.pos - this.start\n}\n\nlunr.QueryLexer.prototype.ignore = function () {\n if (this.start == this.pos) {\n this.pos += 1\n }\n\n this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.backup = function () {\n this.pos -= 1\n}\n\nlunr.QueryLexer.prototype.acceptDigitRun = function () {\n var char, charCode\n\n do {\n char = this.next()\n charCode = char.charCodeAt(0)\n } while (charCode > 47 && charCode < 58)\n\n if (char != lunr.QueryLexer.EOS) {\n this.backup()\n }\n}\n\nlunr.QueryLexer.prototype.more = function () {\n return this.pos < this.length\n}\n\nlunr.QueryLexer.EOS = 'EOS'\nlunr.QueryLexer.FIELD = 'FIELD'\nlunr.QueryLexer.TERM = 'TERM'\nlunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE'\nlunr.QueryLexer.BOOST = 'BOOST'\nlunr.QueryLexer.PRESENCE = 'PRESENCE'\n\nlunr.QueryLexer.lexField = function (lexer) {\n lexer.backup()\n lexer.emit(lunr.QueryLexer.FIELD)\n lexer.ignore()\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexTerm = function (lexer) {\n if (lexer.width() > 1) {\n lexer.backup()\n lexer.emit(lunr.QueryLexer.TERM)\n }\n\n lexer.ignore()\n\n if (lexer.more()) {\n return lunr.QueryLexer.lexText\n }\n}\n\nlunr.QueryLexer.lexEditDistance = function (lexer) {\n lexer.ignore()\n lexer.acceptDigitRun()\n lexer.emit(lunr.QueryLexer.EDIT_DISTANCE)\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexBoost = function (lexer) {\n lexer.ignore()\n lexer.acceptDigitRun()\n lexer.emit(lunr.QueryLexer.BOOST)\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexEOS = function (lexer) {\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n}\n\n// This matches the separator used when tokenising fields\n// within a document. These should match otherwise it is\n// not possible to search for some tokens within a document.\n//\n// It is possible for the user to change the separator on the\n// tokenizer so it _might_ clash with any other of the special\n// characters already used within the search string, e.g. :.\n//\n// This means that it is possible to change the separator in\n// such a way that makes some words unsearchable using a search\n// string.\nlunr.QueryLexer.termSeparator = lunr.tokenizer.separator\n\nlunr.QueryLexer.lexText = function (lexer) {\n while (true) {\n var char = lexer.next()\n\n if (char == lunr.QueryLexer.EOS) {\n return lunr.QueryLexer.lexEOS\n }\n\n // Escape character is '\\'\n if (char.charCodeAt(0) == 92) {\n lexer.escapeCharacter()\n continue\n }\n\n if (char == \":\") {\n return lunr.QueryLexer.lexField\n }\n\n if (char == \"~\") {\n lexer.backup()\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n return lunr.QueryLexer.lexEditDistance\n }\n\n if (char == \"^\") {\n lexer.backup()\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n return lunr.QueryLexer.lexBoost\n }\n\n // \"+\" indicates term presence is required\n // checking for length to ensure that only\n // leading \"+\" are considered\n if (char == \"+\" && lexer.width() === 1) {\n lexer.emit(lunr.QueryLexer.PRESENCE)\n return lunr.QueryLexer.lexText\n }\n\n // \"-\" indicates term presence is prohibited\n // checking for length to ensure that only\n // leading \"-\" are considered\n if (char == \"-\" && lexer.width() === 1) {\n lexer.emit(lunr.QueryLexer.PRESENCE)\n return lunr.QueryLexer.lexText\n }\n\n if (char.match(lunr.QueryLexer.termSeparator)) {\n return lunr.QueryLexer.lexTerm\n }\n }\n}\n\nlunr.QueryParser = function (str, query) {\n this.lexer = new lunr.QueryLexer (str)\n this.query = query\n this.currentClause = {}\n this.lexemeIdx = 0\n}\n\nlunr.QueryParser.prototype.parse = function () {\n this.lexer.run()\n this.lexemes = this.lexer.lexemes\n\n var state = lunr.QueryParser.parseClause\n\n while (state) {\n state = state(this)\n }\n\n return this.query\n}\n\nlunr.QueryParser.prototype.peekLexeme = function () {\n return this.lexemes[this.lexemeIdx]\n}\n\nlunr.QueryParser.prototype.consumeLexeme = function () {\n var lexeme = this.peekLexeme()\n this.lexemeIdx += 1\n return lexeme\n}\n\nlunr.QueryParser.prototype.nextClause = function () {\n var completedClause = this.currentClause\n this.query.clause(completedClause)\n this.currentClause = {}\n}\n\nlunr.QueryParser.parseClause = function (parser) {\n var lexeme = parser.peekLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n switch (lexeme.type) {\n case lunr.QueryLexer.PRESENCE:\n return lunr.QueryParser.parsePresence\n case lunr.QueryLexer.FIELD:\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expected either a field or a term, found \" + lexeme.type\n\n if (lexeme.str.length >= 1) {\n errorMessage += \" with value '\" + lexeme.str + \"'\"\n }\n\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n}\n\nlunr.QueryParser.parsePresence = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n switch (lexeme.str) {\n case \"-\":\n parser.currentClause.presence = lunr.Query.presence.PROHIBITED\n break\n case \"+\":\n parser.currentClause.presence = lunr.Query.presence.REQUIRED\n break\n default:\n var errorMessage = \"unrecognised presence operator'\" + lexeme.str + \"'\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n var errorMessage = \"expecting term or field, found nothing\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.FIELD:\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expecting term or field, found '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseField = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n if (parser.query.allFields.indexOf(lexeme.str) == -1) {\n var possibleFields = parser.query.allFields.map(function (f) { return \"'\" + f + \"'\" }).join(', '),\n errorMessage = \"unrecognised field '\" + lexeme.str + \"', possible fields: \" + possibleFields\n\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.fields = [lexeme.str]\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n var errorMessage = \"expecting term, found nothing\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expecting term, found '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseTerm = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n parser.currentClause.term = lexeme.str.toLowerCase()\n\n if (lexeme.str.indexOf(\"*\") != -1) {\n parser.currentClause.usePipeline = false\n }\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseEditDistance = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n var editDistance = parseInt(lexeme.str, 10)\n\n if (isNaN(editDistance)) {\n var errorMessage = \"edit distance must be numeric\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.editDistance = editDistance\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseBoost = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n var boost = parseInt(lexeme.str, 10)\n\n if (isNaN(boost)) {\n var errorMessage = \"boost must be numeric\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.boost = boost\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\n /**\n * export the module via AMD, CommonJS or as a browser global\n * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js\n */\n ;(function (root, factory) {\n if (typeof define === 'function' && define.amd) {\n // AMD. Register as an anonymous module.\n define(factory)\n } else if (typeof exports === 'object') {\n /**\n * Node. Does not work with strict CommonJS, but\n * only CommonJS-like enviroments that support module.exports,\n * like Node.\n */\n module.exports = factory()\n } else {\n // Browser globals (root is window)\n root.lunr = factory()\n }\n }(this, function () {\n /**\n * Just return a value to define the module export.\n * This example returns an object, but the module\n * can return a function as the exported value.\n */\n return lunr\n }))\n})();\n", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n var str = '' + string;\n var match = matchHtmlRegExp.exec(str);\n\n if (!match) {\n return str;\n }\n\n var escape;\n var html = '';\n var index = 0;\n var lastIndex = 0;\n\n for (index = match.index; index < str.length; index++) {\n switch (str.charCodeAt(index)) {\n case 34: // \"\n escape = '"';\n break;\n case 38: // &\n escape = '&';\n break;\n case 39: // '\n escape = ''';\n break;\n case 60: // <\n escape = '<';\n break;\n case 62: // >\n escape = '>';\n break;\n default:\n continue;\n }\n\n if (lastIndex !== index) {\n html += str.substring(lastIndex, index);\n }\n\n lastIndex = index + 1;\n html += escape;\n }\n\n return lastIndex !== index\n ? html + str.substring(lastIndex, index)\n : html;\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport lunr from \"lunr\"\n\nimport { Search, SearchIndexConfig } from \"../../_\"\nimport {\n SearchMessage,\n SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Add support for usage with `iframe-worker` polyfill\n *\n * While `importScripts` is synchronous when executed inside of a web worker,\n * it's not possible to provide a synchronous polyfilled implementation. The\n * cool thing is that awaiting a non-Promise is a noop, so extending the type\n * definition to return a `Promise` shouldn't break anything.\n *\n * @see https://bit.ly/2PjDnXi - GitHub comment\n */\ndeclare global {\n function importScripts(...urls: string[]): Promise | void\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nlet index: Search\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch (= import) multi-language support through `lunr-languages`\n *\n * This function automatically imports the stemmers necessary to process the\n * languages, which are defined through the search index configuration.\n *\n * If the worker runs inside of an `iframe` (when using `iframe-worker` as\n * a shim), the base URL for the stemmers to be loaded must be determined by\n * searching for the first `script` element with a `src` attribute, which will\n * contain the contents of this script.\n *\n * @param config - Search index configuration\n *\n * @returns Promise resolving with no result\n */\nasync function setupSearchLanguages(\n config: SearchIndexConfig\n): Promise {\n let base = \"../lunr\"\n\n /* Detect `iframe-worker` and fix base URL */\n if (typeof parent !== \"undefined\" && \"IFrameWorker\" in parent) {\n const worker = document.querySelector(\"script[src]\")!\n const [path] = worker.src.split(\"/worker\")\n\n /* Prefix base with path */\n base = base.replace(\"..\", path)\n }\n\n /* Add scripts for languages */\n const scripts = []\n for (const lang of config.lang) {\n switch (lang) {\n\n /* Add segmenter for Japanese */\n case \"ja\":\n scripts.push(`${base}/tinyseg.js`)\n break\n\n /* Add segmenter for Hindi and Thai */\n case \"hi\":\n case \"th\":\n scripts.push(`${base}/wordcut.js`)\n break\n }\n\n /* Add language support */\n if (lang !== \"en\")\n scripts.push(`${base}/min/lunr.${lang}.min.js`)\n }\n\n /* Add multi-language support */\n if (config.lang.length > 1)\n scripts.push(`${base}/min/lunr.multi.min.js`)\n\n /* Load scripts synchronously */\n if (scripts.length)\n await importScripts(\n `${base}/min/lunr.stemmer.support.min.js`,\n ...scripts\n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Message handler\n *\n * @param message - Source message\n *\n * @returns Target message\n */\nexport async function handler(\n message: SearchMessage\n): Promise {\n switch (message.type) {\n\n /* Search setup message */\n case SearchMessageType.SETUP:\n await setupSearchLanguages(message.data.config)\n index = new Search(message.data)\n return {\n type: SearchMessageType.READY\n }\n\n /* Search query message */\n case SearchMessageType.QUERY:\n return {\n type: SearchMessageType.RESULT,\n data: index ? index.search(message.data) : { items: [] }\n }\n\n /* All other messages */\n default:\n throw new TypeError(\"Invalid message type\")\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Worker\n * ------------------------------------------------------------------------- */\n\n/* @ts-expect-error - expose Lunr.js in global scope, or stemmers won't work */\nself.lunr = lunr\n\n/* Handle messages */\naddEventListener(\"message\", async ev => {\n postMessage(await handler(ev.data))\n})\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexDocument } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search document\n */\nexport interface SearchDocument extends SearchIndexDocument {\n parent?: SearchIndexDocument /* Parent article */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search document mapping\n */\nexport type SearchDocumentMap = Map\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document mapping\n *\n * @param docs - Search index documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n docs: SearchIndexDocument[]\n): SearchDocumentMap {\n const documents = new Map()\n const parents = new Set()\n for (const doc of docs) {\n const [path, hash] = doc.location.split(\"#\")\n\n /* Extract location and title */\n const location = doc.location\n const title = doc.title\n\n /* Escape and cleanup text */\n const text = escapeHTML(doc.text)\n .replace(/\\s+(?=[,.:;!?])/g, \"\")\n .replace(/\\s+/g, \" \")\n\n /* Handle section */\n if (hash) {\n const parent = documents.get(path)!\n\n /* Ignore first section, override article */\n if (!parents.has(parent)) {\n parent.title = doc.title\n parent.text = text\n\n /* Remember that we processed the article */\n parents.add(parent)\n\n /* Add subsequent section */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n parent\n })\n }\n\n /* Add article */\n } else {\n documents.set(location, {\n location,\n title,\n text\n })\n }\n }\n return documents\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexConfig } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search index configuration\n * @param escape - Whether to escape HTML\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n config: SearchIndexConfig, escape: boolean\n): SearchHighlightFactoryFn {\n const separator = new RegExp(config.separator, \"img\")\n const highlight = (_: unknown, data: string, term: string) => {\n return `${data}${term}`\n }\n\n /* Return factory function */\n return (query: string) => {\n query = query\n .replace(/[\\s*+\\-:~^]+/g, \" \")\n .trim()\n\n /* Create search term match expression */\n const match = new RegExp(`(^|${config.separator})(${\n query\n .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n .replace(separator, \"|\")\n })`, \"img\")\n\n /* Highlight string value */\n return value => (\n escape\n ? escapeHTML(value)\n : value\n )\n .replace(match, highlight)\n .replace(/<\\/mark>(\\s+)]*>/img, \"$1\")\n }\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query clause\n */\nexport interface SearchQueryClause {\n presence: lunr.Query.presence /* Clause presence */\n term: string /* Clause term */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search query terms\n */\nexport type SearchQueryTerms = Record\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Parse a search query for analysis\n *\n * @param value - Query value\n *\n * @returns Search query clauses\n */\nexport function parseSearchQuery(\n value: string\n): SearchQueryClause[] {\n const query = new (lunr as any).Query([\"title\", \"text\"])\n const parser = new (lunr as any).QueryParser(value, query)\n\n /* Parse and return query clauses */\n parser.parse()\n return query.clauses\n}\n\n/**\n * Analyze the search query clauses in regard to the search terms found\n *\n * @param query - Search query clauses\n * @param terms - Search terms\n *\n * @returns Search query terms\n */\nexport function getSearchQueryTerms(\n query: SearchQueryClause[], terms: string[]\n): SearchQueryTerms {\n const clauses = new Set(query)\n\n /* Match query clauses against terms */\n const result: SearchQueryTerms = {}\n for (let t = 0; t < terms.length; t++)\n for (const clause of clauses)\n if (terms[t].startsWith(clause.term)) {\n result[clause.term] = true\n clauses.delete(clause)\n }\n\n /* Annotate unmatched non-stopword query clauses */\n for (const clause of clauses)\n if (lunr.stopWordFilter?.(clause.term as any))\n result[clause.term] = false\n\n /* Return query terms */\n return result\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n SearchDocument,\n SearchDocumentMap,\n setupSearchDocumentMap\n} from \"../document\"\nimport {\n SearchHighlightFactoryFn,\n setupSearchHighlighter\n} from \"../highlighter\"\nimport { SearchOptions } from \"../options\"\nimport {\n SearchQueryTerms,\n getSearchQueryTerms,\n parseSearchQuery\n} from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index configuration\n */\nexport interface SearchIndexConfig {\n lang: string[] /* Search languages */\n separator: string /* Search separator */\n}\n\n/**\n * Search index document\n */\nexport interface SearchIndexDocument {\n location: string /* Document location */\n title: string /* Document title */\n text: string /* Document text */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search index\n *\n * This interfaces describes the format of the `search_index.json` file which\n * is automatically built by the MkDocs search plugin.\n */\nexport interface SearchIndex {\n config: SearchIndexConfig /* Search index configuration */\n docs: SearchIndexDocument[] /* Search index documents */\n options: SearchOptions /* Search options */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search metadata\n */\nexport interface SearchMetadata {\n score: number /* Score (relevance) */\n terms: SearchQueryTerms /* Search query terms */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search result document\n */\nexport type SearchResultDocument = SearchDocument & SearchMetadata\n\n/**\n * Search result item\n */\nexport type SearchResultItem = SearchResultDocument[]\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search result\n */\nexport interface SearchResult {\n items: SearchResultItem[] /* Search result items */\n suggestions?: string[] /* Search suggestions */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute the difference of two lists of strings\n *\n * @param a - 1st list of strings\n * @param b - 2nd list of strings\n *\n * @returns Difference\n */\nfunction difference(a: string[], b: string[]): string[] {\n const [x, y] = [new Set(a), new Set(b)]\n return [\n ...new Set([...x].filter(value => !y.has(value)))\n ]\n}\n\n/* ----------------------------------------------------------------------------\n * Class\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport class Search {\n\n /**\n * Search document mapping\n *\n * A mapping of URLs (including hash fragments) to the actual articles and\n * sections of the documentation. The search document mapping must be created\n * regardless of whether the index was prebuilt or not, as Lunr.js itself\n * only stores the actual index.\n */\n protected documents: SearchDocumentMap\n\n /**\n * Search highlight factory function\n */\n protected highlight: SearchHighlightFactoryFn\n\n /**\n * The underlying Lunr.js search index\n */\n protected index: lunr.Index\n\n /**\n * Search options\n */\n protected options: SearchOptions\n\n /**\n * Create the search integration\n *\n * @param data - Search index\n */\n public constructor({ config, docs, options }: SearchIndex) {\n this.options = options\n\n /* Set up document map and highlighter factory */\n this.documents = setupSearchDocumentMap(docs)\n this.highlight = setupSearchHighlighter(config, false)\n\n /* Set separator for tokenizer */\n lunr.tokenizer.separator = new RegExp(config.separator)\n\n /* Create search index */\n this.index = lunr(function () {\n\n /* Set up multi-language support */\n if (config.lang.length === 1 && config.lang[0] !== \"en\") {\n this.use((lunr as any)[config.lang[0]])\n } else if (config.lang.length > 1) {\n this.use((lunr as any).multiLanguage(...config.lang))\n }\n\n /* Compute functions to be removed from the pipeline */\n const fns = difference([\n \"trimmer\", \"stopWordFilter\", \"stemmer\"\n ], options.pipeline)\n\n /* Remove functions from the pipeline for registered languages */\n for (const lang of config.lang.map(language => (\n language === \"en\" ? lunr : (lunr as any)[language]\n ))) {\n for (const fn of fns) {\n this.pipeline.remove(lang[fn])\n this.searchPipeline.remove(lang[fn])\n }\n }\n\n /* Set up reference */\n this.ref(\"location\")\n\n /* Set up fields */\n this.field(\"title\", { boost: 1e3 })\n this.field(\"text\")\n\n /* Index documents */\n for (const doc of docs)\n this.add(doc)\n })\n }\n\n /**\n * Search for matching documents\n *\n * The search index which MkDocs provides is divided up into articles, which\n * contain the whole content of the individual pages, and sections, which only\n * contain the contents of the subsections obtained by breaking the individual\n * pages up at `h1` ... `h6`. As there may be many sections on different pages\n * with identical titles (for example within this very project, e.g. \"Usage\"\n * or \"Installation\"), they need to be put into the context of the containing\n * page. For this reason, section results are grouped within their respective\n * articles which are the top-level results that are returned.\n *\n * @param query - Query value\n *\n * @returns Search results\n */\n public search(query: string): SearchResult {\n if (query) {\n try {\n const highlight = this.highlight(query)\n\n /* Parse query to extract clauses for analysis */\n const clauses = parseSearchQuery(query)\n .filter(clause => (\n clause.presence !== lunr.Query.presence.PROHIBITED\n ))\n\n /* Perform search and post-process results */\n const groups = this.index.search(`${query}*`)\n\n /* Apply post-query boosts based on title and search query terms */\n .reduce((item, { ref, score, matchData }) => {\n const document = this.documents.get(ref)\n if (typeof document !== \"undefined\") {\n const { location, title, text, parent } = document\n\n /* Compute and analyze search query terms */\n const terms = getSearchQueryTerms(\n clauses,\n Object.keys(matchData.metadata)\n )\n\n /* Highlight title and text and apply post-query boosts */\n const boost = +!parent + +Object.values(terms).every(t => t)\n item.push({\n location,\n title: highlight(title),\n text: highlight(text),\n score: score * (1 + boost),\n terms\n })\n }\n return item\n }, [])\n\n /* Sort search results again after applying boosts */\n .sort((a, b) => b.score - a.score)\n\n /* Group search results by page */\n .reduce((items, result) => {\n const document = this.documents.get(result.location)\n if (typeof document !== \"undefined\") {\n const ref = \"parent\" in document\n ? document.parent!.location\n : document.location\n items.set(ref, [...items.get(ref) || [], result])\n }\n return items\n }, new Map())\n\n /* Generate search suggestions, if desired */\n let suggestions: string[] | undefined\n if (this.options.suggestions) {\n const titles = this.index.query(builder => {\n for (const clause of clauses)\n builder.term(clause.term, {\n fields: [\"title\"],\n presence: lunr.Query.presence.REQUIRED,\n wildcard: lunr.Query.wildcard.TRAILING\n })\n })\n\n /* Retrieve suggestions for best match */\n suggestions = titles.length\n ? Object.keys(titles[0].matchData.metadata)\n : []\n }\n\n /* Return items and suggestions */\n return {\n items: [...groups.values()],\n ...typeof suggestions !== \"undefined\" && { suggestions }\n }\n\n /* Log errors to console (for now) */\n } catch {\n console.warn(`Invalid query: ${query} \u2013 see https://bit.ly/2s3ChXG`)\n }\n }\n\n /* Return nothing in case of error or empty query */\n return { items: [] }\n }\n}\n"], + "mappings": "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", + "names": [] +} diff --git a/3.25.0/assets/stylesheets/main.bb3983ee.min.css b/3.25.0/assets/stylesheets/main.bb3983ee.min.css new file mode 100644 index 0000000000..78df7f6bd4 --- /dev/null +++ b/3.25.0/assets/stylesheets/main.bb3983ee.min.css @@ -0,0 +1,9 @@ +@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:content-box;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:separate;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:transparent;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-default-fg-color:rgba(0,0,0,.87);--md-default-fg-color--light:rgba(0,0,0,.54);--md-default-fg-color--lighter:rgba(0,0,0,.32);--md-default-fg-color--lightest:rgba(0,0,0,.07);--md-default-bg-color:#fff;--md-default-bg-color--light:hsla(0,0%,100%,.7);--md-default-bg-color--lighter:hsla(0,0%,100%,.3);--md-default-bg-color--lightest:hsla(0,0%,100%,.12);--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:rgba(82,108,254,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7);--md-shadow-z1:0 0.2rem 0.5rem rgba(0,0,0,.05),0 0 0.05rem rgba(0,0,0,.1);--md-shadow-z2:0 0.2rem 0.5rem rgba(0,0,0,.1),0 0 0.05rem rgba(0,0,0,.25);--md-shadow-z3:0 0.2rem 0.5rem rgba(0,0,0,.2),0 0 0.05rem rgba(0,0,0,.35)}:root>*{--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:rgba(255,255,0,.5);--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-mark-color:rgba(255,255,0,.5);--md-typeset-del-color:rgba(245,80,61,.15);--md-typeset-ins-color:rgba(11,213,112,.15);--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-table-color:rgba(0,0,0,.12);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-fg-color:#fff;--md-footer-fg-color--light:hsla(0,0%,100%,.7);--md-footer-fg-color--lighter:hsla(0,0%,100%,.3);--md-footer-bg-color:rgba(0,0,0,.87);--md-footer-bg-color--dark:rgba(0,0,0,.32)}.md-icon svg{fill:currentColor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}body,input{font-feature-settings:"kern","liga";font-family:var(--md-text-font-family)}body,code,input,kbd,pre{color:var(--md-typeset-color)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset :is(ul,ol,dl,figure,blockquote,pre){margin:1em 0}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset :is(h5,h6){color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset :is(code,pre,kbd){color:var(--md-code-fg-color);direction:ltr}@media print{.md-typeset :is(code,pre,kbd){white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset :is(h1,h2,h3,h4,h5,h6) code{background-color:transparent;box-shadow:none;margin:initial;padding:initial}.md-typeset a code{color:currentColor}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}@media (hover:none){.md-typeset abbr{position:relative}[dir=ltr] .md-typeset abbr[title]:is(:focus,:hover):after{left:0}[dir=rtl] .md-typeset abbr[title]:is(:focus,:hover):after{right:0}.md-typeset abbr[title]:is(:focus,:hover):after{background-color:var(--md-default-fg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z3);color:var(--md-default-bg-color);content:attr(title);display:inline-block;font-size:.7rem;margin-top:2em;max-width:80%;min-width:-webkit-max-content;min-width:max-content;padding:.2rem .3rem;position:absolute;width:auto}}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset :is(sup,sub){margin-left:.078125em}[dir=rtl] .md-typeset :is(sup,sub){margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light)}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset :is(ul,ol){margin-left:.625em}[dir=rtl] .md-typeset :is(ul,ol){margin-right:.625em}.md-typeset :is(ul,ol){padding:0}.md-typeset :is(ul,ol):not([hidden]){display:flow-root}.md-typeset :is(ul,ol) ol{list-style-type:lower-alpha}.md-typeset :is(ul,ol) ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset :is(ul,ol) li{margin-left:1.25em}[dir=rtl] .md-typeset :is(ul,ol) li{margin-right:1.25em}.md-typeset :is(ul,ol) li{margin-bottom:.5em}.md-typeset :is(ul,ol) li :is(p,blockquote){margin:.5em 0}.md-typeset :is(ul,ol) li:last-child{margin-bottom:0}[dir=ltr] .md-typeset :is(ul,ol) li :is(ul,ol){margin-left:.625em}[dir=rtl] .md-typeset :is(ul,ol) li :is(ul,ol){margin-right:.625em}.md-typeset :is(ul,ol) li :is(ul,ol){margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset :is(img,svg){height:auto;max-width:100%}.md-typeset :is(img,svg)[align=left]{margin:1em 1em 1em 0}.md-typeset :is(img,svg)[align=right]{margin:1em 0 1em 1em}.md-typeset :is(img,svg)[align]:only-child{margin-top:0}.md-typeset img[src$="#only-dark"]{display:none}.md-typeset figure{display:flow-root;margin:0 auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block}.md-typeset figcaption{font-style:italic;margin:1em auto 2em;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) :is(th,td)>:first-child{margin-top:0}.md-typeset table:not([class]) :is(th,td)>:last-child{margin-bottom:0}.md-typeset table:not([class]) :is(th,td):not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) :is(th,td):not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) th a{color:inherit}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:rgba(0,0,0,.035);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.9375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background:var(--md-typeset-mark-color);color:var(--md-default-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.9375em){body[data-md-state=lock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentColor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:is(:focus,:hover) code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{float:right;margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}[dir=rtl] .md-content__button{float:left}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog[data-md-state=open]{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{display:flex;justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__link{display:flex;flex-grow:0.01;outline-color:var(--md-accent-fg-color);overflow:hidden;padding-bottom:.4rem;padding-top:1.4rem;transition:opacity .25s}.md-footer__link:is(:focus,:hover){opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.9375em){.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;line-height:2.4rem;max-width:calc(100% - 2.4rem);padding:0 1rem;position:relative}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;left:0;margin-top:-1rem;opacity:.7;padding:0 1rem;position:absolute;right:0}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:is(:focus,:hover){color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentColor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:is(:focus,:hover){background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=ltr] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:is(:focus,:hover){border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem transparent,0 .2rem .4rem transparent;color:var(--md-primary-bg-color);left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[data-md-state=shadow]{box-shadow:0 0 .2rem rgba(0,0,0,.1),0 .2rem .4rem rgba(0,0,0,.2);transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header[data-md-state=hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentColor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.1875em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo :is(img,svg){fill:currentColor;display:block;height:1.2rem;width:1.2rem}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem}[dir=ltr] .md-header__title{margin-left:1rem}[dir=rtl] .md-header__title{margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title[data-md-state=active] .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title[data-md-state=active] .md-header__topic{transform:translateX(1.25rem)}.md-header__title[data-md-state=active] .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo :is(img,svg){fill:currentColor;display:block;height:2.4rem;width:2.4rem}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__item{padding:0 .6rem}[dir=ltr] .md-nav__item .md-nav__item{padding-right:0}[dir=rtl] .md-nav__item .md-nav__item{padding-left:0}.md-nav__link{align-items:center;cursor:pointer;display:flex;justify-content:space-between;margin-top:.625em;overflow:hidden;scroll-snap-align:start;text-overflow:ellipsis;transition:color 125ms}.md-nav__link[data-md-state=blur]{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active{color:var(--md-typeset-a-color)}.md-nav__item .md-nav__link--index [href]{width:100%}.md-nav__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentColor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__link>*{cursor:pointer;display:flex}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.1875em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary :is(.md-nav__title,.md-nav__item){font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;font-weight:400;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentColor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}[dir=ltr] .md-nav--primary .md-nav__title .md-logo{left:.2rem}[dir=rtl] .md-nav--primary .md-nav__title .md-logo{right:.2rem}.md-nav--primary .md-nav__title .md-logo{display:block;margin:.2rem;padding:.4rem;position:absolute;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest);padding:0}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentColor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:transparent;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:transparent}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.9375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}}@media screen and (min-width:76.25em){.md-nav{transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}.md-nav__toggle~.md-nav{display:none}.md-nav__toggle:is(:checked,:indeterminate)~.md-nav{display:block}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700;pointer-events:none}.md-nav__item--section>.md-nav__link--index [href]{pointer-events:auto}.md-nav__item--section>.md-nav__link .md-nav__icon{display:none}.md-nav__item--section>.md-nav{display:block}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;float:right;height:.9rem;transition:background-color .25s,transform .25s;width:.9rem}[dir=rtl] .md-nav__icon{float:left;transform:rotate(180deg)}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentColor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:-.1rem;width:100%}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon,.md-nav__item--nested .md-nav__toggle:indeterminate~.md-nav__link .md-nav__icon{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item--nested,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block;padding:0}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{font-weight:700;margin-top:0;padding:0 .6rem;pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link--index [href]{pointer-events:auto}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link .md-nav__icon{display:none}.md-nav--lifted .md-nav[data-md-level="1"]{display:block}[dir=ltr] .md-nav--lifted .md-nav[data-md-level="1"]>.md-nav__list>.md-nav__item{padding-right:.6rem}[dir=rtl] .md-nav--lifted .md-nav[data-md-level="1"]>.md-nav__list>.md-nav__item{padding-left:.6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested){padding:0 .6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested)>.md-nav__link{padding:0}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:rgba(0,0,0,.54);cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){.md-search__inner{float:right;padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}[dir=rtl] .md-search__inner{float:left}}@media screen and (min-width:60em) and (max-width:76.1875em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem transparent;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:rgba(0,0,0,.26);border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:hsla(0,0%,100%,.12)}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem rgba(0,0,0,.07);color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:transparent;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.9375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon,[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:var(--md-default-fg-color--light)}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>*{margin-left:.2rem}[dir=rtl] .md-search__options>*{margin-right:.2rem}.md-search__options>*{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>*{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=ltr] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.9375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:is(:focus,:hover){background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more summary{color:var(--md-typeset-a-color);cursor:pointer;display:block;font-size:.64rem;outline:none;padding:.75em .8rem;scroll-snap-align:start;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more summary{padding-left:2.2rem}[dir=rtl] .md-search-result__more summary{padding-right:2.2rem}}.md-search-result__more summary:is(:focus,:hover){background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more summary::-webkit-details-marker,.md-search-result__more summary::marker{display:none}.md-search-result__more summary~*>*{opacity:.65}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}.md-search-result__article--document .md-search-result__title{font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.9375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentColor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result__title{font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result__teaser{-webkit-box-orient:vertical;-webkit-line-clamp:2;color:var(--md-default-fg-color--light);display:-webkit-box;font-size:.64rem;line-height:1.6;margin:.5em 0;max-height:2rem;overflow:hidden;text-overflow:ellipsis}@media screen and (max-width:44.9375em){.md-search-result__teaser{-webkit-line-clamp:3;max-height:3rem}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-search-result__teaser{-webkit-line-clamp:3;max-height:3rem}}.md-search-result__teaser mark{background-color:transparent;text-decoration:underline}.md-search-result__terms{font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:transparent;color:var(--md-accent-fg-color)}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:is(:focus-within,:hover) .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid transparent;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid transparent;border-right:.2rem solid transparent;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.1875em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin}.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@media screen and (max-width:76.1875em){.md-overlay{background-color:rgba(0,0,0,.54);height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@-webkit-keyframes facts{0%{height:0}to{height:.65rem}}@keyframes facts{0%{height:0}to{height:.65rem}}@-webkit-keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{font-size:.55rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0}[data-md-state=done] .md-source__facts{-webkit-animation:facts .25s ease-in;animation:facts .25s ease-in}.md-source__fact{display:inline-block}[data-md-state=done] .md-source__fact{-webkit-animation:fact .4s ease-out;animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentColor;content:"";display:inline-block;height:.6rem;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}[dir=ltr] .md-source__fact:nth-child(1n+2):before{margin-left:.4rem}[dir=rtl] .md-source__fact:nth-child(1n+2):before{margin-right:.4rem}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);overflow:auto;width:100%}@media print{.md-tabs{display:none}}@media screen and (max-width:76.1875em){.md-tabs{display:none}}.md-tabs[data-md-state=hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;list-style:none;margin:0;padding:0;white-space:nowrap}.md-tabs__item{display:inline-block;height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link--active,.md-tabs__link:is(:focus,:hover){color:inherit;opacity:1}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[data-md-state=hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}@-webkit-keyframes pulse{0%{box-shadow:0 0 0 0 var(--md-default-fg-color--lightest)}75%{box-shadow:0 0 0 .625em transparent}to{box-shadow:0 0 0 0 transparent}}@keyframes pulse{0%{box-shadow:0 0 0 0 var(--md-default-fg-color--lightest)}75%{box-shadow:0 0 0 .625em transparent}to{box-shadow:0 0 0 0 transparent}}:root{--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),(100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem));max-height:0;max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,max-height 0ms .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}:focus-within>.md-tooltip{max-height:1000%;opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height .25s,z-index 0ms}.focus-visible>.md-tooltip{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{outline:none;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}.md-annotation:not([hidden]){display:inline-block}.md-annotation:focus-within>*{z-index:2}.md-annotation__inner{font-family:var(--md-text-font-family);top:calc(var(--md-tooltip-y) + 1.2ch)}:not(:focus-within)>.md-annotation__inner{pointer-events:none;-webkit-user-select:none;user-select:none}.md-annotation__index{color:#fff;cursor:pointer;margin:0 1ch;position:relative;transition:z-index .25s;-webkit-user-select:none;user-select:none;z-index:0}.md-annotation__index:after{-webkit-animation:pulse 2s infinite;animation:pulse 2s infinite;background-color:var(--md-default-fg-color--lighter);border-radius:2ch;content:"";height:2.2ch;left:-.126em;margin:0 -.4ch;padding:0 .4ch;position:absolute;top:.025em;transition:color .25s,background-color .25s;width:max(2.2ch,100% + 1.2ch);z-index:-1}@media (prefers-reduced-motion){.md-annotation__index:after{-webkit-animation:none;animation:none}}:is(:focus-within,:hover)>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}:focus-within>.md-annotation__index:after{-webkit-animation:none;animation:none;transition:color .25s,background-color .25s}.md-annotation__index [data-md-annotation-id]:before{content:attr(data-md-annotation-id);display:inline-block;transition:transform .4s cubic-bezier(.1,.7,.1,1)}@media not print{.md-annotation__index [data-md-annotation-id]:before{content:"+"}:focus-within>.md-annotation__index [data-md-annotation-id]:before{transform:rotate(45deg)}}:is(:focus-within,:hover)>.md-annotation__index{color:var(--md-accent-bg-color)}:focus-within>.md-annotation__index{-webkit-animation:none;animation:none;transition:none}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[data-md-state=hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[data-md-state=hidden]{transform:translate(50%,.2rem)}.md-top:is(:focus,:hover){background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@-webkit-keyframes hoverfix{0%{pointer-events:none}}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentColor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:1}.md-version:is(:focus-within,:hover) .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (pointer:coarse){.md-version:hover .md-version__list{-webkit-animation:hoverfix .25s forwards;animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{-webkit-animation:none;animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,')}[dir=ltr] .md-typeset :is(.admonition,details){border-left-width:.2rem}[dir=rtl] .md-typeset :is(.admonition,details){border-right-width:.2rem}.md-typeset :is(.admonition,details){background-color:var(--md-admonition-bg-color);border:0 solid #448aff;border-radius:.1rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid}@media print{.md-typeset :is(.admonition,details){box-shadow:none}}.md-typeset :is(.admonition,details)>*{box-sizing:border-box}.md-typeset :is(.admonition,details) :is(.admonition,details){margin-bottom:1em;margin-top:1em}.md-typeset :is(.admonition,details) .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset :is(.admonition,details) .md-typeset__table{padding:0 .6rem}.md-typeset :is(.admonition,details)>.tabbed-set:only-child{margin-top:0}html .md-typeset :is(.admonition,details)>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){margin-left:-.8rem;margin-right:-.6rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){margin-left:-.6rem;margin-right:-.8rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){border-left-width:.2rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){border-right-width:.2rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){border-top-left-radius:.1rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){border-top-right-radius:.1rem}.md-typeset :is(.admonition-title,summary){background-color:rgba(68,138,255,.1);border:0 solid #448aff;font-weight:700;margin-bottom:0;margin-top:0;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset :is(.admonition-title,summary):last-child{margin-bottom:0}[dir=ltr] .md-typeset :is(.admonition-title,summary):before{left:.6rem}[dir=rtl] .md-typeset :is(.admonition-title,summary):before{right:.6rem}.md-typeset :is(.admonition-title,summary):before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset :is(.admonition,details):is(.note){border-color:#448aff}.md-typeset :is(.note)>:is(.admonition-title,summary){background-color:rgba(68,138,255,.1);border-color:#448aff}.md-typeset :is(.note)>:is(.admonition-title,summary):before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.abstract,.summary,.tldr){border-color:#00b0ff}.md-typeset :is(.abstract,.summary,.tldr)>:is(.admonition-title,summary){background-color:rgba(0,176,255,.1);border-color:#00b0ff}.md-typeset :is(.abstract,.summary,.tldr)>:is(.admonition-title,summary):before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.info,.todo){border-color:#00b8d4}.md-typeset :is(.info,.todo)>:is(.admonition-title,summary){background-color:rgba(0,184,212,.1);border-color:#00b8d4}.md-typeset :is(.info,.todo)>:is(.admonition-title,summary):before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.tip,.hint,.important){border-color:#00bfa5}.md-typeset :is(.tip,.hint,.important)>:is(.admonition-title,summary){background-color:rgba(0,191,165,.1);border-color:#00bfa5}.md-typeset :is(.tip,.hint,.important)>:is(.admonition-title,summary):before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.success,.check,.done){border-color:#00c853}.md-typeset :is(.success,.check,.done)>:is(.admonition-title,summary){background-color:rgba(0,200,83,.1);border-color:#00c853}.md-typeset :is(.success,.check,.done)>:is(.admonition-title,summary):before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.question,.help,.faq){border-color:#64dd17}.md-typeset :is(.question,.help,.faq)>:is(.admonition-title,summary){background-color:rgba(100,221,23,.1);border-color:#64dd17}.md-typeset :is(.question,.help,.faq)>:is(.admonition-title,summary):before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.warning,.caution,.attention){border-color:#ff9100}.md-typeset :is(.warning,.caution,.attention)>:is(.admonition-title,summary){background-color:rgba(255,145,0,.1);border-color:#ff9100}.md-typeset :is(.warning,.caution,.attention)>:is(.admonition-title,summary):before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.failure,.fail,.missing){border-color:#ff5252}.md-typeset :is(.failure,.fail,.missing)>:is(.admonition-title,summary){background-color:rgba(255,82,82,.1);border-color:#ff5252}.md-typeset :is(.failure,.fail,.missing)>:is(.admonition-title,summary):before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.danger,.error){border-color:#ff1744}.md-typeset :is(.danger,.error)>:is(.admonition-title,summary){background-color:rgba(255,23,68,.1);border-color:#ff1744}.md-typeset :is(.danger,.error)>:is(.admonition-title,summary):before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.bug){border-color:#f50057}.md-typeset :is(.bug)>:is(.admonition-title,summary){background-color:rgba(245,0,87,.1);border-color:#f50057}.md-typeset :is(.bug)>:is(.admonition-title,summary):before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.example){border-color:#7c4dff}.md-typeset :is(.example)>:is(.admonition-title,summary){background-color:rgba(124,77,255,.1);border-color:#7c4dff}.md-typeset :is(.example)>:is(.admonition-title,summary):before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}.md-typeset :is(.admonition,details):is(.quote,.cite){border-color:#9e9e9e}.md-typeset :is(.quote,.cite)>:is(.admonition-title,summary){background-color:hsla(0,0%,62%,.1);border-color:#9e9e9e}.md-typeset :is(.quote,.cite)>:is(.admonition-title,summary):before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:is(:hover,:target) .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentColor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :is(:hover,:target)>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:is(:focus,:hover),.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset :is(h1,h2,h3):target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.9375em){.md-typeset div.arithmatex{margin:0 -.8rem}}.md-typeset div.arithmatex>*{margin:1em auto!important;padding:0 .8rem;touch-action:auto;width:-webkit-min-content;width:min-content}.md-typeset :is(del,ins,.comment).critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=ltr] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentColor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::-webkit-details-marker,.md-typeset summary::marker{display:none}.md-typeset :is(.emojione,.twemoji,.gemoji){display:inline-flex;height:1.125em;vertical-align:text-top}.md-typeset :is(.emojione,.twemoji,.gemoji) svg{fill:currentColor;max-height:100%;width:1.125em}.highlight :is(.o,.ow){color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight :is(.cpf,.l,.s,.sb,.sc,.s2,.si,.s1,.ss){color:var(--md-code-hl-string-color)}.highlight :is(.cp,.se,.sh,.sr,.sx){color:var(--md-code-hl-special-color)}.highlight :is(.m,.mb,.mf,.mh,.mi,.il,.mo){color:var(--md-code-hl-number-color)}.highlight :is(.k,.kd,.kn,.kp,.kr,.kt){color:var(--md-code-hl-keyword-color)}.highlight :is(.kc,.n){color:var(--md-code-hl-name-color)}.highlight :is(.no,.nb,.bp){color:var(--md-code-hl-constant-color)}.highlight :is(.nc,.ne,.nf,.nn){color:var(--md-code-hl-function-color)}.highlight :is(.nd,.ni,.nl,.nt){color:var(--md-code-hl-keyword-color)}.highlight :is(.c,.cm,.c1,.ch,.cs,.sd){color:var(--md-code-hl-comment-color)}.highlight :is(.na,.nv,.vc,.vg,.vi){color:var(--md-code-hl-variable-color)}.highlight :is(.ge,.gr,.gh,.go,.gp,.gs,.gu,.gt){color:var(--md-code-hl-generic-color)}.highlight :is(.gd,.gi){border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color);display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:block;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable :is(tbody,td){display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable code{border-bottom-right-radius:.1rem;border-top-right-radius:.1rem}@media screen and (max-width:44.9375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight .hll{margin:0 -.8rem;padding:0 .8rem}.md-content__inner>.highlight code{border-radius:0}.md-content__inner>.highlighttable{border-radius:0;margin:1em -.8rem}.md-content__inner>.highlighttable .hll{margin:0 -.8rem;padding:0 .8rem}}.md-typeset .keys kbd:is(:before,:after){-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-left-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-left-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-right-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-right-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-left-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-right-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scroll-snap-type:x proximity;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-accent-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid transparent;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-snap-align:start;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-accent-fg-color)}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child pre,.md-typeset .tabbed-block>.highlighttable:first-child,.md-typeset .tabbed-block>pre:first-child{margin:0}[dir=ltr] +.md-typeset .tabbed-block>.highlight:first-child pre>code,[dir=ltr] +.md-typeset .tabbed-block>.highlighttable:first-child>code,[dir=ltr] .md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0}[dir=rtl] +.md-typeset .tabbed-block>.highlight:first-child pre>code,[dir=rtl] +.md-typeset .tabbed-block>.highlighttable:first-child>code,[dir=rtl] .md-typeset .tabbed-block>pre:first-child>code{border-top-right-radius:0}[dir=ltr] +.md-typeset .tabbed-block>.highlight:first-child pre>code,[dir=ltr] +.md-typeset .tabbed-block>.highlighttable:first-child>code,[dir=ltr] .md-typeset .tabbed-block>pre:first-child>code{border-top-right-radius:0}[dir=rtl] +.md-typeset .tabbed-block>.highlight:first-child pre>code,[dir=rtl] +.md-typeset .tabbed-block>.highlighttable:first-child>code,[dir=rtl] .md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0}.md-typeset .tabbed-block>.tabbed-set{margin:0}@media screen and (max-width:44.9375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20){color:var(--md-accent-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20){border-color:var(--md-accent-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9),.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20){background-color:var(--md-accent-fg-color--transparent)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9),.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{float:left;margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}.md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}} \ No newline at end of file diff --git a/3.25.0/assets/stylesheets/main.bb3983ee.min.css.map b/3.25.0/assets/stylesheets/main.bb3983ee.min.css.map new file mode 100644 index 0000000000..4c4f48fd66 --- /dev/null +++ b/3.25.0/assets/stylesheets/main.bb3983ee.min.css.map @@ -0,0 +1 @@ +{"version":3,"sources":["src/assets/stylesheets/main/extensions/pymdownx/_keys.scss","../../../src/assets/stylesheets/main.scss","src/assets/stylesheets/main/_resets.scss","src/assets/stylesheets/main/_colors.scss","src/assets/stylesheets/main/_icons.scss","src/assets/stylesheets/main/_typeset.scss","src/assets/stylesheets/utilities/_break.scss","src/assets/stylesheets/main/layout/_banner.scss","src/assets/stylesheets/main/layout/_base.scss","src/assets/stylesheets/main/layout/_clipboard.scss","src/assets/stylesheets/main/layout/_content.scss","src/assets/stylesheets/main/layout/_dialog.scss","src/assets/stylesheets/main/layout/_footer.scss","src/assets/stylesheets/main/layout/_form.scss","src/assets/stylesheets/main/layout/_header.scss","src/assets/stylesheets/main/layout/_nav.scss","src/assets/stylesheets/main/layout/_search.scss","src/assets/stylesheets/main/layout/_select.scss","src/assets/stylesheets/main/layout/_sidebar.scss","src/assets/stylesheets/main/layout/_source.scss","src/assets/stylesheets/main/layout/_tabs.scss","src/assets/stylesheets/main/layout/_tooltip.scss","src/assets/stylesheets/main/layout/_top.scss","src/assets/stylesheets/main/layout/_version.scss","src/assets/stylesheets/main/extensions/markdown/_admonition.scss","node_modules/material-design-color/material-color.scss","src/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/assets/stylesheets/main/extensions/markdown/_toc.scss","src/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/assets/stylesheets/main/_modifiers.scss"],"names":[],"mappings":"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BACE,UhC+5GJ,CgC55GI,aAJF,4BAKI,gBhC+5GJ,CACF,CgC35GE,0BACE,YhC65GJ,CgC15GI,aAJF,0BAKI,ahC65GJ,CgCz5GM,sCACE,OhC25GR,CgC55GM,uCACE,OhC85GR,CgC/5GM,uCACE,OhCi6GR,CgCl6GM,uCACE,OhCo6GR,CgCr6GM,uCACE,OhCu6GR,CgCx6GM,uCACE,OhC06GR,CgC36GM,uCACE,OhC66GR,CgC96GM,uCACE,OhCg7GR,CgCj7GM,uCACE,OhCm7GR,CgCp7GM,wCACE,QhCs7GR,CgCv7GM,wCACE,QhCy7GR,CgC17GM,wCACE,QhC47GR,CgC77GM,wCACE,QhC+7GR,CgCh8GM,wCACE,QhCk8GR,CgCn8GM,wCACE,QhCq8GR,CgCt8GM,wCACE,QhCw8GR,CgCz8GM,wCACE,QhC28GR,CgC58GM,wCACE,QhC88GR,CgC/8GM,wCACE,QhCi9GR,CgCl9GM,wCACE,QhCo9GR,CACF,CgC98GI,qJAGE,QhCg9GN,CgC78GM;;oHACE,wBhCk9GR,CgCn9GM;;oHACE,yBhCk9GR,CgCn9GM;;oHAEE,yBhCi9GR,CgCn9GM;;oHAEE,wBhCi9GR,CgC58GI,sCACE,QhC88GN,CK/7GI,wC2BFF,wDAGE,kBhCs8GF,CgCz8GA,wDAGE,mBhCs8GF,CgCz8GA,8CAEE,eAAA,CADA,eAAA,CAGA,iChCq8GF,CgCj8GE,8DACE,mBhCo8GJ,CgCr8GE,8DACE,kBhCo8GJ,CgCr8GE,oDAEE,UhCm8GJ,CACF,CgCv7GE,cAHF,olDAII,+BhC07GF,CgCv7GE,g8GACE,sChCy7GJ,CACF,CgCp7GA,4sDACE,uDhCu7GF,CgCn7GA,wmDACE,ahCs7GF,CiCrpHA,MACE,mVAAA,CAEA,4VjCypHF,CiC/oHE,4BAEE,oBAAA,CADA,iBjCmpHJ,CiC9oHI,sDAGE,SjCgpHN,CiCnpHI,sDAGE,UjCgpHN,CiCnpHI,4CACE,iBAAA,CACA,SjCipHN,CiC3oHE,+CAEE,SAAA,CADA,UjC8oHJ,CiCzoHE,kDAGE,WjCkpHJ,CiCrpHE,kDAGE,YjCkpHJ,CiCrpHE,wCAME,qDAAA,CAIA,UAAA,CALA,aAAA,CAEA,0CAAA,CAAA,kCAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CARA,iBAAA,CACA,SAAA,CAEA,YjCipHJ,CiCvoHE,gEACE,wBT0Wa,CSzWb,mDAAA,CAAA,2CjCyoHJ,CKphHI,mC6BhKA,8BAIE,kBlCyrHJ,CkC7rHE,8BAIE,iBlCyrHJ,CkC7rHE,oBACE,UAAA,CAIA,mBAAA,CAFA,YAAA,CADA,alC2rHJ,CkCrrHI,8BACE,WlCurHN,CkCnrHI,kCAEE,iBAAA,CAAA,clCqrHN,CkCvrHI,kCAEE,aAAA,CAAA,kBlCqrHN,CkCvrHI,wBACE,WlCsrHN,CkClrHM,kCACE,UlCorHR,CACF","file":"main.css"} \ No newline at end of file diff --git a/3.25.0/assets/stylesheets/palette.e6a45f82.min.css b/3.25.0/assets/stylesheets/palette.e6a45f82.min.css new file mode 100644 index 0000000000..9d16769c2a --- /dev/null +++ b/3.25.0/assets/stylesheets/palette.e6a45f82.min.css @@ -0,0 +1 @@ +[data-md-color-accent=red]{--md-accent-fg-color:#ff1947;--md-accent-fg-color--transparent:rgba(255,25,71,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=pink]{--md-accent-fg-color:#f50056;--md-accent-fg-color--transparent:rgba(245,0,86,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=purple]{--md-accent-fg-color:#df41fb;--md-accent-fg-color--transparent:rgba(223,65,251,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=deep-purple]{--md-accent-fg-color:#7c4dff;--md-accent-fg-color--transparent:rgba(124,77,255,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=indigo]{--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:rgba(82,108,254,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=blue]{--md-accent-fg-color:#4287ff;--md-accent-fg-color--transparent:rgba(66,135,255,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=light-blue]{--md-accent-fg-color:#0091eb;--md-accent-fg-color--transparent:rgba(0,145,235,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=cyan]{--md-accent-fg-color:#00bad6;--md-accent-fg-color--transparent:rgba(0,186,214,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=teal]{--md-accent-fg-color:#00bda4;--md-accent-fg-color--transparent:rgba(0,189,164,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=green]{--md-accent-fg-color:#00c753;--md-accent-fg-color--transparent:rgba(0,199,83,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=light-green]{--md-accent-fg-color:#63de17;--md-accent-fg-color--transparent:rgba(99,222,23,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=lime]{--md-accent-fg-color:#b0eb00;--md-accent-fg-color--transparent:rgba(176,235,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=yellow]{--md-accent-fg-color:#ffd500;--md-accent-fg-color--transparent:rgba(255,213,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=amber]{--md-accent-fg-color:#fa0;--md-accent-fg-color--transparent:rgba(255,170,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=orange]{--md-accent-fg-color:#ff9100;--md-accent-fg-color--transparent:rgba(255,145,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=deep-orange]{--md-accent-fg-color:#ff6e42;--md-accent-fg-color--transparent:rgba(255,110,66,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=red]{--md-primary-fg-color:#ef5552;--md-primary-fg-color--light:#e57171;--md-primary-fg-color--dark:#e53734;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=pink]{--md-primary-fg-color:#e92063;--md-primary-fg-color--light:#ec417a;--md-primary-fg-color--dark:#c3185d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=purple]{--md-primary-fg-color:#ab47bd;--md-primary-fg-color--light:#bb69c9;--md-primary-fg-color--dark:#8c24a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=deep-purple]{--md-primary-fg-color:#7e56c2;--md-primary-fg-color--light:#9574cd;--md-primary-fg-color--dark:#673ab6;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=indigo]{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=blue]{--md-primary-fg-color:#2094f3;--md-primary-fg-color--light:#42a5f5;--md-primary-fg-color--dark:#1975d2;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=light-blue]{--md-primary-fg-color:#02a6f2;--md-primary-fg-color--light:#28b5f6;--md-primary-fg-color--dark:#0287cf;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=cyan]{--md-primary-fg-color:#00bdd6;--md-primary-fg-color--light:#25c5da;--md-primary-fg-color--dark:#0097a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=teal]{--md-primary-fg-color:#009485;--md-primary-fg-color--light:#26a699;--md-primary-fg-color--dark:#007a6c;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=green]{--md-primary-fg-color:#4cae4f;--md-primary-fg-color--light:#68bb6c;--md-primary-fg-color--dark:#398e3d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=light-green]{--md-primary-fg-color:#8bc34b;--md-primary-fg-color--light:#9ccc66;--md-primary-fg-color--dark:#689f38;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=lime]{--md-primary-fg-color:#cbdc38;--md-primary-fg-color--light:#d3e156;--md-primary-fg-color--dark:#b0b52c;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=yellow]{--md-primary-fg-color:#ffec3d;--md-primary-fg-color--light:#ffee57;--md-primary-fg-color--dark:#fbc02d;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=amber]{--md-primary-fg-color:#ffc105;--md-primary-fg-color--light:#ffc929;--md-primary-fg-color--dark:#ffa200;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=orange]{--md-primary-fg-color:#ffa724;--md-primary-fg-color--light:#ffa724;--md-primary-fg-color--dark:#fa8900;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=deep-orange]{--md-primary-fg-color:#ff6e42;--md-primary-fg-color--light:#ff8a66;--md-primary-fg-color--dark:#f4511f;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=brown]{--md-primary-fg-color:#795649;--md-primary-fg-color--light:#8d6e62;--md-primary-fg-color--dark:#5d4037;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=grey]{--md-primary-fg-color:#757575;--md-primary-fg-color--light:#9e9e9e;--md-primary-fg-color--dark:#616161;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=blue-grey]{--md-primary-fg-color:#546d78;--md-primary-fg-color--light:#607c8a;--md-primary-fg-color--dark:#455a63;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=white]{--md-primary-fg-color:#fff;--md-primary-fg-color--light:hsla(0,0%,100%,.7);--md-primary-fg-color--dark:rgba(0,0,0,.07);--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54);--md-typeset-a-color:#4051b5}@media screen and (min-width:60em){[data-md-color-primary=white] .md-search__form{background-color:rgba(0,0,0,.07)}[data-md-color-primary=white] .md-search__form:hover{background-color:rgba(0,0,0,.32)}[data-md-color-primary=white] .md-search__input+.md-search__icon{color:rgba(0,0,0,.87)}}@media screen and (min-width:76.25em){[data-md-color-primary=white] .md-tabs{border-bottom:.05rem solid rgba(0,0,0,.07)}}[data-md-color-primary=black]{--md-primary-fg-color:#000;--md-primary-fg-color--light:rgba(0,0,0,.54);--md-primary-fg-color--dark:#000;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=black] .md-header{background-color:#000}@media screen and (max-width:59.9375em){[data-md-color-primary=black] .md-nav__source{background-color:rgba(0,0,0,.87)}}@media screen and (min-width:60em){[data-md-color-primary=black] .md-search__form{background-color:hsla(0,0%,100%,.12)}[data-md-color-primary=black] .md-search__form:hover{background-color:hsla(0,0%,100%,.3)}}@media screen and (max-width:76.1875em){html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]{background-color:#000}}@media screen and (min-width:76.25em){[data-md-color-primary=black] .md-tabs{background-color:#000}}@media screen{[data-md-color-scheme=slate]{--md-hue:232;--md-default-fg-color:hsla(var(--md-hue),75%,95%,1);--md-default-fg-color--light:hsla(var(--md-hue),75%,90%,0.62);--md-default-fg-color--lighter:hsla(var(--md-hue),75%,90%,0.32);--md-default-fg-color--lightest:hsla(var(--md-hue),75%,90%,0.12);--md-default-bg-color:hsla(var(--md-hue),15%,21%,1);--md-default-bg-color--light:hsla(var(--md-hue),15%,21%,0.54);--md-default-bg-color--lighter:hsla(var(--md-hue),15%,21%,0.26);--md-default-bg-color--lightest:hsla(var(--md-hue),15%,21%,0.07);--md-code-fg-color:hsla(var(--md-hue),18%,86%,1);--md-code-bg-color:hsla(var(--md-hue),15%,15%,1);--md-code-hl-color:rgba(66,135,255,.15);--md-code-hl-number-color:#e6695b;--md-code-hl-special-color:#f06090;--md-code-hl-function-color:#c973d9;--md-code-hl-constant-color:#9383e2;--md-code-hl-keyword-color:#6791e0;--md-code-hl-string-color:#2fb170;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-mark-color:rgba(66,135,255,.3);--md-typeset-kbd-color:hsla(var(--md-hue),15%,94%,0.12);--md-typeset-kbd-accent-color:hsla(var(--md-hue),15%,94%,0.2);--md-typeset-kbd-border-color:hsla(var(--md-hue),15%,14%,1);--md-typeset-table-color:hsla(var(--md-hue),75%,95%,0.12);--md-admonition-bg-color:hsla(var(--md-hue),0%,100%,0.025);--md-footer-bg-color:hsla(var(--md-hue),15%,12%,0.87);--md-footer-bg-color--dark:hsla(var(--md-hue),15%,10%,1)}[data-md-color-scheme=slate][data-md-color-primary=black],[data-md-color-scheme=slate][data-md-color-primary=white]{--md-typeset-a-color:#5d6cc0}[data-md-color-scheme=slate] img[src$="#only-light"]{display:none}[data-md-color-scheme=slate] img[src$="#only-dark"]{display:initial}} \ No newline at end of file diff --git a/3.25.0/assets/stylesheets/palette.e6a45f82.min.css.map b/3.25.0/assets/stylesheets/palette.e6a45f82.min.css.map new file mode 100644 index 0000000000..b33c518da1 --- /dev/null +++ b/3.25.0/assets/stylesheets/palette.e6a45f82.min.css.map @@ -0,0 +1 @@ +{"version":3,"sources":["src/assets/stylesheets/palette/_accent.scss","../../../src/assets/stylesheets/palette.scss","src/assets/stylesheets/palette/_primary.scss","src/assets/stylesheets/utilities/_break.scss","src/assets/stylesheets/palette/_scheme.scss"],"names":[],"mappings":"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","file":"palette.css"} \ No newline at end of file diff --git a/3.25.0/camel/camel-processor/index.html b/3.25.0/camel/camel-processor/index.html new file mode 100644 index 0000000000..052eb64532 --- /dev/null +++ b/3.25.0/camel/camel-processor/index.html @@ -0,0 +1,1641 @@ + + + + + + + + + + + + + + + + + + Implementing Camel processor - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    The processor pattern using Camel

    +

    Using the processor pattern, you can consume on a channel using a Camel +component, and produce on a channel using another Camel component. In +that case, the headers present in the incoming metadata will be +forwarded in the outgoing metadata.

    +

    Example

    +

    Let’s imagine you want to read messages from a Nats subject, process it +and produce a message on a Kafka topic.

    +

    1
+2
+3
+4
+5
+6
+7
    mp.messaging.incoming.mynatssubject.connector=smallrye-camel # <1>
+mp.messaging.incoming.mynatssubject.endpoint-uri=nats:mynatssubject # <2>
+mp.messaging.outgoing.mykafkatopic.connector=smallrye-camel # <3>
+mp.messaging.outgoing.mykafkatopic.endpoint-uri=kafka:mykafkatopic# <4>
+
+camel.component.nats.servers=127.0.0.1:5555 # <5>
+camel.component.kafka.brokers=127.0.0.1:9092 # <6>
+
    +
    +1. Sets the connector for the mynatssubject channel +2. Configures the endpoint-uri for nats subject +3. Sets the connector for the mykafkatopic channel +4. Configures the endpoint-uri for the kafka topic +5. Sets the URL of the nats server to use +6. Sets the URL of a kafka broker to use

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
    package camel.processor;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+@ApplicationScoped
+public class CamelProcessor {
+
+    @Incoming("mynatssubject")
+    @Outgoing("mykafkatopic")
+    public byte[] process(byte[] message) {
+        // do some logic
+        return message;
+    }
+
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/camel/camel/index.html b/3.25.0/camel/camel/index.html new file mode 100644 index 0000000000..4ebcf421bf --- /dev/null +++ b/3.25.0/camel/camel/index.html @@ -0,0 +1,1650 @@ + + + + + + + + + + + + + + + + + + Apache Camel Connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Apache Camel Connector

    +

    The Camel connector adds support for Apache Camel to Reactive Messaging.

    +

    Camel is an open source integration +framework let you integrate various systems consuming or producing data. +Camel implements the Enterprise Integration Patterns and provides +several hundred of components used to access databases, message queues, +APIs or basically anything under the +sun.

    +

    Introduction

    +

    Camel is not a messaging broker. But, it allows your Reactive Messaging +application to retrieve data from almost anything and send data to +almost anything.

    +

    So if you want to send Reactive Messaging Message to Telegram or +retrieve data from Salesforce or SAP, this is the connector you need.

    +

    One of the Camel cornerstone is the endpoint and its uri encoding +the connection to an external system. For example, +file:orders/?delete=true&charset=utf-8 instructs Camel to read the +files from the orders directory. URI format and parameters are listed +on the component documentation, such as the File +component.

    +

    Using the camel connector

    +

    To you the camel Connector, add the following dependency to your +project:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-camel</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
    +
    +

    You will also need the dependency of the Camel component you are using. +For example, if you want to process files, you would need to add the +Camel File Component artifact:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>org.apache.camel</groupId>
+  <artifactId>camel-file</artifactId>
+  <version>3.20.1</version>
+</dependency>
+
    +
    +

    The connector name is: smallrye-camel.

    +

    So, to indicate that a channel is managed by this connector you need:

    +
    1
+2
+3
+4
+5
    # Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-camel
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-camel
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/camel/receiving-messages-from-camel/index.html b/3.25.0/camel/receiving-messages-from-camel/index.html new file mode 100644 index 0000000000..b17aedf719 --- /dev/null +++ b/3.25.0/camel/receiving-messages-from-camel/index.html @@ -0,0 +1,1854 @@ + + + + + + + + + + + + + + + + + + Receiving messages from Camel - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Retrieving data using Camel

    +

    Camel provides many components. To keep this documentation focused on +the integration with Camel, we use the File +component. +This component let use read files from a directory. So the connector +configured with this component creates a Message for each file located +in the directory. As soon as a file is dropped in the directory, a new +Message is created.

    +

    Example

    +

    Let’s imagine you want to read the files from the orders directory and +send them to the files channel. Configuring the Camel connector to +gets the file from this directory only requires 2 properties:

    +

    1
+2
    mp.messaging.incoming.files.connector=smallrye-camel # <1>
+mp.messaging.incoming.files.endpoint-uri=file:orders/?delete=true&charset=utf-8 # <2>
+
    +
    +1. Sets the connector for the files channel +2. Configures the endpoint-uri

    +

    Then, your application receives Message<GenericFile<File>>.

    +
    +

    Note

    +

    The Camel File component produces +org.apache.camel.component.file.GenericFile instances. You can +retrieve the actual File using getFile().

    +
    +

    You can consume the payload directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
    package camel.inbound;
+
+import java.io.File;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.camel.component.file.GenericFile;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class CamelFileConsumer {
+
+    @Incoming("files")
+    public void consume(GenericFile<File> gf) {
+        File file = gf.getFile();
+        // process the file
+
+    }
+
+}
+
    +
    +

    You can also retrieve the Message<GenericFile<File>>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
    package camel.inbound;
+
+import java.io.File;
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.camel.component.file.GenericFile;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class CamelFileMessageConsumer {
+
+    @Incoming("files")
+    public CompletionStage<Void> consume(Message<GenericFile<File>> msg) {
+        File file = msg.getPayload().getFile();
+        // process the file
+
+        return msg.ack();
+    }
+
+}
+
    +
    +

    Deserialization

    +

    Each Camel component is producing specific objects. As we have seen, the +File component produces GenericFile.

    +

    Refer to the component documentation to check which type is produced.

    +

    Inbound Metadata

    +

    Messages coming from Camel contains an instance of +IncomingExchangeMetadata +in the metadata.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
    package camel.inbound;
+
+import java.io.File;
+import java.util.Optional;
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.camel.Exchange;
+import org.apache.camel.component.file.GenericFile;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+import io.smallrye.reactive.messaging.camel.IncomingExchangeMetadata;
+
+@ApplicationScoped
+public class IncomingCamelMetadataExample {
+
+    @Incoming("files")
+    public CompletionStage<Void> consume(Message<GenericFile<File>> msg) {
+        Optional<IncomingExchangeMetadata> metadata = msg.getMetadata(IncomingExchangeMetadata.class);
+        if (metadata.isPresent()) {
+            // Retrieve the camel exchange:
+            Exchange exchange = metadata.get().getExchange();
+        }
+        return msg.ack();
+    }
+
+}
+
    +
    +

    This object lets you retrieve the Camel Exchange.

    +

    Failure Management

    +

    If a message produced from a Camel exchange is nacked, a failure +strategy is applied. The Camel connector supports 3 strategies:

    +
      +
    • fail - fail the application, no more MQTT messages will be + processed. (default) The offset of the record that has not been + processed correctly is not committed.
      • +
    • ignore - the failure is logged, but the processing continue.
      • +
    +

    In both cases, the exchange is marked as rollback only and the nack +reason is attached to the exchange.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    endpoint-uriThe URI of the Camel endpoint (read from or written to)stringtrue
    failure-strategySpecify the failure strategy to apply when a message produced from a Camel exchange is nacked. Values can be fail (default) or ignorestringfalsefail
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/camel/sending-messages-to-camel/index.html b/3.25.0/camel/sending-messages-to-camel/index.html new file mode 100644 index 0000000000..e599c39bbb --- /dev/null +++ b/3.25.0/camel/sending-messages-to-camel/index.html @@ -0,0 +1,1817 @@ + + + + + + + + + + + + + + + + + + Sending messages to Camel - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Sending data with Camel

    +

    You can use the Camel connector to send data to almost any type of +system.

    +

    To keep this document focused on the Camel connector, we use the Camel +File component. However, the connector can be used with any Camel +component.

    +

    Example

    +

    Let’s imagine you want to write generated prices into files. Configure +your application to write the messages from the prices channel into a +files as follows:

    +

    1
+2
    mp.messaging.outgoing.prices.connector=smallrye-camel # <1>
+mp.messaging.outgoing.prices.endpoint-uri=file:prices/?fileName=${date:now:yyyyMMddssSS}.txt&charset=utf-8 # <2>
+
    +
    +1. Sets the connector for the prices channel +2. Configure the endpoint-uri to write into files in the prices + directory

    +
    +

    Important

    +

    Depending on your implementation of MicroProfile Reactive Messaging, the +$ may need to be escaped as follows: $${...}

    +
    +

    Then, your application must send Message<String> to the prices +channel. It can use String payloads as in the following snippet:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
    package camel.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class CamelPriceProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<String> generate() {
+        // Build an infinite stream of random prices
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .onOverflow().drop()
+                .map(x -> random.nextDouble())
+                .map(p -> Double.toString(p));
+    }
+
+}
+
    +
    +

    Or, you can send Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
    package camel.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class CamelPriceMessageProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Message<String>> generate() {
+        // Build an infinite stream of random prices
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble())
+                .map(p -> Double.toString(p))
+                .map(Message::of);
+    }
+
+}
+
    +
    +

    Serialization

    +

    The serialization is handled by the Camel component. Refer to the Camel +documentation to check which payload type is supported by the component.

    +

    Outbound Metadata

    +

    When sending Messages, you can add an instance +of OutgoingExchangeMetadata +to the message metadata. You can then influence how the outbound Camel +Exchange is created, for example by adding properties:

    +
    1
+2
+3
+4
+5
+6
    return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+        .map(x -> random.nextDouble())
+        .map(p -> Double.toString(p))
+        .map(s -> Message.of(s)
+                .addMetadata(new OutgoingExchangeMetadata()
+                        .putProperty("my-property", "my-value")));
+
    +
    +

    Acknowledgement

    +

    The incoming messages are acknowledged when the underlying Camel +exchange completes. If the exchange fails, the message is nacked.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    endpoint-uriThe URI of the Camel endpoint (read from or written to)stringtrue
    mergeWhether the connector should allow multiple upstreamsbooleanfalsefalse
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/camel/using-existing-routes/index.html b/3.25.0/camel/using-existing-routes/index.html new file mode 100644 index 0000000000..404d668a91 --- /dev/null +++ b/3.25.0/camel/using-existing-routes/index.html @@ -0,0 +1,1688 @@ + + + + + + + + + + + + + + + + + + Using existing Camel routes - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Using the Camel API

    +

    The Camel connector is based on the Reactive Streams +support +from Camel. If you have an application already using the Camel API +(routes, from...), you can integrate it with Reactive Messaging.

    +

    Getting the CamelReactiveStreamsService

    +

    Once you add the Camel connector to your application, you can retrieve +the +org.apache.camel.component.reactive.streams.api.CamelReactiveStreamsService +object:

    +
    1
+2
    @Inject
+CamelReactiveStreamsService reactiveStreamsService;
+
    +
    +

    This CamelReactiveStreamsService lets you create Publisher and +Subscriber instances from existing routes.

    +

    Using Camel Route with @Outgoing

    +

    If you have an existing Camel route, you can transform it as a +Publisher using the CamelReactiveStreamsService. Then, you can +return this Publisher from a method annotated with @Outgoing:

    +
    1
+2
+3
+4
    @Outgoing("camel")
+public Publisher<Exchange> retrieveDataFromCamelRoute() {
+    return reactiveStreamsService.from("seda:camel");
+}
+
    +
    +

    You can also use RouteBuilder:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    @ApplicationScoped
+static class MyRouteBuilder extends RouteBuilder {
+    @Inject
+    CamelReactiveStreamsService reactiveStreamsService;
+
+    @Outgoing("sink")
+    public Publisher<String> getDataFromCamelRoute() {
+        return reactiveStreamsService.fromStream("my-stream", String.class);
+    }
+
+    @Override
+    public void configure() {
+        from("seda:camel").process(
+                exchange -> exchange.getMessage().setBody(exchange.getIn().getBody(String.class).toUpperCase()))
+                .to("reactive-streams:my-stream");
+    }
+}
+
    +
    +

    Using Camel Route with @Incoming

    +

    If you have an existing Camel route, you can transform it as a +Subscriber using the CamelReactiveStreamsService. Then, you can +return this Subscriber from a method annotated with @Incoming:

    +
    1
+2
+3
+4
+5
    @Incoming("to-camel")
+public Subscriber<String> sendDataToCamelRoute() {
+    return reactiveStreamsService.subscriber("file:./target?fileName=values.txt&fileExist=append",
+            String.class);
+}
+
    +
    +

    You can also use a producer:

    +
    1
+2
+3
+4
+5
+6
+7
+8
    @Inject
+CamelContext camel;
+
+@Incoming("to-camel")
+public CompletionStage<Void> sink(String value) {
+    return camel.createProducerTemplate()
+            .asyncSendBody("file:./target?fileName=values.txt&fileExist=append", value).thenApply(x -> null);
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/acknowledgement/index.html b/3.25.0/concepts/acknowledgement/index.html new file mode 100644 index 0000000000..99d1c72f9f --- /dev/null +++ b/3.25.0/concepts/acknowledgement/index.html @@ -0,0 +1,1987 @@ + + + + + + + + + + + + + + + + + + Acknowledgement - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Acknowledgement

    +

    Acknowledgment is an essential concept in messaging. A message is +acknowledged when its processing or reception has been successful. It +allows the broker to move to the next message.

    +

    How acknowledgment is used, and the exact behavior in terms of retry and +resilience depends on the broker. For example, for Kafka, it would +commit the offset. For AMQP, it would inform the broker that the message +has been accepted.

    +

    Reactive Messaging supports acknowledgement. The default acknowledgement +depends on the method signature. Also, the acknowledgement policy can be +configured using the @Acknowledgement annotation.

    +

    Chain of acknowledgment

    +

    If we reuse this example:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    @Outgoing("source")
+public Multi<String> generate() {
+    return Multi.createFrom().items("Hello", "from", "reactive", "messaging");
+}
+
+@Incoming("source")
+@Outgoing("sink")
+public String process(String in) {
+    return in.toUpperCase();
+}
+
+@Incoming("sink")
+public void consume(String processed) {
+    System.out.println(processed);
+}
+
    +
    +

    The framework automatically acknowledges the message received from the +sink channel when the consume method returns. As a consequence, the +message received by the process method is acknowledged, and so on. In +other words, it creates a chain of acknowledgement - from the outbound +channel to the inbound channel.

    +

    When using connectors to receive and consume messages, the outbound +connector acknowledges the messages when they are dispatched +successfully to the broker. The acknowledgment chain would, as a result, +acknowledges the inbound connector, which would be able to send an +acknowledgment to the broker.

    +

    This chain of acknowledgment is automatically implemented when +processing payloads.

    +

    Acknowledgment when using Messages

    +

    When using Messages, the user controls the acknowledgment, and so the +chain is not formed automatically. It gives you more flexibility about +when and how the incoming messages are acknowledged.

    +

    If you create a Message using the with method, is copy the +acknowledgment function from the incoming message:

    +
    1
+2
+3
+4
+5
+6
+7
    @Incoming("in")
+@Outgoing("out")
+public Message<Integer> process(Message<Integer> in) {
+    // The acknowledgement is forwarded, when the consumer
+    // acknowledges the message, `in` will be acknowledged
+    return in.withPayload(in.getPayload() + 1);
+}
+
    +
    +

    To have more control over the acknowledgment, you can create a brand new +Message and pass the acknowledgment function:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
    Message<String> message = Message.of("hello", () -> {
+    // called when the consumer acknowledges the message
+
+    // return a CompletionStage completed when the
+    // acknowledgment of the created message is
+    // completed.
+    // For immediate ack use:
+    return CompletableFuture.completedFuture(null);
+
+});
+
    +
    +

    However, you may need to create the acknowledgment chain, to acknowledge +the incoming message:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
    @Incoming("in")
+@Outgoing("out")
+public Message<Integer> processAndProduceNewMessage(Message<Integer> in) {
+    // The acknowledgement is forwarded, when the consumer
+    // acknowledges the message, `in` will be acknowledged
+    return Message.of(in.getPayload() + 1,
+            () -> {
+                // Called when the consumer acknowledges the message
+                // ...
+                // Don't forget to acknowledge the incoming message:
+                return in.ack();
+            });
+}
+
    +
    +

    To trigger the acknowledgment of the incoming message, use the ack() +method. It returns a CompletionStage, receiving null as value when +the acknowledgment has completed.

    +

    Acknowledgment when using streams

    +

    When transforming streams of Message, the acknowledgment is delegated +to the user. It means that it’s up to the user to acknowledge the +incoming messages:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("in")
+@Outgoing("out")
+public Publisher<Message<String>> transform(Multi<Message<String>> stream) {
+    return stream
+            .map(message -> message.withPayload(message.getPayload().toUpperCase()));
+}
+
    +
    +

    In the previous example, we only generate a single message per incoming +message so that we can use the with method. It becomes more +sophisticated when grouping incoming messages or when each incoming +message produces multiple messages.

    +

    In the case of a stream of payloads, the default strategy acknowledges +the incoming messages before being processed by the method (regardless +of the outcome).

    +
    1
+2
+3
+4
+5
+6
+7
    @Incoming("in")
+@Outgoing("out")
+public Publisher<String> transformPayload(Multi<String> stream) {
+    return stream
+            // The incoming messages are already acknowledged
+            .map(String::toUpperCase);
+}
+
    +
    +

    Controlling acknowledgement

    +

    The Acknowledgment +annotation lets you customize the default strategy presented in the +previous sections. The @Acknowledgement annotation takes a strategy +as parameter. Reactive Messaging proposed 4 strategies:

    +
      +
    • +

      POST_PROCESSING - the acknowledgement of the incoming message is + executed once the produced message is acknowledged.

      +
      • +
    • +

      PRE_PROCESSING - the acknowledgement of the incoming message is + executed before the message is processed by the method.

      +
      • +
    • +

      MANUAL - the acknowledgement is doe by the user.

      +
      • +
    • +

      NONE - No acknowledgment is performed, neither manually or + automatically.

      +
      • +
    +

    It is recommended to use POST_PROCESSING as it guarantees that the +full processing has completed before acknowledging the incoming message. +However, sometimes it’s not possible, and this strategy is not available +if you manipulate streams of Messages or payloads.

    +

    The PRE_PROCESSING strategy can be useful to acknowledge a message +early in the process:

    +
    1
+2
+3
+4
+5
+6
+7
+8
+9
    @Incoming("in")
+@Outgoing("out")
+@Acknowledgment(Acknowledgment.Strategy.PRE_PROCESSING)
+public String process(String input) {
+    // The message wrapping the payload is already acknowledged
+    // The default would have waited the produced message to be
+    // acknowledged
+    return input.toUpperCase();
+}
+
    +
    +

    It cuts the acknowledgment chain, meaning that the rest of the +processing is not linked to the incoming message anymore. This strategy +is the default strategy when manipulating streams of payloads.

    +

    Refer to the signature list to determine +which strategies are available for a specific method signature and +what’s the default strategy.

    +

    Negative acknowledgement

    +

    Messages can also be nacked, which indicates that the message was not +processed correctly. The Message.nack method indicates failing +processing (and supply the reason), and, as for successful +acknowledgment, the nack is propagated through the chain of messages.

    +

    If the message has been produced by a connector, this connector +implements specific behavior when receiving a nack. It can fail +(default), or ignore the failing, or implement a dead-letter queue +mechanism. Refer to the connector documentation for further details +about the available strategies.

    +

    If the message is sent by an emitter using the send(P) method, the +returned CompletionStage is completed exceptionally with the nack +reason.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
    @Inject
+@Channel("data")
+Emitter<String> emitter;
+
+public void emitPayload() {
+    CompletionStage<Void> completionStage = emitter.send("hello");
+    completionStage.whenComplete((acked, nacked) -> {
+        if (nacked != null) {
+            // the processing has failed
+        }
+    });
+}
+
    +
    +

    Negative acknowledgment can be manual or automatic. If your method +handles instances of Message and the acknowledgment strategy is +MANUAL, you can nack a message explicitly. You must indicate the +reason (an exception) when calling the nack method. As for successful +acknowledgment, the nack returns a CompletionStage completed when +the nack has been processed.

    +

    If your method uses the POST_PROCESSING acknowledgment strategy, and +the method fails (either by throwing an exception or by producing a +failure), the message is automatically nacked with the caught exception:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
    @Incoming("data")
+@Outgoing("out")
+public String process(String s) {
+    if (s.equalsIgnoreCase("b")) {
+        // Throwing an exception triggers a nack
+        throw new IllegalArgumentException("b");
+    }
+
+    if (s.equalsIgnoreCase("e")) {
+        // Returning null would skip the message (it will be acked)
+        return null;
+    }
+
+    return s.toUpperCase();
+}
+
+@Incoming("data")
+@Outgoing("out")
+public Uni<String> processAsync(String s) {
+    if (s.equalsIgnoreCase("a")) {
+        // Returning a failing Uni triggers a nack
+        return Uni.createFrom().failure(new Exception("a"));
+    }
+
+    if (s.equalsIgnoreCase("b")) {
+        // Throwing an exception triggers a nack
+        throw new IllegalArgumentException("b");
+    }
+
+    if (s.equalsIgnoreCase("e")) {
+        // Returning null would skip the message (it will be acked not nacked)
+        return Uni.createFrom().nullItem();
+    }
+
+    if (s.equalsIgnoreCase("f")) {
+        // returning `null` is invalid for method returning Unis, the message is nacked
+        return null;
+    }
+
+    return Uni.createFrom().item(s.toUpperCase());
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/advanced-config/index.html b/3.25.0/concepts/advanced-config/index.html new file mode 100644 index 0000000000..82343dd100 --- /dev/null +++ b/3.25.0/concepts/advanced-config/index.html @@ -0,0 +1,1635 @@ + + + + + + + + + + + + + + + + + + Advanced Configuration - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Advanced configuration

    +

    Strict Binding Mode

    +

    By default, SmallRye Reactive Messaging does not enforce whether all +mediators are connected. It just prints a warning message. The strict +mode fails the deployment if some "incomings" are not bound to +"outgoings". To enable this mode, you can pass the +-Dsmallrye-messaging-strict-binding=true via the command line, or you +can set the smallrye-messaging-strict-binding attribute to true in +the configuration:

    +
    1
    smallrye-messaging-strict-binding=true
+
    +
    +

    Disabling channels

    +

    You can disable a channel in the configuration by setting the enabled +attribute to false:

    +
    1
+2
    mp.messaging.outgoing.dummy-sink.connector=dummy
+mp.messaging.outgoing.dummy-sink.enabled=false # Disable this channel
+
    +
    +

    SmallRye Reactive Messaging does not register disabled channels, so make +sure the rest of the application does not rely on them.

    +

    Publisher metrics

    +

    SmallRye Reactive Messaging integrates MicroProfile Metrics and +Micrometer for registering counter metrics (named +mp.messaging.message.count) of published messages per channel.

    +

    Both MicroProfile and Micrometer publisher metrics are enabled by +default if found on the classpath. They can be disabled with +smallrye.messaging.metrics.mp.enabled and +smallrye.messaging.metrics.micrometer.enabled properties respectively.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/blocking/index.html b/3.25.0/concepts/blocking/index.html new file mode 100644 index 0000000000..89b85f6c6b --- /dev/null +++ b/3.25.0/concepts/blocking/index.html @@ -0,0 +1,1707 @@ + + + + + + + + + + + + + + + + + + Blocking Processing - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    @Blocking

    +

    The io.smallrye.reactive.messaging.annotations.Blocking annotation can +be used on a method annotated with @Incoming, or @Outgoing to +indicate that the method should be executed on a worker pool:

    +
    1
+2
+3
+4
+5
+6
    @Outgoing("Y")
+@Incoming("X")
+@Blocking
+public String process(String s) {
+  return s.toUpperCase();
+}
+
    +
    +

    If method execution does not need to be ordered, it can be indicated on +the @Blocking annotation:

    +
    1
+2
+3
+4
+5
+6
    @Outgoing("Y")
+@Incoming("X")
+@Blocking(ordered = false)
+public String process(String s) {
+  return s.toUpperCase();
+}
+
    +
    +

    When unordered, the invocation can happen concurrently.

    +

    By default, use of @Blocking results in the method being executed in +the Vert.x worker pool. If it’s desired to execute methods on a custom +worker pool, with specific concurrency needs, it can be defined on +@Blocking:

    +
    1
+2
+3
+4
+5
+6
    @Outgoing("Y")
+@Incoming("X")
+@Blocking("my-custom-pool")
+public String process(String s) {
+  return s.toUpperCase();
+}
+
    +
    +

    Specifying the concurrency for the above worker pool requires the +following configuration property to be defined:

    +
    1
    smallrye.messaging.worker.my-custom-pool.max-concurrency=3
+
    +
    +

    Supported signatures

    +

    @Blocking does not support every signature. The following table lists +the supported ones.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ShapeSignatureComment
    Publisher@Outgoing("in") @Blocking O generator()Invokes the generator from a worker thread. If ordered is set to false, the generator can be called concurrently.
    Publisher@Outgoing("in") @Blocking Message<O> generator()Invokes the generator from a worker thread. If ordered is set to false, the generator can be called concurrently.
    Processor@Incoming("in") @Outgoing("bar") @Blocking O process(I in)Invokes the method on a worker thread. If ordered is set to false, the method can be called concurrently.
    Processor@Incoming("in") @Outgoing("bar") @Blocking Message<O> process(I in)Invokes the method on a worker thread. If ordered is set to false, the method can be called concurrently.
    Subscriber@Incoming("in") @Blocking void consume(I in)Invokes the method on a worker thread. If ordered is set to false, the method can be called concurrently.
    Subscriber@Incoming("in") @Blocking Uni<Void> consume(I in)Invokes the method on a worker thread. If ordered is set to false, the method can be called concurrently.
    Subscriber@Incoming("in") @Blocking CompletionStage<Void> consume(I in)Invokes the method on a worker thread. If ordered is set to false, the method can be called concurrently.
    +

    When a method can be called concurrently, the max concurrency depends on +the number of threads from the worker thread pool.

    +

    Using io.smallrye.common.annotation.Blocking

    +

    io.smallrye.common.annotation.Blocking is another annotation with the +same semantic. io.smallrye.common.annotation.Blocking is used by +multiple SmallRye projects and Quarkus.

    +

    SmallRye Reactive Messaging also supports +io.smallrye.common.annotation.Blocking. However, +io.smallrye.common.annotation.Blocking does not allow configuring the +ordering (it defaults to ordered=true).

    +

    When both annotations are used, +io.smallrye.reactive.messaging.annotations.Blocking is preferred.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/broadcast/index.html b/3.25.0/concepts/broadcast/index.html new file mode 100644 index 0000000000..f09c1dbae0 --- /dev/null +++ b/3.25.0/concepts/broadcast/index.html @@ -0,0 +1,1621 @@ + + + + + + + + + + + + + + + + + + Broadcast - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Broadcast

    +
    +

    Experimental

    +

    @Broadcast is an experimental feature.

    +
    +

    By default, messages transiting in a channel are only dispatched to a +single consumer. Having multiple consumers is considered as an error, +and is reported at deployment time.

    +

    The Broadcast +annotation changes this behavior and indicates that messages transiting +in the channel are dispatched to all the consumers. @Broadcast must be +used with the @Outgoing annotation:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
    @Incoming("in")
+@Outgoing("out")
+@Broadcast
+public int increment(int i) {
+    return i + 1;
+}
+
+@Incoming("out")
+public void consume1(int i) {
+    //...
+}
+
+@Incoming("out")
+public void consume2(int i) {
+    //...
+}
+
    +
    +

    In the previous example, both consumers get the messages.

    +

    You can also control the number of consumers to wait before starting to +dispatch the messages. This allows waiting for the complete graph to be +woven:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
    @Incoming("in")
+@Outgoing("out")
+@Broadcast(2)
+public int increment(int i) {
+    return i + 1;
+}
+
+@Incoming("out")
+public void consume1(int i) {
+    //...
+}
+
+@Incoming("out")
+public void consume2(int i) {
+    //...
+}
+
    +
    +
    +

    Note

    +

    Inbound connectors also support a broadcast attribute that allows +broadcasting the messages to multiple downstream subscribers.

    +
    +

    Use with Emitter

    +

    For details on how to use @Broadcast with Emitter see the +documentation.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/concepts/index.html b/3.25.0/concepts/concepts/index.html new file mode 100644 index 0000000000..74a3524d6b --- /dev/null +++ b/3.25.0/concepts/concepts/index.html @@ -0,0 +1,1681 @@ + + + + + + + + + + + + + + + + + + Introduction - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Introduction

    + +

    When dealing with event-driven or data streaming applications, there are +a few concepts and vocabulary to introduce.

    +

    Messages, Payload, Metadata

    +

    A Message is an envelope around a payload. Your application is +going to receive, process, and send Messages.

    +

    Your application’s logic can generate these Messages or receive them +from a message broker. They can also be consumed by your application or +sent to a message broker.

    +
    + An application can receive a message, process it and send a resulting message +
    An application can receive a message, process it and send a resulting message
    +
    + +

    In Reactive Messaging, Message are represented by the Message interface. +Each Message<T> contains a payload of type <T>. This payload can be retrieved using message.getPayload():

    +
    1
+2
    String payload = message.getPayload();
+Optional<MyMetadata> metadata = message.getMetadata(MyMetadata.class);
+
    +
    +

    As you can see in the previous snippet, Messages can also have +metadata. Metadata is a way to extend messages with additional data. +It can be metadata related to the message broker +(like KafkaMessageMetadata), or contain operational data (such as tracing metadata), or business-related data.

    +
    +

    Note

    +

    When retrieving metadata, you get an Optional as it may not be present.

    +
    +
    +

    Tip

    +

    Metadata is also used to influence the outbound dispatching (how the message will be sent to the broker).

    +
    +

    Channels and Streams

    +

    Inside your application, Messages transit on channel. A channel is +a virtual destination identified by a name.

    +
    + The application is a set of channels +
    The application is a set of channels
    +
    + +

    SmallRye Reactive Messaging connects the component to the channel they read and to the channel they populate. +The resulting structure is a stream: Messages flow between components through channels.

    +
    +

    What about Reactive Streams?

    +

    You may wonder why Reactive Messaging has Reactive in the name. The +Messaging part is kind of obvious. The Reactive part comes from the +streams that are created by binding components. These streams are +Reactive Streams. They follow the +subscription and request protocol and implement back-pressure. It also +means that Connectors are intended to use non-blocking IO +to interact with the various message brokers.

    +
    +

    Connectors

    +

    Your application is interacting with messaging brokers or event backbone using connectors. +A connector is a piece of code that connects to a broker and:

    +
      +
    1. +

      subscribe/poll/receive messages from the broker and propagate them to the application

      +
      2. +
    2. +

      send/write/dispatch messages provided by the application to the broker

      +
      3. +
    +

    Connectors are configured to map incoming messages to a specific +channel (consumed by the application) and collect outgoing messages +sent to a specific channel. These collected messages are sent to the +external broker.

    +
    + Connectors manages the communication between the application and the brokers +
    Connectors manages the communication between the application and the brokers
    +
    + +

    Each connector is dedicated to a specific technology. +For example, a Kafka Connector only deals with Kafka.

    +

    You don’t necessarily need a connector. +When your application does not use connectors, everything happens in-memory, and the streams are created by chaining methods altogether. +Each chain is still a reactive stream and enforces the back-pressure protocol. +When you don’t use connectors, you need to make sure the chain is complete, meaning it starts with a message source, and it ends with a sink. +In other words, you need to generate messages from within the application (using a method with only @Outgoing, or an Emitter) and consume the messages +from within the application (using a method with only @Incoming or using an unmanaged stream).

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/connectors/index.html b/3.25.0/concepts/connectors/index.html new file mode 100644 index 0000000000..ccf364d4be --- /dev/null +++ b/3.25.0/concepts/connectors/index.html @@ -0,0 +1,1798 @@ + + + + + + + + + + + + + + + + + + Connectors - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Connectors

    +

    Reactive Messaging can handle messages generated from within the +application but also interact with remote brokers. Reactive Messaging +Connectors interacts with these remote brokers to retrieve messages +and send messages using various protocols and technology.

    +

    Each connector handles to a specific technology. For example, a Kafka +Connector is responsible for interacting with Kafka, while an MQTT +Connector is responsible for MQTT interactions.

    +

    Connector name

    +

    Each connector has a name. This name is referenced by the application to +indicate that this connector manages a specific channel.

    +

    For example, the SmallRye Kafka Connector is named: smallrye-kafka.

    +

    Inbound and Outbound connectors

    +

    Connector can:

    +
      +
    1. +

      retrieve messages from a remote broker (inbound)

      +
      2. +
    2. +

      send messages to a remote broker (outbound)

      +
      3. +
    +

    A connector can, of course, implement both directions.

    +

    Inbound connectors are responsible for:

    +
      +
    1. +

      Getting messages from the remote broker,

      +
      2. +
    2. +

      Creating a Reactive Messaging Message associated with the + retrieved message.

      +
      3. +
    3. +

      Potentially associating technical metadata with the message. It + includes unmarshalling the payload.

      +
      4. +
    4. +

      Associating an acknowledgment callback to acknowledge the incoming + message when the Reactive Messaging message is + processed/acknowledged.

      +
      5. +
    +
    +

    Reactive matters

    +

    The first step should follow the reactive streams principle: uses +non-blocking technology, respects downstream requests.

    +
    +

    Outbound connectors are responsible for:

    +
      +
    1. +

      Receiving Reactive Messaging Message and transform it into a + structure understood by the remote broker. It includes marshaling + the payload.

      +
      2. +
    2. +

      If the Message contains outbound metadata (metadata set during the + processing to influence the outbound structure and routing), taking + them into account.

      +
      3. +
    3. +

      Sending the message to the remote broker.

      +
      4. +
    4. +

      Acknowledging the Reactive Messaging Message when the broker has + accepted/acknowledged the message.

      +
      5. +
    +

    Configuring connectors

    +

    Applications need to configure the connector used by expressing which +channel is managed by which connector. Non-mapped channels are local / +in-memory.

    +

    To configure connectors, you need to have an implementation of +MicroProfile Config. If you don’t have one, add an implementation of +MicroProfile Config in your classpath, such as:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.config</groupId>
+  <artifactId>smallrye-config</artifactId>
+  <version>2.11.1</version>
+</dependency>
+
    +
    +

    Then edit the application configuration, generally +src/main/resources/META-INF/microprofile-config.properties.

    +

    The application configures the connector with a set of properties +structured as follows:

    +
    1
    mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value]
+
    +
    +

    For example:

    +
    1
+2
+3
+4
    mp.messaging.incoming.dummy-incoming-channel.connector=dummy
+mp.messaging.incoming.dummy-incoming-channel.attribute=value
+mp.messaging.outgoing.dummy-outgoing-channel.connector=dummy
+mp.messaging.outgoing.dummy-outgoing-channel.attribute=value
+
    +
    +

    You configure each channel (both incoming and outgoing) individually.

    +

    The [incoming|outgoing] segment indicates the direction.

    +
      +
    • +

      an incoming channel consumes data from a message broker or + something producing data. It’s an inbound interaction. It relates to + methods annotated with an @Incoming using the same channel name.

      +
      • +
    • +

      an outgoing consumes data from the application and forwards it to + a message broker or something consuming data. It’s an outbound + interaction. It relates to methods annotated with an @Outgoing + using the same channel name.

      +
      • +
    +

    The [channel-name] is the name of the channel. If the channel name +contains a . (dot), you would need to use " (double-quote) around +it. For example, to configure the dummy.incoming.channel channel, you +would need:

    +
    1
+2
    mp.messaging.incoming."dummy.incoming.channel".connector=dummy
+mp.messaging.incoming."dummy.incoming.channel".attribute=value
+
    +
    +

    The [attribute]=[value] sets a specific connector attribute to the +given value. Attributes depend on the used connector. So, refer to the +connector documentation to check the supported attributes.

    +

    The connector attribute must be set for each mapped channel and +indicates the name of the connector responsible for the channel.

    +

    Here is an example of a channel using an MQTT connector, consuming data +from a MQTT broker, and a channel using a Kafka connector (writing data +to Kafka):

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
    # Configure the incoming health channel
+mp.messaging.incoming.health.topic=neo
+mp.messaging.incoming.health.connector=smallrye-mqtt
+mp.messaging.incoming.health.host=localhost
+mp.messaging.incoming.health.broadcast=true
+
+# Configure outgoing data channel
+mp.messaging.outgoing.data.connector=smallrye-kafka
+mp.messaging.outgoing.data.bootstrap.servers=localhost:9092
+mp.messaging.outgoing.data.key.serializer=org.apache.kafka.common.serialization.StringSerializer
+mp.messaging.outgoing.data.value.serializer=io.vertx.kafka.client.serialization.JsonObjectSerializer
+mp.messaging.outgoing.data.acks=1
+
    +
    +
    +

    Important

    +

    To use a connector, you need to add it to your CLASSPATH. Generally, +adding the dependency to your project is enough. Then, you need to know +the connector’s name and set the connector attribute for each channel +managed by this connector.

    +
    +

    Connector attribute table

    +

    In the connector documentation, you will find a table listing the +attribute supported by the connector. Be aware that attributes for +inbound and outbound interactions may be different.

    +

    These tables contain the following entries:

    +
      +
    1. +

      The name of the attribute, and potentially an alias. The name of + the attribute is used with the + mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value] + syntax (the attribute segment). The alias (if set) is the name + of a global MicroProfile Config property that avoids having to + configure the attribute for each managed channel. For example, to + set the location of your Kafka broker globally, you can use the + kafka.bootstrap.servers alias.

      +
      2. +
    2. +

      The description of the attribute, including the type.

      +
      3. +
    3. +

      Whether that attribute is mandatory. If so, it fails the + deployment if not set

      +
      4. +
    4. +

      The default value, if any.

      +
      5. +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/converters/index.html b/3.25.0/concepts/converters/index.html new file mode 100644 index 0000000000..d7d6e177da --- /dev/null +++ b/3.25.0/concepts/converters/index.html @@ -0,0 +1,1618 @@ + + + + + + + + + + + + + + + + + + Message Converters - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Message Converters

    +

    SmallRye Reactive Messaging supports message converters, allowing to +transform an incoming message into a version accepted by the method. If +the incoming messages or payload does not match the invoked method’s +expectation, SmallRye Reactive Messaging looks for a suitable converter. +If found, it converts the incoming message with this converter.

    +

    Converters can have multiple purposes, but the main use case is about +transforming the message’s payload:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
    @ApplicationScoped
+public class MyConverter implements MessageConverter {
+    @Override
+    public boolean canConvert(Message<?> in, Type target) {
+        // Checks whether this converter can be used to convert
+        // the incoming message into a message containing a payload
+        // of the type `target`.
+        return in.getPayload().getClass().equals(String.class)
+                && target.equals(Person.class);
+    }
+
+    @Override
+    public Message<?> convert(Message<?> in, Type target) {
+        // Convert the incoming message into the new message.
+        // It's important to build the new message **from**
+        // the received one.
+        return in.withPayload(new Person((String) in.getPayload()));
+    }
+}
+
    +
    +

    To provide a converter, implement a bean exposing the MessageConverter +interface. The canConvert method is called during the lookup and +verifies if it can handle the conversion. The target type is the +expected payload type. If the converter returns true to canConvert, +SmallRye Reactive Messaging calls the convert method to proceed to the +conversion.

    +

    The previous converter can be used in application like the following, to +convert Message<String> to Message<Person>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
    @Outgoing("persons")
+public Multi<String> source() {
+    return Multi.createFrom().items("Neo", "Morpheus", "Trinity");
+}
+
+// The messages need to be converted as they are emitted as Message<String>
+// and consumed as Message<Person>
+@Incoming("persons")
+public void consume(Person p) {
+    // ...
+}
+
    +
    +

    Converters work for all supported method signatures. However, the +signature must be well-formed to allow the extraction of the expected +payload type. Wildcards and raw types do not support conversion. If the +expected payload type cannot be extracted, or no converter fits, the +message is passed as received.

    +

    If multiple suitable converters are present, implementations should +override the getPriority method returning the priority. The default +priority is 100. The converter lookup invokes converters with higher +priority (from the least value to the greatest) first.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/decorators/index.html b/3.25.0/concepts/decorators/index.html new file mode 100644 index 0000000000..e67ec50add --- /dev/null +++ b/3.25.0/concepts/decorators/index.html @@ -0,0 +1,1737 @@ + + + + + + + + + + + + + + + + + + Channel Decorators - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Channel Decorators

    +

    SmallRye Reactive Messaging supports decorating reactive streams +of incoming and outgoing channels for implementing cross-cutting +concerns such as monitoring, tracing or message interception.

    +

    Two symmetrical APIs are proposed for decorating publisher and subscriber channels, +PublisherDecorator +and SubscriberDecorator respectively.

    +
    +

    Important

    +

    @Incoming channels and channels bound to an outbound connector are both Subscribers. +Conversely @Outgoing channels and channels bound to an inbound connector are Publishers.

    +
    +

    For example, to provide a decorator which counts consumed messages from incoming connector, +implement a bean exposing the interface PublisherDecorator:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
    @ApplicationScoped
+public class ConsumedMessageDecorator implements PublisherDecorator {
+
+    private final Map<String, AtomicLong> counters = new HashMap<>();
+
+    @Override
+    public Multi<? extends Message<?>> decorate(Multi<? extends Message<?>> publisher, String channelName,
+            boolean isConnector) {
+        if (isConnector) {
+            AtomicLong counter = new AtomicLong();
+            counters.put(channelName, counter);
+            return publisher.onItem().invoke(counter::incrementAndGet);
+        } else {
+            return publisher;
+        }
+    }
+
+    @Override
+    public int getPriority() {
+        return 10;
+    }
+
+    public long getMessageCount(String channel) {
+        return counters.get(channel).get();
+    }
+}
+
    +
    +

    Decorators' decorate method is called only once per channel at application deployment when graph wiring is taking place. +Decorators are very powerful because they receive the stream of messages (Mutiny Multi<Message<?>>) +and potentially return a new stream of messages.

    +

    Note that if a decorator is available it will be called on every channel. +The decorate method receives the channel name and whether the channel is a connector or not as parameters. +Decorators are called ordered from highest to lowest priority (from the least value to the greatest), +obtained using the javax.enterprise.inject.spi.Prioritized#getPriority method.

    +
    +

    Note

    +

    The SubscriberDecorator receive a list of channel names because @Incoming annotation is repeatable +and consuming methods can be linked to multiple channels.

    +
    +

    Intercepting Outgoing Messages

    +

    Decorators can be used to intercept and alter messages, both on incoming and outgoing channels. +Smallrye Reactive Messaging provides a SubscriberDecorator by default to allow intercepting outgoing messages for a specific channel.

    +

    To provide an outgoing interceptor implement a bean exposing the interface OutgoingInterceptor, qualified with a @Identifier with the channel name to intercept. +Only one interceptor is allowed to be bound for interception per outgoing channel. +If no interceptors are found with a @Identifier but a @Default one is available, it is used. +When multiple interceptors are available, the bean with the highest priority is used.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
    package interceptors;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+import io.smallrye.common.annotation.Identifier;
+import io.smallrye.reactive.messaging.OutgoingInterceptor;
+import io.smallrye.reactive.messaging.OutgoingMessageMetadata;
+
+@Identifier("channel-a")
+@ApplicationScoped
+public class MyInterceptor implements OutgoingInterceptor {
+
+    @Override
+    public Message<?> onMessage(Message<?> message) {
+        return message.withPayload("changed " + message.getPayload());
+    }
+
+    @Override
+    public void onMessageAck(Message<?> message) {
+        message.getMetadata(OutgoingMessageMetadata.class)
+                .ifPresent(m -> m.getResult());
+    }
+
+    @Override
+    public void onMessageNack(Message<?> message, Throwable failure) {
+
+    }
+}
+
    +
    +

    An OutgoingInterceptor can implement these three methods:

    +
      +
    • Message<?> onMessage(Message<?> message) : Called before passing the message to the outgoing connector for transmission. +The message can be altered by returning a new message from this method.
      • +
    • void onMessageAck(Message<?> message) : Called after message acknowledgment. +This callback can access OutgoingMessageMetadata which will hold the result of the message transmission to the broker, if supported by the connector. This is only supported by MQTT and Kafka connectors.
      • +
    • void onMessageNack(Message<?> message, Throwable failure) : Called before message negative-acknowledgment.
      • +
    +
    +

    Note

    +

    If you are willing to adapt an incoming message payload to fit a consuming method receiving type, +you can use MessageConverters.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/emitter/index.html b/3.25.0/concepts/emitter/index.html new file mode 100644 index 0000000000..1e4eea5cd5 --- /dev/null +++ b/3.25.0/concepts/emitter/index.html @@ -0,0 +1,2223 @@ + + + + + + + + + + + + + + + + + + Emitters and Channel - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Emitter and Channels

    +

    It is not rare to combine in a single application imperative parts +(Jax-RS, regular CDI beans) and reactive parts (beans with +@Incoming and @Outgoing annotations). In these case, it’s often +required to send messages from the imperative part to the reactive +part. In other words, send messages to channels handled by reactive +messaging and how can you retrieve messages.

    +

    Emitter and @Channel

    +

    To send things (payload or Message) from imperative code to a +specific channel you need to use:

    +
      +
    1. the org.eclipse.microprofile.reactive.messaging.Channel annotations
      2. +
    2. the org.eclipse.microprofile.reactive.messaging.Emitter type
      3. +
    +

    The @Channel lets you indicate to which channel you are going to send +your payloads or messages. The Emitter is the object to use to send +these payloads or messages.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
    import org.eclipse.microprofile.reactive.messaging.Channel;
+import org.eclipse.microprofile.reactive.messaging.Emitter;
+
+@ApplicationScoped
+public class MyImperativeBean {
+
+    @Inject
+    @Channel("prices")
+    Emitter<Double> emitter;
+
+    // ...
+
+    public void send(double d) {
+        emitter.send(d);
+    }
+}
+
    +
    +

    The Emitter class takes a type parameter. It’s the type of payload. +Even if you want to send Messages, the type is the payload type.

    +
    +

    Important

    +

    You must have a @Incoming("prices") somewhere in your application +(meaning a method consuming messages transiting on the channel +prices), or an outbound connector configured to manage the prices +channel (mp.messaging.outgoing.prices...)

    +
    +

    Sending payloads

    +

    Sending payloads is done as follows:

    +
    1
+2
+3
+4
+5
+6
+7
    @Inject
+@Channel("prices")
+Emitter<Double> emitterForPrices;
+
+public void send(double d) {
+    emitterForPrices.send(d);
+}
+
    +
    +

    When sending a payload, the emitter returns a CompletionStage. This +CompletionStage gets completed once the message created from the +payload is acknowledged:

    +
    1
+2
+3
+4
+5
+6
    public void sendAndAwaitAcknowledgement(double d) {
+    CompletionStage<Void> acked = emitterForPrices.send(d);
+    // sending a payload returns a CompletionStage completed
+    // when the message is acknowledged
+    acked.toCompletableFuture().join();
+}
+
    +
    +

    If the processing fails, the CompletionStage gets completed +exceptionally (with the reason of the nack).

    +

    Sending messages

    +

    You can also send Messages:

    +
    1
+2
+3
    public void sendAsMessage(double d) {
+    emitterForPrices.send(Message.of(d));
+}
+
    +
    +

    When sending a Message, the emitter does not return a +CompletionStage, but you can pass the ack/nack callback, and be called +when the message is acked/nacked.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
    public void sendAsMessageWithAck(double d) {
+    emitterForPrices.send(Message.of(d, () -> {
+        // Called when the message is acknowledged.
+        return CompletableFuture.completedFuture(null);
+    },
+            reason -> {
+                // Called when the message is acknowledged negatively.
+                return CompletableFuture.completedFuture(null);
+            }));
+}
+
    +
    +

    Sending messages also let you pass metadata.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
    public void sendAsMessageWithAckAndMetadata(double d) {
+    MyMetadata metadata = new MyMetadata();
+    emitterForPrices.send(Message.of(d, Metadata.of(metadata),
+            () -> {
+                // Called when the message is acknowledged.
+                return CompletableFuture.completedFuture(null);
+            },
+            reason -> {
+                // Called when the message is acknowledged negatively.
+                return CompletableFuture.completedFuture(null);
+            }));
+}
+
    +
    +

    Metadata can be used to propagate some context objects with the message.

    +

    Overflow management

    +

    When sending messages from imperative code to reactive code, you must be +aware of back-pressure. Indeed, messages sent using the emitter and +stored in a queue. If the consumer does not process the messages +quickly enough, this queue can become a memory hog and you may even run +out of memory.

    +

    To control what need to happen when the queue becomes out of control, +use the OnOverflow annotation. @OnOverflow lets you configure:

    +
      +
    • the maximum size of the queue (default is 256)
      • +
    • what needs to happen when this size is reached (fail, drop...)
      • +
    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
    // Set the max size to 10 and fail if reached
+@OnOverflow(value = OnOverflow.Strategy.BUFFER, bufferSize = 10)
+@Inject
+@Channel("channel")
+Emitter<String> emitterWithBuffer;
+
+// [DANGER ZONE] no limit
+@OnOverflow(OnOverflow.Strategy.UNBOUNDED_BUFFER)
+@Inject
+@Channel("channel")
+Emitter<String> danger;
+
+// Drop the new messages if the size is reached
+@OnOverflow(OnOverflow.Strategy.DROP)
+@Inject
+@Channel("channel")
+Emitter<String> dropping;
+
+// Drop the previously sent messages if the size is reached
+@OnOverflow(OnOverflow.Strategy.LATEST)
+@Inject
+@Channel("channel")
+Emitter<String> dropOldMessages;
+
    +
    +

    The supported strategies are:

    +
      +
    • +

      OnOverflow.Strategy.BUFFER - use a buffer to store the elements + until they are consumed. If the buffer is full, a failure is + propagated (and the thread using the emitted gets an exception)

      +
      • +
    • +

      OnOverflow.Strategy.UNBOUNDED_BUFFER - use an unbounded buffer to + store the elements

      +
      • +
    • +

      OnOverflow.Strategy.DROP - drops the most recent value if the + downstream can’t keep up. It means that new value emitted by the + emitter are ignored.

      +
      • +
    • +

      OnOverflow.Strategy.FAIL - propagates a failure in case the + downstream can’t keep up.

      +
      • +
    • +

      OnOverflow.Strategy.LATEST - keeps only the latest value, dropping + any previous value if the downstream can’t keep up.

      +
      • +
    • +

      OnOverflow.Strategy.NONE - ignore the back-pressure signals + letting the downstream consumer to implement a strategy.

      +
      • +
    +

    Defensive emission

    +

    Having an emitter injected into your code does not guarantee that +someone is ready to consume the message. For example, a subscriber may +be connecting to a remote broker. If there are no subscribers, using the +send method will throw an exception.

    +

    The emitter.hasRequests() method indicates that a subscriber +subscribes to the channel and requested items. So, you can wrap your +emission with:

    +
    1
+2
+3
    if (emitter.hasRequests()) {
+    emitter.send("hello");
+}
+
    +
    +

    If you use the OnOverflow.Strategy.DROP, you can use the send method +even with no subscribers nor demands. The message will be nacked +immediately.

    +

    Retrieving channels

    +

    You can use the @Channel annotation to inject in your bean the +underlying stream. Note that in this case, you will be responsible for +the subscription:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    @Inject
+@Channel("my-channel")
+Multi<String> streamOfPayloads;
+
+@Inject
+@Channel("my-channel")
+Multi<Message<String>> streamOfMessages;
+
+@Inject
+@Channel("my-channel")
+Publisher<String> publisherOfPayloads;
+
+@Inject
+@Channel("my-channel")
+Publisher<Message<String>> publisherOfMessages;
+
    +
    +
    +

    Important

    +

    You must have a @Outgoing("my-channel") somewhere in your application +(meaning a method generating messages transiting on the channel +my-channel), or an inbound connector configured to manage the prices +channel (mp.messaging.incoming.prices...)

    +
    +

    Injected channels merge all the matching outgoing - so if you have +multiple @Outgoing("out"), @Inject @Channel("out") gets all the +messages.

    +

    If your injected channel receives payloads (Multi<T>), it +acknowledges the message automatically, and support multiple +subscribers. If you injected channel receives Message +(Multi<Message<T>>), you will be responsible for the acknowledgement +and broadcasting.

    +

    Emitter and @Broadcast

    +

    When using an Emitter, you can now @Broadcast what is emitted to all +subscribers.

    +

    Here is an example of emitting a price with two methods marked +@Incoming to receive the broadcast:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
    @Inject
+@Broadcast
+@Channel("prices")
+Emitter<Double> emitter;
+
+public void emit(double d) {
+    emitter.send(d);
+}
+
+@Incoming("prices")
+public void handle(double d) {
+    // Handle the new price
+}
+
+@Incoming("prices")
+public void audit(double d) {
+    // Audit the price change
+}
+
    +
    +

    For more details see @Broadcast +documentation.

    +

    Mutiny Emitter

    +

    If you prefer to utilize Uni in all your code, there is now a +MutinyEmitter that will return Uni<Void> instead of void.

    +
    1
+2
+3
+4
+5
+6
+7
    @Inject
+@Channel("prices")
+MutinyEmitter<Double> emitter;
+
+public Uni<Void> send(double d) {
+    return emitter.send(d);
+}
+
    +
    +

    There’s also the ability to block on sending the event to the emitter. +It will only return from the method when the event is acknowledged, or +nacked, by the receiver:

    +
    1
+2
+3
    public void sendAwait(double d) {
+    emitter.sendAndAwait(d);
+}
+
    +
    +

    And if you don’t need to worry about the success or failure of sending +an event, you can sendAndForget:

    +
    1
+2
+3
    public Cancellable sendForget(double d) {
+    return emitter.sendAndForget(d);
+}
+
    +
    +

    Custom Emitter Implementations

    +
    +

    Experimental

    +

    Custom emitter implementations is an experimental feature.

    +
    +

    Emitter and MutinyEmitter are two implementations of the emitter concept, +where imperative code in your application can send messages to Reactive Messaging channels.

    +

    With EmitterFactory it is possible to provide custom implementations, and application facing emitter interfaces.

    +

    In the following example, the injectable custom emitter interface is CustomEmitter, +and it is implemented by CustomEmitterImpl:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
    public interface CustomEmitter<T> extends EmitterType {
+
+    <M extends Message<? extends T>> void sendAndForget(M msg);
+
+}
+
+public static class CustomEmitterImpl<T> implements CustomEmitter<T>, MessagePublisherProvider<Object> {
+
+    Publisher<Message<?>> publisher;
+
+    public CustomEmitterImpl(EmitterConfiguration configuration, long defaultBufferSize) {
+        //... initialize emitter with configuration
+    }
+
+    @Override
+    public Publisher<Message<?>> getPublisher() {
+        return publisher;
+    }
+
+    @Override
+    public <M extends Message<? extends T>> void sendAndForget(M msg) {
+        //... send to stream
+    }
+}
+
    +
    +

    Note that CustomEmitter interface extends EmitterType, which is a marker interface for discovering custom emitter types. +Also, CustomEmitterImpl implements the MessagePublisherProvider, which is used by the framework to transform this emitter to a channel.

    +

    Then we need to provide an implementation of the EmitterFactory interface:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
    @EmitterFactoryFor(CustomEmitter.class)
+@ApplicationScoped
+public static class CustomEmitterFactory implements EmitterFactory<CustomEmitterImpl<Object>> {
+
+    @Inject
+    ChannelRegistry channelRegistry;
+
+    @Override
+    public CustomEmitterImpl<Object> createEmitter(EmitterConfiguration configuration, long defaultBufferSize) {
+        return new CustomEmitterImpl<>(configuration, defaultBufferSize);
+    }
+
+    @Produces
+    @Channel("") // Stream name is ignored during type-safe resolution
+    <T> CustomEmitter<T> produce(InjectionPoint injectionPoint) {
+        String channelName = ChannelProducer.getChannelName(injectionPoint);
+        return channelRegistry.getEmitter(channelName, CustomEmitter.class);
+    }
+}
+
    +
    +

    The CustomEmitterFactory is a CDI managed bean, which implements the EmitterFactory. +It is qualified with EmitterFactoryFor annotation which is configured with the emitter interface CustomEmitter that this factory provides.

    +

    Smallrye Reactive Messaging discovers the emitter factory during the CDI deployment validation +and verifies that custom emitters used by the application have corresponding emitter factories. +It'll use the emitter factory to create the emitter implementation and will register the implementation into the ChannelRegistry.

    +

    Note that the CustomEmitterFactory also uses the ChannelRegistry and provides the custom emitter with @Produces.

    +

    Finally, the application can inject and use the CustomEmitter as a normal emitter channel:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
    @Inject
+@Channel("custom-emitter-channel")
+CustomEmitter<String> customEmitter;
+
+//...
+
+public void emitMessage() {
+    customEmitter.sendAndForget(Message.of("a"));
+    customEmitter.sendAndForget(Message.of("b"));
+    customEmitter.sendAndForget(Message.of("c"));
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/incomings/index.html b/3.25.0/concepts/incomings/index.html new file mode 100644 index 0000000000..51289e0b2b --- /dev/null +++ b/3.25.0/concepts/incomings/index.html @@ -0,0 +1,1552 @@ + + + + + + + + + + + + + + + + + + @Incomings - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Multiple Incoming Channels

    +
    +

    Experimental

    +

    Multiple @Incomings is an experimental feature.

    +
    +

    The @Incoming annotation is repeatable. It means that the method +receives the messages transiting on every listed channels, in no +specific order:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("channel-1")
+@Incoming("channel-2")
+public String process(String s) {
+    // get messages from channel-1 and channel-2
+    return s.toUpperCase();
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/logging/index.html b/3.25.0/concepts/logging/index.html new file mode 100644 index 0000000000..1f5064fc56 --- /dev/null +++ b/3.25.0/concepts/logging/index.html @@ -0,0 +1,2019 @@ + + + + + + + + + + + + + + + + + + Logging - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Logging

    +

    SmallRye Reactive Messaging uses JBoss +Logging as logging API. This section +explains how to configure the loggers for various logging backends.

    +
    +

    Tip

    +

    If you are developing SmallRye Reactive Messaging and wonder about how +the logs are managed, it uses JBoss Logging +Tools.

    +
    +

    Logging Backends

    +

    SmallRye Reactive Messaging uses the JBoss Logging library to write +messages to a log file. This library is a logging bridge that +integrates different log frameworks. You can decide which of the +following frameworks you want to use for your application:

    +
      +
    • JBoss LogManager (jboss)
      • +
    • Log4j 2 (log4j2)
      • +
    • Log4j 1 (log4j)
      • +
    • Slf4j (slf4j)
      • +
    • JDK logging (jul)
      • +
    +

    You only need to add the chosen framework to the classpath, and the +JBoss Logging library will pick it up. If there are multiple frameworks +available on the classpath, it picks the first found (in the order from +the list). Alternatively, you can set the org.jboss.logging.provider +system property is one of the values given above.

    +

    The concepts and log categories are the same for all frameworks. +However, the format of the configuration file and the names of the log +levels differ. Check the documentation of your logging library to find +out which dependencies are required, the exact name of the log levels, +and where the configuration should be written.

    +

    Log Categories

    +

    As all applications and frameworks, SmallRye Reactive Messaging writes +log messages in different categories and log levels. The categories +group messages from specific connectors, classes or components. The +following table shows the essential log categories used by SmallRye +Reactive Messaging:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    CategoryDescription
    io.smallrye.reactive.messagingThis category contains all the messages written by SmallRye Reactive Messaging.
    io.smallrye.reactive.messaging.providerThis category contains all the messages generated by the core (provider).
    io.smallrye.reactive.messaging.kafkaThis category contains all the messages generated by the Kafka Connector.
    io.smallrye.reactive.messaging.amqpThis category contains all the messages generated by the AMQP Connector.
    io.smallrye.reactive.messaging.jmsThis category contains all the messages generated by the JMS Connector.
    io.smallrye.reactive.messaging.camelThis category contains all the messages generated by the Camel Connector.
    io.smallrye.reactive.messaging.mqttThis category contains all the messages generated by the MQTT (Client) Connector.
    io.smallrye.reactive.messaging.mqtt-serverThis category contains all the messages generated by the MQTT (Server) Connector.
    +

    The names of the log levels are defined by your logging framework and +determine the amount and granularity of the log messages. You can assign +a log level to each category. If you do not specify a specific +category’s log level, it will inherit the level from its parent +category. Thus, setting the log level of +io.smallrye.reactive.messaging influences every loggers from SmallRye +Reactive Messaging.

    +

    Message Code

    +

    Each message has an identifier code. They are all prefixed with SRMSG, +followed with the numeric code.

    +

    In the following output, the code is SRMSG00229:

    +
    1
    [2020-06-15 13:35:07] [INFO   ] SRMSG00229: Channel manager initializing...
+
    +
    + +

    Development

    +

    Log4J 1

    +

    log4j.properties

    +
    1
+2
+3
+4
+5
+6
+7
+8
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.Target=System.out
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p [%c] - %m%n
+
+log4j.rootLogger=info, stdout
+log4j.logger.io.smallrye.reactive.messaging=info
+log4j.logger.org.jboss.weld=warn
+
    +
    +

    Log4J 2

    +

    log4j2.xml

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    <Configuration monitorInterval="60">
+  <Properties>
+    <Property name="log-path">PropertiesConfiguration</Property>
+  </Properties>
+  <Appenders>
+    <Console name="Console-Appender" target="SYSTEM*OUT">
+      <PatternLayout>
+        <pattern>
+          [%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n
+        </pattern>>
+      </PatternLayout>
+    </Console>
+  </Appenders>
+  <Loggers>
+    <Logger name="io.smallrye.reactive.messaging" level="info" additivity="false">
+      <AppenderRef ref="Console-Appender"/>
+    </Logger>
+    <Logger name="org.jboss.weld" level="warn" additivity="false">
+      <AppenderRef ref="Console-Appender"/>
+    </Logger>
+    <Root level="info">
+      <AppenderRef ref="Console-Appender"/>
+    </Root>
+  </Loggers>
+</Configuration>
+
    +
    +

    JDK (JUL)

    +

    logging.properties

    +
    1
+2
+3
+4
+5
+6
+7
+8
+9
    handlers=java.util.logging.ConsoleHandler
+
+java.util.logging.ConsoleHandler.level=FINEST
+java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
+java.util.logging.SimpleFormatter.format=[%1$tF %1$tT] [%4$-7s] %5$s %n
+
+.level=INFO
+io.smallrye.reactive.messaging.level=INFO
+org.jboss.weld.level=WARNING
+
    +
    +

    LogBack via SLF4J*

    +

    logback.xml

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
    <configuration>
+  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
+      <Pattern>
+        %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n
+      </Pattern>
+    </encoder>
+  </appender>
+  <logger name="io.smallrye.reactive.messaging" level="info" additivity="false">
+    <appender-ref ref="STDOUT"/>
+  </logger>
+  <logger name="org.jboss.weld" level="warn" additivity="false">
+    <appender-ref ref="STDOUT"/>
+  </logger>
+  <root level="info">
+    <appender-ref ref="STDOUT"/>
+  </root>
+</configuration>
+
    +
    +

    Production

    +

    Log4J 1

    +

    log4j.properties

    +
    1
+2
+3
+4
+5
+6
+7
+8
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.Target=System.out
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p [%c] - %m%n
+
+log4j.rootLogger=info, stdout
+log4j.logger.io.smallrye.reactive.messaging=warn
+log4j.logger.org.jboss.weld=error
+
    +
    +

    Log4J 2

    +

    log4j2.xml

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    <Configuration monitorInterval="60">
+  <Properties>
+    <Property name="log-path">PropertiesConfiguration</Property>
+  </Properties>
+  <Appenders>
+    <Console name="Console-Appender" target="SYSTEM*OUT">
+      <PatternLayout>
+        <pattern>
+          [%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n
+        </pattern>>
+      </PatternLayout>
+    </Console>
+  </Appenders>
+  <Loggers>
+    <Logger name="io.smallrye.reactive.messaging" level="warn" additivity="false">
+      <AppenderRef ref="Console-Appender"/>
+    </Logger>
+    <Logger name="org.jboss.weld" level="error" additivity="false">
+      <AppenderRef ref="Console-Appender"/>
+    </Logger>
+    <Root level="info">
+      <AppenderRef ref="Console-Appender"/>
+    </Root>
+  </Loggers>
+</Configuration>
+
    +
    +

    JDK (JUL)

    +

    logging.properties

    +
    1
+2
+3
+4
+5
+6
+7
+8
+9
    handlers=java.util.logging.ConsoleHandler
+
+java.util.logging.ConsoleHandler.level=INFO
+java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
+java.util.logging.SimpleFormatter.format=[%1$tF %1$tT] [%4$-7s] %5$s %n
+
+.level=INFO
+io.smallrye.reactive.messaging.level=WARNING
+org.jboss.weld.level=SEVERE
+
    +
    +

    logback.xml

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
    <configuration>
+  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
+      <Pattern>
+        %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n
+      </Pattern>
+    </encoder>
+  </appender>
+  <logger name="io.smallrye.reactive.messaging" level="warn" additivity="false">
+    <appender-ref ref="STDOUT"/>
+  </logger>
+  <logger name="org.jboss.weld" level="error" additivity="false">
+    <appender-ref ref="STDOUT"/>
+  </logger>
+  <root level="info">
+    <appender-ref ref="STDOUT"/>
+  </root>
+</configuration>
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/merge/index.html b/3.25.0/concepts/merge/index.html new file mode 100644 index 0000000000..61c9bfb567 --- /dev/null +++ b/3.25.0/concepts/merge/index.html @@ -0,0 +1,1602 @@ + + + + + + + + + + + + + + + + + + Merge channels - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Merge channels

    +
    +

    Experimental

    +

    @Merge is an experimental feature.

    +
    +

    By default, messages transiting in a channel can arise from a single +producer. Having multiple producers is considered erroneous and is +reported at deployment time.

    +

    The Merge +annotation changes this behavior and indicates that a channel can have +multiple producers. @Merge must be used with the @Incoming +annotation:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    @Incoming("in1")
+@Outgoing("out")
+public int increment(int i) {
+    return i + 1;
+}
+
+@Incoming("in2")
+@Outgoing("out")
+public int multiply(int i) {
+    return i * 2;
+}
+
+@Incoming("out")
+@Merge
+public void getAll(int i) {
+    //...
+}
+
    +
    +

    In the previous example, the consumer gets all the messages (from both +producers).

    +

    The @Merge annotation allows configuring how the incoming messages +(from the different producers) are merged into the channel. The mode +attribute allows configuring this behavior:

    +
      +
    • +

      ONE picks a single producer, discarding the other producer;

      +
      • +
    • +

      MERGE (default) gets all the messages as they come, without any + defined order. Messages from different producers may be interleaved.

      +
      • +
    • +

      CONCAT concatenates the producers. The messages from one producer + are received until the messages from other producers are received.

      +
      • +
    +
    +

    Note

    +

    Outbound connectors also support a merge attribute that allows +consuming the messages to multiple upstreams. It will dispatch all the +received messages.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/message-context/index.html b/3.25.0/concepts/message-context/index.html new file mode 100644 index 0000000000..c47bd4719a --- /dev/null +++ b/3.25.0/concepts/message-context/index.html @@ -0,0 +1,1699 @@ + + + + + + + + + + + + + + + + + + Message Context - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Message Contexts

    +

    Message context provides a way to propagate data along the processing of a message. +It can be used to propagate message specific objects in an implicit manner and be able to retrieve them later, such as the user, session or transaction.

    +
    +

    Important

    +

    Message contexts are only support by Kafka, AMQP, RabbitMQ and MQTT connectors.

    +
    +
    +

    Note

    +

    Message context support is an experimental and SmallRye only feature.

    +
    +

    What's a message context

    +

    A message context is execution context on which a message is processed. +Each stage of the processing is going to use the same execution context. +Thus, it allows storing data which can later be restored. +For example, you can imagine storing some authentication (User in the following example) data in one part of your processing and restore it in a later stage.

    +

     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
    @Incoming("data")
+@Outgoing("process")
+public Message<String> process(Message<String> input) {
+    // Extract some data from the message and store it in the context
+    User user = ...;
+    // Store the extracted data into the message context.
+    ContextLocals.put("user", user);
+    record input;
+}
+
+@Incoming("process")
+@Outgoing("after-process")
+public String handle(String payload) {
+   // You can retrieve the store data using
+   User user = ContextLocals.get("user", null);
+
+   // ...
+   return payload;
+}
+
    +
    +The Message context is also available when using blocking or asynchronous stages (stage returning Uni or CompletionStage)

    +

    The difference with metadata

    +

    Message metadata can be used to provide a similar feature. +However, it requires using Messages which can be inconvenient (need to handle the acknowledgement manually). +Message Contexts provide a simpler API, closer to a Message CDI scope: you can save data, and restore it later. +The implicit propagation avoid having to deal with Messages.

    +

    Supported signatures

    +

    Message context works with:

    +
      +
    • methods consuming or producing Messages, Uni<Message<T>> and CompletionStage<Message<T>>
      • +
    • methods consuming or producing payloads, Uni<Payload> and CompletionStage<Payload>.
      • +
    • blocking and non-blocking methods
      • +
    +

    However, message context are NOT enforced when using methods consuming or producing:

    +
      +
    • Multi, Publisher and PublisherBuilder
      • +
    • Subscriber and SubscriberBuilder
      • +
    • Processor and ProcessorBuilder
      • +
    +

    Under the hood

    +

    Under the hood, the message context feature uses Vert.x duplicated contexts. +A duplicated context is a view of the "root" (event loop) context, which is restored at each stage of the message processing.

    +

    Each time that a compatible connector receives a message from a broker, it creates a new duplicated context and attaches it to the message. +So the context is stored in the metadata of the message.

    +

    When the message is processed, SmallRye Reactive Messaging makes sure that this processing is executed on the stored duplicated context.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/model/index.html b/3.25.0/concepts/model/index.html new file mode 100644 index 0000000000..552abe402e --- /dev/null +++ b/3.25.0/concepts/model/index.html @@ -0,0 +1,2429 @@ + + + + + + + + + + + + + + + + + + Development Model - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Development Model

    +

    Reactive Messaging proposes a CDI-based programming model to implement event-driven applications. +Following the CDI principles, beans are forming the main building block of your application. +Reactive Messaging provides a set of annotations and types to implement beans that generate, consume or process messages.

    +

    @Incoming and @Outgoing

    +

    Reactive Messaging provides two main annotations:

    + +

    These annotations are used on methods:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
    package beans;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+@ApplicationScoped
+public class MessageProcessingBean {
+
+    @Incoming("consumed-channel")
+    @Outgoing("populated-channel")
+    public Message<String> process(Message<String> in) {
+        // Process the payload
+        String payload = in.getPayload().toUpperCase();
+        // Create a new message from `in` and just update the payload
+        return in.withPayload(payload);
+    }
+}
+
    +
    +
    +

    Note

    +
    +

    Reactive Messaging beans can either be in the application scope (@ApplicationScoped) or dependent scope (@Dependent).

    +

    Manipulating messages can be cumbersome. +When you are only interested in the payload, you can use the following syntax: The following code is equivalent to the snippet from above:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
    package beans;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+@ApplicationScoped
+public class PayloadProcessingBean {
+
+    @Incoming("consumed-channel")
+    @Outgoing("populated-channel")
+    public String process(String in) {
+        return in.toUpperCase();
+    }
+}
+
    +
    +
    +

    Important

    +
    +

    You should not call methods annotated with @Incoming and/or +@Outgoing directly from your code. They are invoked by the framework. +Having user code invoking them would not have the expected outcome.

    +

    SmallRye Reactive Messaging automatically binds matching @Outgoing to +@Incoming to form a chain:

    +
    + A chain of components +
    A chain of components
    +
    + +

    If we consider the following code:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    @Outgoing("source")
+public Multi<String> generate() {
+    return Multi.createFrom().items("Hello", "from", "reactive", "messaging");
+}
+
+@Incoming("source")
+@Outgoing("sink")
+public String process(String in) {
+    return in.toUpperCase();
+}
+
+@Incoming("sink")
+public void consume(String processed) {
+    System.out.println(processed);
+}
+
    +
    +

    It would generate the following chain:

    +
    1
    generate --> [ source ] --> process --> [ sink ] --> consume
+
    +
    +

    Methods annotated with @Incoming or @Outgoing don’t have to be in the same bean (class). +You can distribute them among a set of beans. +Remote interactions are also possible when using connectors.

    +

    Methods annotated with:

    +
      +
    • only @Outgoing are used to generate messages or payloads
      • +
    • only @Incoming are used to consume messages or payloads
      • +
    • both @Incoming and @Outgoing are used to process messages or payloads; or transform the stream
      • +
    +

    Creating messages

    +

    Messages are envelopes around payload. +They are the vehicle. +While manipulating payload is convenient, messages let you add metadata, handle acknowledgement...

    +

    Creating Messages is done using the Message interface directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
    // Create a simple message wrapping a payload
+Message<Price> m1 = Message.of(price);
+
+// Create a message with metadata
+Message<Price> m2 = Message.of(price, Metadata.of(new PriceMetadata()));
+
+// Create a message with several metadata
+Message<Price> m3 = Message.of(price,
+        Metadata.of(new PriceMetadata(), new MyMetadata()));
+
+// Create a message with an acknowledgement callback
+Message<Price> m4 = Message.of(price, () -> {
+    // Called when the message is acknowledged by the next consumer.
+    return CompletableFuture.completedFuture(null);
+});
+
+// Create a message with both metadata and acknowledgement callback
+Message<Price> m5 = Message.of(price,
+        Metadata.of(new PriceMetadata()),
+        () -> {
+            // Called when the message is acknowledged by the next consumer.
+            return CompletableFuture.completedFuture(null);
+        });
+
    +
    +

    Messages accept null as payload. +Channels connected to outbound connectors interpret messages with null payload differently depending on the technology. +
    1
+2
    // Create a message with null payload
+Message<Price> m6 = Message.of(null, Metadata.of(new PriceMetadata()));
+
    +

    +

    You can also create new instance of Message from an existing one:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    // Create a new message with a new payload but with the same metadata
+Message<Price> m1 = message.withPayload(new Price(12.4));
+
+// Create a new message with a new payload and add another metadata
+Message<Price> m2 = message
+        .withPayload(new Price(15.0))
+        .withMetadata(Metadata.of(new PriceMetadata()));
+
+// Create a new message with a new payload and a custom acknowledgement
+Message<Price> m3 = message
+        .withPayload(new Price(15.0))
+        .withAck(() ->
+        // acknowledge the incoming message
+        message.ack()
+                .thenAccept(x -> {
+                    // do something
+                }));
+
    +
    +
    +

    Acknowledgement?

    +
    +

    Acknowledgement is an important part of messaging systems. This will be +covered in the acknowledgement +section.

    +
    +

    Connector Metadata

    +
    +

    Most connectors are providing metadata to let you extract technical +details about the message, but also customize the outbound dispatching.

    +

    Generating Messages

    +

    To produce messages to a channel, you need to use the @Outgoing +annotation. This annotation takes a single parameter: the name of the +populated channel.

    +

    Generating messages synchronously

    +

    You can generate messages synchronously. In this case, the method is +called for every request from the downstream:

    +
    1
+2
+3
+4
    @Outgoing("my-channel")
+public Message<Integer> generateMessagesSynchronously() {
+    return Message.of(counter.getAndIncrement());
+}
+
    +
    +
    +

    Requests?

    +
    +

    Reactive Messaging connects components to build a reactive stream. +In a reactive stream, the emissions are controlled by the consumer +(downstream) indicating to the publisher (upstream) how many items it +can consume. With this protocol, the consumers are never flooded.

    +

    Generating messages using CompletionStage

    +

    You can also return a CompletionStage / CompletableFuture. +In this case, Reactive Messaging waits until the CompletionStage gets completed before calling it again.

    +

    For instance, this signature is useful to poll messages from a source using an asynchronous client:

    +
    1
+2
+3
+4
+5
    @Outgoing("my-channel")
+public CompletionStage<Message<Price>> generateMessagesAsCompletionStage() {
+    return asyncClient.poll()
+            .thenApply(Message::of);
+}
+
    +
    +

    Generating messages using Uni

    +

    You can also return a Uni instance. +In this case, Reactive Messaging waits until the Uni emits its item before calling it again.

    +

    This signature is useful when integrating asynchronous clients providing a Mutiny API.

    +
    1
+2
+3
+4
    @Outgoing("my-channel")
+public Uni<Message<Integer>> generateMessagesAsync() {
+    return Uni.createFrom().item(() -> Message.of(counter.getAndIncrement()));
+}
+
    +
    +

    Generating Reactive Streams of messages

    +

    Instead of producing the message one by one, you can return the stream +directly. If you have a data source producing Reactive Streams +Publisher (or sub-types, such as Multi), this is the signature you are looking for:

    +
    1
+2
+3
+4
    public Publisher<Message<String>> generateMessageStream() {
+    Multi<String> multi = reactiveClient.getStream();
+    return multi.map(Message::of);
+}
+
    +
    +

    In this case, the method is called once to retrieve the Publisher.

    +

    Generating Payloads

    +

    Instead of Message, you can produce payloads. In this case, Reactive +Messaging produces a simple message from the payload using +Message.of.

    +

    Generating payload synchronously

    +

    You can produce payloads synchronously. The framework calls the method +upon request and create Messages around the produced payloads.

    +
    1
+2
+3
+4
    @Outgoing("my-channel")
+public Integer generatePayloadsSynchronously() {
+    return counter.getAndIncrement();
+}
+
    +
    +

    Generating payload using CompletionStage

    +

    You can also return CompletionStage or CompletableFuture. For +example, if you have an asynchronous client returning CompletionStage, +you can use it as follows, to poll the data one by one:

    +
    1
+2
+3
+4
    @Outgoing("my-channel")
+public CompletionStage<Price> generatePayloadsAsCompletionStage() {
+    return asyncClient.poll();
+}
+
    +
    +

    Generating payload by producing Unis

    +

    You can also return a Uni if you have a client using Mutiny types:

    +
    1
+2
+3
+4
    @Outgoing("my-channel")
+public Uni<Integer> generatePayloadsAsync() {
+    return Uni.createFrom().item(() -> counter.getAndIncrement());
+}
+
    +
    +

    Generating Reactive Streams of payloads

    +

    Finally, you can return a Publisher (or a sub-type such as a Multi):

    +
    1
+2
+3
+4
+5
    @Outgoing("my-channel")
+public Multi<String> generatePayloadsStream() {
+    Multi<String> multi = reactiveClient.getStream();
+    return multi;
+}
+
    +
    +

    In this case, Reactive Messaging calls the method only once to retrieve +the Publisher.

    +

    Consuming Messages

    +

    To consume messages from a channel, you need to use the @Incoming +annotation. This annotation takes a single parameter: the name of the +consumed channel.

    +

    Because Messages must be acknowledged, consuming messages requires +returning asynchronous results that would complete when the incoming +message get acknowledged.

    +

    For example, you can receive the Message, process it and return the +acknowledgement as result:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("my-channel")
+public CompletionStage<Void> consumeMessage(Message<Price> message) {
+    handle(message.getPayload());
+    return message.ack();
+}
+'
+
    +
    +

    You can also return a Uni if you need to implement more complicated +processing:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("my-channel")
+public Uni<Void> consumeMessageUni(Message<Price> message) {
+    return Uni.createFrom().item(message)
+            .onItem().invoke(m -> handle(m.getPayload()))
+            .onItem().transformToUni(x -> Uni.createFrom().completionStage(message.ack()));
+}
+
    +
    +

    Consuming Payloads

    +

    Unlike consuming messages, consuming payloads support both synchronous +and asynchronous consumption.

    +

    For example, you can consume a payload as follows:

    +
    1
+2
+3
+4
    @Incoming("my-channel")
+public void consumePayload(Price payload) {
+    // do something
+}
+
    +
    +

    In this case, you don’t need to deal with the acknowledgement yourself. +The framework acknowledges the incoming message (that wrapped the +payload) once your method returns successfully.

    +

    If you need to achieve asynchronous actions, you can return a +CompletionStage or a Uni:

    +
    1
+2
+3
+4
+5
    @Incoming("my-channel")
+public CompletionStage<Void> consumePayloadCS(Price payload) {
+    CompletionStage<Void> cs = handleAsync(payload);
+    return cs;
+}
+
    +
    +
    1
+2
+3
+4
+5
+6
    @Incoming("my-channel")
+public Uni<Void> consumePayloadUni(Price payload) {
+    return Uni.createFrom().item(payload)
+            .onItem().invoke(this::handle)
+            .onItem().ignore().andContinueWithNull();
+}
+
    +
    +

    In these 2 cases, the framework acknowledges the incoming message when +the returned construct gets completed.

    +

    Processing Messages

    +

    You can process Message both synchronously or asynchronously. +This later case is useful when you need to execute an asynchronous action during your processing such as invoking a remote service.

    +

    Do process Messages synchronously uses:

    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public Message<String> processMessage(Message<Integer> in) {
+    return in.withPayload(Integer.toString(in.getPayload()));
+}
+
    +
    +

    This method transforms the int payload to a String, and wraps it +into a Message.

    +

    '''important "Using Message.withX methods" +You may be surprised by the usage of Message.withX methods. It allows +metadata propagation as the metadata would be copied from the incoming +message and so dispatched to the next method.

    +

    You can also process Messages asynchronously:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("in")
+@Outgoing("out")
+public CompletionStage<Message<String>> processMessageCS(Message<Integer> in) {
+    CompletionStage<String> cs = invokeService(in.getPayload());
+    return cs.thenApply(in::withPayload);
+}
+
    +
    +

    Or using Mutiny:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("in")
+@Outgoing("out")
+public Uni<Message<String>> processMessageUni(Message<String> in) {
+    return invokeService(in.getPayload())
+            .map(in::withPayload);
+}
+
    +
    +

    In general, you want to create the new Message from the incoming one. +It enables metadata propagation and post-acknowledgement. For this, use +the withX method from the Message class returning a new Message +instance but copy the content (metadata, ack/nack...).

    +

    Processing payloads

    +

    If you don’t need to manipulate the envelope, you can process payload +directly either synchronously or asynchronously:

    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public String processPayload(int in) {
+    return Integer.toString(in);
+}
+
    +
    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public CompletionStage<String> processPayloadCS(int in) {
+    return invokeService(in);
+}
+
    +
    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public Uni<String> processPayload(String in) {
+    return invokeService(in);
+}
+
    +
    +
    +

    What about metadata?

    +
    +

    With these methods, the metadata are automatically propagated.

    +

    Processing streams

    +

    The previous processing method were taking single Message or payload. +Sometimes you need more advanced manipulation. For this, SmallRye +Reactive Messaging lets you process the stream of Message or the +stream of payloads directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
    @Incoming("in")
+@Outgoing("out")
+public Multi<Message<String>> processMessageStream(Multi<Message<Integer>> stream) {
+    return stream
+            .onItem().transformToUni(message -> invokeService(message.getPayload())
+                    .onFailure().recoverWithItem("fallback")
+                    .onItem().transform(message::withPayload))
+            .concatenate();
+
+}
+
    +
    +
    1
+2
+3
+4
+5
+6
+7
+8
+9
    @Incoming("in")
+@Outgoing("out")
+public Multi<String> processPayloadStream(Multi<Integer> stream) {
+    return stream
+            .onItem().transformToUni(payload -> invokeService(payload)
+                    .onFailure().recoverWithItem("fallback"))
+            .concatenate();
+
+}
+
    +
    +

    You can receive either a (Reactive Streams) Publisher, a +PublisherBuilder or (Mutiny) Multi. You can return any subclass of +Publisher or a Publisher directly.

    +
    +

    Important

    +
    +

    These signatures do not support metadata propagation. In the case of a +stream of Message, you need to propagate the metadata manually. In the +case of a stream of payload, propagation is not supported, and incoming +metadata are lost.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/signatures/index.html b/3.25.0/concepts/signatures/index.html new file mode 100644 index 0000000000..a868266785 --- /dev/null +++ b/3.25.0/concepts/signatures/index.html @@ -0,0 +1,1807 @@ + + + + + + + + + + + + + + + + + + Method Signatures - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Supported signatures

    +

    The following tables list the supported method signatures and indicate +the various supported features. For instance, they indicate the default +and available acknowledgement strategies (when applicable).

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    SignatureInvocation time
    @Outgoing Publisher<Message<O>> method() `Called once at assembly time
    @Outgoing Publisher<O> method() `Called once at assembly time
    @Outgoing Multi<Message<O>> method() `Called once at assembly time
    @Outgoing Multi<O> method() `Called once at assembly time
    @Outgoing PublisherBuilder<Message<O>> method() `Called once at assembly time
    @Outgoing PublisherBuilder<O> method() `Called once at assembly time
    @Outgoing Message<O> method() `Called for every downstream request, sequentially
    @Outgoing O method() `Called for every downstream request, sequentially
    @Outgoing CompletionStage<Message<O>> method() `Called for every downstream request, sequentially (After the completion of the last returned CompletionStage)
    @Outgoing CompletionStage<O> method() `Called for every downstream request, , sequentially (After the completion of the last returned CompletionStage)
    @Outgoing Uni<Message<O>> method() `Called for every downstream request, sequentially (After the completion of the last returned Uni)
    @Outgoing Uni<O> method() `Called for every downstream request, , sequentially (After the completion of the last returned Uni)
    +

    Method signatures to generate data

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    SignatureInvocation timeSupported Acknowledgement Strategies
    @Incoming void method(I p)Called for every incoming payload (sequentially)POST_PROCESSING, NONE, PRE_PROCESSING
    @Incoming CompletionStage<?> method(Message<I> msg)Called for every incoming message (sequentially)MANUAL, NONE, PRE_PROCESSING
    @Incoming CompletionStage<?> method(I p)Called for every incoming payload (sequentially)POST_PROCESSING, PRE_PROCESSING, NONE
    @Incoming Uni<?> method(Message<I> msg)Called for every incoming message (sequentially)MANUAL, NONE, PRE_PROCESSING
    @Incoming Uni<?> method(I p)Called for every incoming payload (sequentially)POST_PROCESSING, PRE_PROCESSING, NONE
    @Incoming Subscriber<Message<I>> method()Called once at assembly timeMANUAL, POST_PROCESSING, NONE, PRE_PROCESSING
    @Incoming Subscriber<I> method()Called once at assembly timePOST_PROCESSING, NONE, PRE_PROCESSING
    +

    Method signatures to consume data

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    SignatureInvocation timeSupported Acknowledgement StrategiesMetadata Propagation
    @Outgoing @Incoming Message<O> method(Message<I> msg)Called for every incoming message (sequentially)MANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming O method(I payload)Called for every incoming payload (sequentially)POST_PROCESSING, NONE, PRE_PROCESSINGautomatic
    @Outgoing @Incoming CompletionStage<Message<O>> method(Message<I> msg)Called for every incoming message (sequentially)MANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming CompletionStage<O> method(I payload)Called for every incoming payload (sequentially)POST_PROCESSING, NONE, PRE_PROCESSINGautomatic
    @Outgoing @Incoming Uni<Message<O>> method(Message<I> msg)Called for every incoming message (sequentially)MANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming Uni<O> method(I payload)Called for every incoming payload (sequentially)POST_PROCESSING, NONE, PRE_PROCESSINGautomatic
    @Outgoing @Incoming Processor<Message<I>, Message<O>> method()Called once at assembly timeMANUAL, PRE_PROCESSING, NONEmanual
    @Outgoing @Incoming Processor<I, O> method()Called once at assembly timePRE_PROCESSING, NONEnot supported
    @Outgoing @Incoming ProcessorBuilder<Message<I>, Message<O>> method()Called once at assembly timeMANUAL, PRE_PROCESSING, NONEmanual
    @Outgoing @Incoming ProcessorBuilder<I, O> method()Called once at assembly timePRE_PROCESSING, NONEnot supported
    @Outgoing @Incoming Publisher<Message<O>> method(Message<I> msg)Called once at assembly timeMANUAL, PRE_PROCESSING, NONEmanual
    @Outgoing @Incoming Publisher<O> method(I payload)Called once at assembly timePRE_PROCESSING, NONEautomatic
    @Outgoing @Incoming Multi<Message<O>> method(Message<I> msg)Called once at assembly timeMANUAL, PRE_PROCESSING, NONEmanual
    @Outgoing @Incoming Multi<O> method(I payload)Called once at assembly timePRE_PROCESSING, NONEautomatic
    @Outgoing @Incoming PublisherBuilder<Message<O>> method(Message<I> msg)Called once at assembly timeMANUAL, PRE_PROCESSING, NONEmanual
    @Outgoing @Incoming PublisherBuilder<O> method(I payload)Called once at assembly timePRE_PROCESSING, NONEautomatic
    +

    Method signatures to process data

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    SignatureInvocation timeSupported Acknowledgement StrategiesMetadata Propagation
    @Outgoing @Incoming Publisher<Message<O>> method(Publisher<Message<I>> pub)Called once at assembly timeMANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming Publisher<O> method(Publisher<I> pub)Called once at assembly timePRE_PROCESSING, NONEnot supported
    @Outgoing @Incoming Multi<Message<O>> method(Multi<Message<I>> pub)Called once at assembly timeMANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming Multi<O> method(Multi<I> pub)Called once at assembly timePRE_PROCESSING, NONEnot supported
    @Outgoing @Incoming PublisherBuilder<Message<O>> method(PublisherBuilder<Message<I>> pub)Called once at assembly timeMANUAL, NONE, PRE_PROCESSINGmanual
    @Outgoing @Incoming PublisherBuilder<O> method(PublisherBuilder<I> pub)Called once at assembly timeNONE, PRE_PROCESSINGnot supported
    +

    Method signatures to manipulate streams

    +
    +

    Important

    +

    When processing Message, it is often required to chain the incoming +Message to enable post-processing acknowledgement and metadata +propagation. Use the with (like withPayload) methods from the +incoming message, so it copies the metadata and ack/nack methods. It +returns a new Message with the right content.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/skipping/index.html b/3.25.0/concepts/skipping/index.html new file mode 100644 index 0000000000..e7d852ea9a --- /dev/null +++ b/3.25.0/concepts/skipping/index.html @@ -0,0 +1,1761 @@ + + + + + + + + + + + + + + + + + + Skipping Messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Skipping messages

    +

    Sometimes you receive a message and don’t want to produce an output +message. To handle this, you have several choices:

    +
      +
    1. for method processing single message or payload, producing null + would produce an ignored message (not forwarded)
      2. +
    2. for method processing streams, you can generate an empty stream.
      3. +
    +

    Skipping a single item

    +

    To skip a single message or payload, return null:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
    // Skip when processing payload synchronously - returning `null`
+@Incoming("in")
+@Outgoing("out")
+public String processPayload(String s) {
+    if (s.equalsIgnoreCase("skip")) {
+        return null;
+    }
+    return s.toUpperCase();
+}
+
+// Skip when processing message synchronously - returning `null`
+@Incoming("in")
+@Outgoing("out")
+public Message<String> processMessage(Message<String> m) {
+    String s = m.getPayload();
+    if (s.equalsIgnoreCase("skip")) {
+        m.ack();
+        return null;
+    }
+    return m.withPayload(s.toUpperCase());
+}
+
+// Skip when processing payload asynchronously - returning a `Uni` with a `null` value
+@Incoming("in")
+@Outgoing("out")
+public Uni<String> processPayloadAsync(String s) {
+    if (s.equalsIgnoreCase("skip")) {
+        // Important, you must not return `null`, but a `null` content
+        return Uni.createFrom().nullItem();
+    }
+    return Uni.createFrom().item(s.toUpperCase());
+}
+
+// Skip when processing message asynchronously - returning a `Uni` with a `null` value
+@Incoming("in")
+@Outgoing("out")
+public Uni<Message<String>> processMessageAsync(Message<String> m) {
+    String s = m.getPayload();
+    if (s.equalsIgnoreCase("skip")) {
+        m.ack();
+        return Uni.createFrom().nullItem();
+    }
+    return Uni.createFrom().item(m.withPayload(s.toUpperCase()));
+}
+
    +
    +

    Skipping in a stream

    +

    To skip a message or payload when manipulating a stream, emit an empty Multi (or Publisher):

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
    @Incoming("in")
+@Outgoing("out-1")
+public Multi<String> processPayload(String s) {
+    if (s.equalsIgnoreCase("skip")) {
+        return Multi.createFrom().empty();
+    }
+    return Multi.createFrom().item(s.toUpperCase());
+}
+
+@Incoming("in")
+@Outgoing("out-2")
+public Multi<Message<String>> processMessage(Message<String> m) {
+    String s = m.getPayload();
+    if (s.equalsIgnoreCase("skip")) {
+        return Multi.createFrom().empty();
+    }
+    return Multi.createFrom().item(m.withPayload(s.toUpperCase()));
+}
+
+@Incoming("in")
+@Outgoing("out-3")
+public Multi<String> processPayloadStream(Multi<String> stream) {
+    return stream
+            .select().where(s -> !s.equalsIgnoreCase("skip"))
+            .onItem().transform(String::toUpperCase);
+}
+
+@Incoming("in")
+@Outgoing("out-4")
+public Multi<Message<String>> processMessageStream(Multi<Message<String>> stream) {
+    return stream
+            .select().where(m -> !m.getPayload().equalsIgnoreCase("skip"))
+            .onItem().transform(m -> m.withPayload(m.getPayload().toUpperCase()));
+}
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/concepts/testing/index.html b/3.25.0/concepts/testing/index.html new file mode 100644 index 0000000000..91e6df5f3b --- /dev/null +++ b/3.25.0/concepts/testing/index.html @@ -0,0 +1,1700 @@ + + + + + + + + + + + + + + + + + + Testing - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Testing your application

    +

    It’s not rare to have to test your application but deploying the +infrastructure can be cumbersome. While Docker or Test Containers have +improved the testing experience, you may want to mock this +infrastructure.

    +

    SmallRye Reactive Messaging proposes an in-memory connector for this +exact purpose. It allows switching the connector used for a channel with +an in-memory connector. This in-memory connector provides a way to +send messages to incoming channels, or check the received messages for +outgoing channels.

    +

    To use the in-memory connector, you need to add the following +dependency to your project:

    +
    1
+2
+3
+4
+5
+6
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-in-memory</artifactId>
+  <version>3.25.0</version>
+  <scope>test</scope>
+</dependency>
+
    +
    +

    Then, in a test, you can do something like:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
    package testing;
+
+import javax.enterprise.inject.Any;
+import javax.inject.Inject;
+
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+
+import io.smallrye.reactive.messaging.providers.connectors.InMemoryConnector;
+import io.smallrye.reactive.messaging.providers.connectors.InMemorySink;
+import io.smallrye.reactive.messaging.providers.connectors.InMemorySource;
+
+public class MyTest {
+
+    // 1. Switch the channels to the in-memory connector:
+    @BeforeAll
+    public static void switchMyChannels() {
+        InMemoryConnector.switchIncomingChannelsToInMemory("prices");
+        InMemoryConnector.switchOutgoingChannelsToInMemory("processed-prices");
+    }
+
+    // 2. Don't forget to reset the channel after the tests:
+    @AfterAll
+    public static void revertMyChannels() {
+        InMemoryConnector.clear();
+    }
+
+    // 3. Inject the in-memory connector in your test,
+    // or use the bean manager to retrieve the instance
+    @Inject
+    @Any
+    InMemoryConnector connector;
+
+    @Test
+    void test() {
+        // 4. Retrieves the in-memory source to send message
+        InMemorySource<Integer> prices = connector.source("prices");
+        // 5. Retrieves the in-memory sink to check what is received
+        InMemorySink<Integer> results = connector.sink("processed-prices");
+
+        // 6. Send fake messages:
+        prices.send(1);
+        prices.send(2);
+        prices.send(3);
+
+        // 7. Check you have received the expected messages
+        Assertions.assertEquals(3, results.received().size());
+    }
+}
+
    +
    +

    When switching a channel to the in-memory connector, all the +configuration properties are ignored.

    +
    +

    Important

    +

    This connector has been designed for testing purpose only.

    +
    +

    The switch methods return Map<String, String> instances containing +the set properties. While these system properties are already set, you +can retrieve them and pass them around, for example if you need to start +an external process with these properties:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
    public Map<String, String> start() {
+    Map<String, String> env = new HashMap<>();
+    env.putAll(InMemoryConnector.switchIncomingChannelsToInMemory("prices"));
+    env.putAll(InMemoryConnector.switchOutgoingChannelsToInMemory("my-data-stream"));
+    return env;
+}
+
+public void stop() {
+    InMemoryConnector.clear();
+}
+
    +
    +
    +

    Note

    +

    The in-memory connector support the broadcast and merge attributes. +So, if your connector is configured with broadcast: true, the +connector broadcasts the messages to all the channel consumers. If your +connector is configured with merge:true, the connector receives all +the messages sent to the mapped channel even when coming from multiple +producers.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/css/smallrye.css b/3.25.0/css/smallrye.css new file mode 100644 index 0000000000..8312686854 --- /dev/null +++ b/3.25.0/css/smallrye.css @@ -0,0 +1,21 @@ +.md-typeset figcaption { + color: var(--md-primary-fg-color); + font-style: normal !important; + font-variant: all-petite-caps; + font-weight: bold; + margin-bottom: 0; +} + +figure { + /*border: 1px solid var(--md-primary-fg-color);*/ + /*border-radius: 5px;*/ + padding: 10px; +} + +.md-typeset a { + color: dodgerblue; +} + +.no-hyphens { + hyphens: none; +} diff --git a/3.25.0/getting-started/index.html b/3.25.0/getting-started/index.html new file mode 100644 index 0000000000..73270f0c70 --- /dev/null +++ b/3.25.0/getting-started/index.html @@ -0,0 +1,1645 @@ + + + + + + + + + + + + + + + + + + Getting Started - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Getting Started

    +

    The easiest way to start using SmallRye Reactive Messaging is from Quarkus. +SmallRye Reactive Messaging can also be used standalone, or with Open Liberty.

    +

    First, go to code.quarkus.io. +Select the smallrye-reactive-messaging extension (already done if you use the link), and then click on the generate button to download the code.

    +

    One downloaded, unzip the project and import it in your IDE.

    +

    If you look at the pom.xml file, you will see the following dependency:

    +
    1
+2
+3
+4
     <dependency>
+    <groupId>io.quarkus</groupId>
+    <artifactId>quarkus-smallrye-reactive-messaging</artifactId>
+</dependency>
+
    +
    +

    It provides the support for SmallRye Reactive Messaging.

    +

    Ok, so far so good, but we need event-driven beans.

    +

    Create the quickstart package, and copy the following class into it:

    +

    For instance:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
    package quickstart;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class ReactiveMessagingExample {
+
+    @Outgoing("source")
+    public Multi<String> source() {
+        return Multi.createFrom().items("hello", "from", "SmallRye", "reactive", "messaging");
+    }
+
+    @Incoming("source")
+    @Outgoing("processed-a")
+    public String toUpperCase(String payload) {
+        return payload.toUpperCase();
+    }
+
+    @Incoming("processed-a")
+    @Outgoing("processed-b")
+    public Multi<String> filter(Multi<String> input) {
+        return input.select().where(item -> item.length() > 4);
+    }
+
+    @Incoming("processed-b")
+    public void sink(String word) {
+        System.out.println(">> " + word);
+    }
+
+}
+
    +
    +

    This class contains a set of methods:

    +
      +
    • producing messages (source)
      • +
    • processing messages (toUpperCase)
      • +
    • transforming the stream by skipping messages (filter)
      • +
    • consuming messages (sink)
      • +
    +

    Each of these methods are connected through channels.

    +

    Now, let's see this in action. +For the terminal, run:

    +
    1
    > ./mvnw quarkus:dev
+
    +
    +

    Running the previous example should give the following output:

    +
    1
+2
+3
+4
    >> HELLO
+>> SMALLRYE
+>> REACTIVE
+>> MESSAGE
+
    +
    +

    Of course, this is a very simple example. +To go further, let's have a look to the core concepts behind SmallRye Reactive Messaging.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/images/chain.png b/3.25.0/images/chain.png new file mode 100644 index 0000000000..eacfc241c0 Binary files /dev/null and b/3.25.0/images/chain.png differ diff --git a/3.25.0/images/channels.png b/3.25.0/images/channels.png new file mode 100644 index 0000000000..8b2052ce4d Binary files /dev/null and b/3.25.0/images/channels.png differ diff --git a/3.25.0/images/connectors.png b/3.25.0/images/connectors.png new file mode 100644 index 0000000000..ebd50c3024 Binary files /dev/null and b/3.25.0/images/connectors.png differ diff --git a/3.25.0/images/favicon.png b/3.25.0/images/favicon.png new file mode 100644 index 0000000000..93f705b9cf Binary files /dev/null and b/3.25.0/images/favicon.png differ diff --git a/3.25.0/images/incoming.png b/3.25.0/images/incoming.png new file mode 100644 index 0000000000..69e57a8b32 Binary files /dev/null and b/3.25.0/images/incoming.png differ diff --git a/3.25.0/images/logo.png b/3.25.0/images/logo.png new file mode 100644 index 0000000000..2d957bd527 Binary files /dev/null and b/3.25.0/images/logo.png differ diff --git a/3.25.0/images/message.png b/3.25.0/images/message.png new file mode 100644 index 0000000000..fb38e78b06 Binary files /dev/null and b/3.25.0/images/message.png differ diff --git a/3.25.0/images/messages.png b/3.25.0/images/messages.png new file mode 100644 index 0000000000..c0b37e6a29 Binary files /dev/null and b/3.25.0/images/messages.png differ diff --git a/3.25.0/images/outgoing.png b/3.25.0/images/outgoing.png new file mode 100644 index 0000000000..f5aaef29d9 Binary files /dev/null and b/3.25.0/images/outgoing.png differ diff --git a/3.25.0/images/overview.png b/3.25.0/images/overview.png new file mode 100644 index 0000000000..42e00e4412 Binary files /dev/null and b/3.25.0/images/overview.png differ diff --git a/3.25.0/images/processor.png b/3.25.0/images/processor.png new file mode 100644 index 0000000000..faac01281b Binary files /dev/null and b/3.25.0/images/processor.png differ diff --git a/3.25.0/images/redhat_reversed.svg b/3.25.0/images/redhat_reversed.svg new file mode 100644 index 0000000000..37fe83c48d --- /dev/null +++ b/3.25.0/images/redhat_reversed.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/3.25.0/index.html b/3.25.0/index.html new file mode 100644 index 0000000000..0766254723 --- /dev/null +++ b/3.25.0/index.html @@ -0,0 +1,1524 @@ + + + + + + + + + + + + + + + + + + SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    SmallRye Reactive Messaging

    +

    SmallRye Reactive Messaging is a framework for building event-driven, data streaming, and event-sourcing applications.

    +

    It lets your application interact using various messaging technologies such as Apache Kafka, AMQP or MQTT. +The framework provides a flexible programming model bridging CDI and event-driven.

    +

    SmallRye Reactive Messaging is an implementation of the Eclipse MicroProfile Reactive Messaging specification 2.0.1.

    +
    + Event-Driven Architectures +
    Event-Driven Architectures
    +
    + +

    SmallRye Reactive Messaging is used in Quarkus, and Open Liberty.

    +

    Start with the Getting Started guide to know how it can be used and introduce various features.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/jms/advanced-jms/index.html b/3.25.0/jms/advanced-jms/index.html new file mode 100644 index 0000000000..1a93d29259 --- /dev/null +++ b/3.25.0/jms/advanced-jms/index.html @@ -0,0 +1,1626 @@ + + + + + + + + + + + + + + + + + + Advanced configuration - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Advanced configuration

    +

    Underlying thread pool

    +

    Lots of JMS operations are blocking and so not cannot be done on the +caller thread. For this reason, these blocking operations are executed +on a worker thread.

    +

    You can configure the thread pool providing these worker threads using +the following MicroProfile Config properties:

    +
      +
    • +

      smallrye.jms.threads.max-pool-size - the max number of threads + (Defaults to 10)

      +
      • +
    • +

      smallrye.jms.threads.ttl - the ttl of the created threads + (Defaults to 60 seconds)

      +
      • +
    +

    Selecting the ConnectionFactory

    +

    The JMS Connector requires a javax.jms.ConnectionFactory to be exposed +as a CDI bean. The connector looks for a javax.jms.ConnectionFactory +and delegate the interaction with the JMS server to this factory.

    +

    In case you have several connection factories, you can use the +@Identifier qualifier on your factory to specify the name. Then, in +the channel configuration, configure the name as follows:

    +
    1
+2
+3
+4
+5
+6
    # Configure the connector globally
+mp.messaging.connector.smallrye-jms.connection-factory-name=my-factory-name
+# Configure a specific incoming channel
+mp.messaging.incoming.my-channel.connection-factory-name=my-factory-name
+# Configure a specific outgoing channel
+mp.messaging.outgoing.my-channel.connection-factory-name=my-factory-name
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/jms/jms/index.html b/3.25.0/jms/jms/index.html new file mode 100644 index 0000000000..4bc3f30e15 --- /dev/null +++ b/3.25.0/jms/jms/index.html @@ -0,0 +1,1610 @@ + + + + + + + + + + + + + + + + + + The JMS connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    The JMS connector

    +

    The JMS connector adds support for Jakarta +Messaging to Reactive +Messaging. It is designed to integrate with JakartaEE applications +that are sending or receiving Jakarta Messaging Messages.

    +

    Jakarta Messaging is a Java Message Oriented Middleware API for sending +messages between two or more clients. It is a programming model to +handle the producer-consumer messaging problem. It is a messaging +standard that allows application components based on Jakarta EE to +create, send, receive, and read messages. It allows the communication +between different components of a distributed application to be loosely +coupled, reliable, and asynchronous.

    +

    Using the JMS connector

    +

    To you the JMS Connector, add the following dependency to your project:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-jms</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
    +
    +

    The connector name is: smallrye-jms.

    +

    So, to indicate that a channel is managed by this connector you need:

    +
    1
+2
+3
+4
+5
    # Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-jms
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-jms
+
    +
    +

    The JMS Connector requires a javax.jms.ConnectionFactory to be exposed +(as CDI bean). The connector looks for a javax.jms.ConnectionFactory +and delegate the interaction with the JMS server to this factory. In +other words, it creates the JMS connection and context using this +factory.

    +

    So, in order to use this connector you would need to expose a +javax.jms.ConnectionFactory:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    import javax.enterprise.context.ApplicationScoped;
+import javax.enterprise.inject.Produces;
+import javax.jms.ConnectionFactory;
+
+import org.apache.activemq.artemis.jms.client.ActiveMQJMSConnectionFactory;
+
+@ApplicationScoped
+public class ConnectionFactoryBean {
+
+    @Produces
+    ConnectionFactory factory() {
+        return new ActiveMQJMSConnectionFactory(
+                "tcp://localhost:61616",
+                null, null);
+    }
+
+}
+
    +
    +

    The factory class may depend on your JMS connector/server.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/jms/receiving-jms-messages/index.html b/3.25.0/jms/receiving-jms-messages/index.html new file mode 100644 index 0000000000..aee81aa685 --- /dev/null +++ b/3.25.0/jms/receiving-jms-messages/index.html @@ -0,0 +1,1866 @@ + + + + + + + + + + + + + + + + + + Receiving JMS messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Receiving messages from JMS

    +

    The JMS Connector retrieves JMS Message and maps each of them into +Reactive Messaging Messages.

    +

    Example

    +

    Let’s imagine you have a javax.jms.ConnectionFactory bean exposed and +connected to your JMS server. Don’t forget that it’s required to use the +JMS connector.

    +

    Configure your application to receive JMS messages on the prices +channel as follows:

    +
    1
    mp.messaging.incoming.prices.connector=smallrye-jms
+
    +
    +
    +

    Note

    +

    You don’t need to set the destination. By default, it uses the channel +name (prices). You can configure the destination attribute to +override it.

    +
    +
    +

    Note

    +

    By default the connector uses a queue. You can configure it to use a +topic by setting destination-type=topic.

    +
    +

    Then, your application receives Message<Double>. You can consume the +payload directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    package jms.inbound;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class JmsPriceConsumer {
+
+    @Incoming("prices")
+    public void consume(double price) {
+        // process your price.
+    }
+
+}
+
    +
    +

    Or, you can retrieve the Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
    package jms.inbound;
+
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class JmsPriceMessageConsumer {
+
+    @Incoming("prices")
+    public CompletionStage<Void> consume(Message<Double> price) {
+        // process your price.
+
+        // Acknowledge the incoming message
+        return price.ack();
+    }
+
+}
+
    +
    +

    Deserialization

    +

    The content of the incoming JMS message is mapped to a Java object.

    +

    By default it extracts the JMS Message body as a java.lang.Object. +This can be changed by setting, in the incoming JMS Message:

    +
      +
    1. +

      The _classname property

      +
      2. +
    2. +

      the JMSType

      +
      3. +
    +

    The value must be a fully qualified class name. The connector then load +the associated class.

    +
    +

    Note

    +

    The connector loads the associated Class using the TCCL and if not +found, the classloader used to load the connector.

    +
    +

    If the target type is a primitive type ort String, the resulting +message contains the mapped payload.

    +

    If the target type is a class, the object is built using included JSON +deserializer (JSON-B and Jackson provided OOB, for more details see +Serde), from the JMSType. If not, the default behavior is +used (Java deserialization).

    +

    Inbound Metadata

    +

    Messages coming from JMS contains an instance of io.smallrye.reactive.messaging.jms.IncomingJmsMessageMetadata in the metadata.

    +
    1
+2
+3
+4
+5
+6
    Optional<IncomingJmsMessageMetadata> metadata = incoming.getMetadata(IncomingJmsMessageMetadata.class);
+metadata.ifPresent(meta -> {
+    long expiration = meta.getExpiration();
+    Destination destination = meta.getDestination();
+    String value = meta.getStringProperty("my-property");
+});
+
    +
    +

    Acknowledgement

    +

    When the Reactive Messaging Message gets acknowledged, the associated +JMS Message is acknowledged. As JMS acknowledgement is blocking, this +acknowledgement is delegated to a worker thread.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    broadcastWhether or not the JMS message should be dispatched to multiple consumersbooleanfalsefalse
    client-idThe client idStringfalse
    connection-factory-nameThe name of the JMS connection factory (javax.jms.ConnectionFactory) to be used. If not set, it uses any exposed JMS connection factoryStringfalse
    destinationThe name of the JMS destination. If not set the name of the channel is usedStringfalse
    destination-typeThe type of destination. It can be either queue or topicstringfalsequeue
    durableSet to true to use a durable subscriptionbooleanfalsefalse
    no-localEnable or disable local deliverybooleanfalsefalse
    passwordThe password to connect to to the JMS serverStringfalse
    selectorThe JMS selectorStringfalse
    session-modeThe session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGEStringfalseAUTO_ACKNOWLEDGE
    usernameThe username to connect to to the JMS serverStringfalse
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/jms/sending-jms-messages/index.html b/3.25.0/jms/sending-jms-messages/index.html new file mode 100644 index 0000000000..911f1add57 --- /dev/null +++ b/3.25.0/jms/sending-jms-messages/index.html @@ -0,0 +1,1945 @@ + + + + + + + + + + + + + + + + + + Sending JMS messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Sending messages to JMS

    +

    The JMS Connector can send Reactive Messaging Messages as JMS Message.

    +

    Example

    +

    Let’s imagine you have a javax.jms.ConnectionFactory bean exposed and +connected to your JMS server. Don’t forget that it’s required to use the +JMS connector.

    +

    Configure your application to write the messages from the prices +channel into a JMS Message as follows:

    +
    1
    mp.messaging.outgoing.prices.connector=smallrye-jms
+
    +
    +
    +

    Note

    +

    You don’t need to set the destination. By default, it uses the channel +name (prices). You can configure the destination attribute to +override it.

    +
    +
    +

    Note

    +

    By default the connector uses a queue. You can configure it to use a +topic by setting destination-type=topic.

    +
    +

    Then, your application must send Message<Double> to the prices +channel. It can use double payloads as in the following snippet:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    package jms.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class JmsPriceProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Double> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble());
+    }
+
+}
+
    +
    +

    Or, you can send Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
    package jms.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class JmsPriceMessageProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Message<Double>> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> Message.of(random.nextDouble()));
+    }
+
+}
+
    +
    +

    Serialization

    +

    The connector serializes the incoming message payload into the body of +the outgoing JMS Message.

    +

    If the payload is a String or a primitive type, the payload is encoded +as String and the JMSType is set to the target class. The +_classname property is also set. The JMS Message is a TextMessage.

    +

    If the payload is a byte[], it’s passed as byte[] in a JMS +BytesMessage.

    +

    Otherwise, the payload is encoded using included JSON serializer (JSON-B +and Jackson provided OOB, for more details see Serde). The +JMSType is set to the target class. The _classname property is also +set. The JMS Message is a TextMessage.

    +

    For example, the following code serialize the produced Person using +JSON-B.

    +
    1
+2
+3
+4
+5
+6
    @Incoming("...")
+@Outgoing("my-channel")
+public Person sendToJms(...) {
+  // ...
+  return new Person("bob", 42);
+}
+
    +
    +

    It requires that the Person class can be serialized to JSON. The +classname is passed in the JMSType property and _classname property.

    +

    Outbound Metadata

    +

    When sending Messages, you can add an instance of OutgoingJmsMessageMetadata +to influence how the message is going to be written to JMS.

    +
    1
+2
+3
+4
+5
+6
+7
    OutgoingJmsMessageMetadata metadata = OutgoingJmsMessageMetadata.builder()
+        .withProperties(JmsProperties.builder().with("some-property", "some-value").build())
+        .build();
+
+// Create a new message from the `incoming` message
+// Add `metadata` to the metadata from the `incoming` message.
+return incoming.addMetadata(metadata);
+
    +
    +

    The metadata allow adding properties but also override the destination.

    +

    Acknowledgement

    +

    Once the JMS message is sent to the JMS server, the message is +acknowledged. Sending a JMS message is a blocking operation. So, sending +is done on a worker thread.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    client-idThe client idStringfalse
    connection-factory-nameThe name of the JMS connection factory (javax.jms.ConnectionFactory) to be used. If not set, it uses any exposed JMS connection factoryStringfalse
    correlation-idThe JMS Message correlation idstringfalse
    delivery-delayThe delivery delaylongfalse
    delivery-modeThe delivery mode. Either persistent or non_persistentstringfalse
    destinationThe name of the JMS destination. If not set the name of the channel is usedStringfalse
    destination-typeThe type of destination. It can be either queue or topicstringfalsequeue
    disable-message-idOmit the message id in the outbound JMS messagebooleanfalse
    disable-message-timestampOmit the message timestamp in the outbound JMS messagebooleanfalse
    mergeWhether the connector should allow multiple upstreamsbooleanfalsefalse
    passwordThe password to connect to to the JMS serverStringfalse
    priorityThe JMS Message priorityintfalse
    reply-toThe reply to destination if anystringfalse
    reply-to-destination-typeThe type of destination for the response. It can be either queue or topicstringfalsequeue
    session-modeThe session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGEStringfalseAUTO_ACKNOWLEDGE
    ttlThe JMS Message time-to-livelongfalse
    usernameThe username to connect to to the JMS serverStringfalse
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/avro-configuration/index.html b/3.25.0/kafka/avro-configuration/index.html new file mode 100644 index 0000000000..af9dfd906e --- /dev/null +++ b/3.25.0/kafka/avro-configuration/index.html @@ -0,0 +1,1950 @@ + + + + + + + + + + + + + + + + + + Using Avro - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Using Apache Avro serializer/deserializer

    +

    If you are using Apache Avro +serializer/deserializer, please note the following configuration +properties.

    +

    For Confluent Schema Registry

    +

    Confluent Avro library is io.confluent:kafka-avro-serializer. Note +that this library is not available in Maven Central, you need to use the +Confluent Maven +repository.

    +

    Consumer

    + + + + + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.deserializerio.confluent.kafka.serializers.KafkaAvroDeserializer
    schema.registry.urlhttp://{your_host}:{your_port}/
    specific.avro.readertrue
    +

    Example:

    +
    1
+2
+3
    mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.KafkaAvroDeserializer
+mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/
+mp.messaging.incoming.[channel].specific.avro.reader=true
+
    +
    +

    Producer

    + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.serializerio.confluent.kafka.serializers.KafkaAvroSerializer
    schema.registry.urlhttp://{your_host}:{your_port}/
    +

    Example:

    +
    1
+2
    mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.KafkaAvroSerializer
+mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/
+
    +
    +

    For Apicurio Registry 1.x

    +

    Apicurio Registry 1.x Avro library is +io.apicurio:apicurio-registry-utils-serde.

    +

    The configuration properties listed here are meant to be used with the +Apicurio Registry 1.x client library and Apicurio Registry 1.x server.

    +

    Consumer

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.deserializerio.apicurio.registry.utils.serde.AvroKafkaDeserializer
    apicurio.registry.urlhttp://{your_host}:{your_port}/api
    apicurio.registry.avro-datum-providerio.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider
    apicurio.registry.use-specific-avro-readertrue
    +

    Example:

    +
    1
+2
+3
+4
    mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.utils.serde.AvroKafkaDeserializer
+mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api
+mp.messaging.incoming.[channel].apicurio.registry.avro-datum-provider=io.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider
+mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true
+
    +
    +

    Producer

    + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.serializerio.apicurio.registry.utils.serde.AvroKafkaSerializer
    apicurio.registry.urlhttp://{your_host}:{your_port}/api
    +

    To automatically register schemas with the registry, add:

    + + + + + + + + + + + + + +
    PropertyValue
    apicurio.registry.global-idio.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy
    +

    Example:

    +
    1
+2
+3
    mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.utils.serde.AvroKafkaSerializer
+mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api
+mp.messaging.outgoing.[channel].apicurio.registry.global-id=io.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy
+
    +
    +

    For Apicurio Registry 2.x

    +

    Apicurio Registry 2.x Avro library is +io.apicurio:apicurio-registry-serdes-avro-serde.

    +

    The configuration properties listed here are meant to be used with the +Apicurio Registry 2.x client library and Apicurio Registry 2.x server.

    +

    Consumer

    + + + + + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.deserializerio.apicurio.registry.serde.avro.AvroKafkaDeserializer
    apicurio.registry.urlhttp://{your_host}:{your_port}/apis/registry/v2
    apicurio.registry.use-specific-avro-readertrue
    +

    Example:

    +
    1
+2
+3
    mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.serde.avro.AvroKafkaDeserializer
+mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2
+mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true
+
    +
    +

    Producer

    + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.serializerio.apicurio.registry.serde.avro.AvroKafkaSerializer
    apicurio.registry.urlhttp://{your_host}:{your_port}/apis/registry/v2
    +

    To automatically register schemas with the registry, add:

    + + + + + + + + + + + + + +
    PropertyValue
    apicurio.registry.auto-registertrue
    +

    Example:

    +
    1
+2
+3
    mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.serde.avro.AvroKafkaSerializer
+mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2
+mp.messaging.outgoing.[channel].apicurio.registry.auto-register=true
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/client-service/index.html b/3.25.0/kafka/client-service/index.html new file mode 100644 index 0000000000..9a30662767 --- /dev/null +++ b/3.25.0/kafka/client-service/index.html @@ -0,0 +1,1560 @@ + + + + + + + + + + + + + + + + + + Accessing the client - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    KafkaClientService

    +

    For advanced use cases, SmallRye Reactive Messaging provides a bean of +type KafkaClientService that you can inject:

    +
    1
+2
    @Inject
+KafkaClientService kafka;
+
    +
    +

    From there, you can obtain an +io.smallrye.reactive.messaging.kafka.KafkaProducer and an +io.smallrye.reactive.messaging.kafka.KafkaConsumer.

    +

    KafkaProducer and KafkaConsumer expose a non-blocking API on top of +the Kafka client API. They also mediate access to the threads that +SmallRye Reactive Messaging uses to run all Kafka operations: the +polling thread, used for consuming records from Kafka topics, and the +sending thread, used for producing records to Kafka topics. (Just to +be clear: each channel has its own polling thread and sending thread.)

    +

    The reason why SmallRye Reactive Messaging uses a special thread to run +the poll loop should be obvious: the Consumer API is blocking. The +Producer API, on the other hand, is documented to be non-blocking. +However, in present versions, Kafka doesn’t guarantee that in all cases; +see KAFKA-3539 for +more details. That is why SmallRye Reactive Messaging uses a dedicated +thread to run the send operations as well.

    +

    Sometimes, SmallRye Reactive Messaging provides direct access to the +Kafka Producer or Consumer. For example, a +KafkaConsumerRebalanceListener +methods are always invoked on the polling thread, so they give you +direct access to Consumer. In such case, you should use the +Producer/Consumer API directly, instead of the +KafkaProducer/KafkaConsumer API.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/consumer-rebalance-listener/index.html b/3.25.0/kafka/consumer-rebalance-listener/index.html new file mode 100644 index 0000000000..d1d8912a4c --- /dev/null +++ b/3.25.0/kafka/consumer-rebalance-listener/index.html @@ -0,0 +1,1767 @@ + + + + + + + + + + + + + + + + + + Rebalance Listeners - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Consumer Rebalance Listener

    +

    To handle offset commit and assigned partitions yourself, you can +provide a consumer rebalance listener. To achieve this, implement the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +interface, make the implementing class a bean, and add the @Identifier +qualifier. A usual use case is to store offset in a separate data store +to implement exactly-once semantic, or starting the processing at a +specific offset.

    +

    The listener is invoked every time the consumer topic/partition +assignment changes. For example, when the application starts, it invokes +the partitionsAssigned callback with the initial set of +topics/partitions associated with the consumer. If, later, this set +changes, it calls the partitionsRevoked and partitionsAssigned +callbacks again, so you can implement custom logic.

    +

    Note that the rebalance listener methods are called from the Kafka +polling thread and must block the caller thread until completion. +That’s because the rebalance protocol has synchronization barriers, and +using asynchronous code in a rebalance listener may be executed after +the synchronization barrier.

    +

    When topics/partitions are assigned or revoked from a consumer, it +pauses the message delivery and restarts once the rebalance completes.

    +

    If the rebalance listener handles offset commit on behalf of the user +(using the ignore commit strategy), the rebalance listener must +commit the offset synchronously in the partitionsRevoked callback. We +also recommend applying the same logic when the application stops.

    +

    Unlike the ConsumerRebalanceListener from Apache Kafka, the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +methods pass the Kafka Consumer and the set of topics/partitions.

    +

    Example

    +

    In this example we set-up a consumer that always starts on messages from +at most 10 minutes ago (or offset 0). First we need to provide a bean +that implements the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +interface and is annotated with @Identifier. We then must configure +our inbound connector to use this named bean.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
    package kafka.inbound;
+
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.logging.Logger;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.kafka.clients.consumer.Consumer;
+import org.apache.kafka.clients.consumer.OffsetAndTimestamp;
+
+import io.smallrye.common.annotation.Identifier;
+import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener;
+
+@ApplicationScoped
+@Identifier("rebalanced-example.rebalancer")
+public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener {
+
+    private static final Logger LOGGER = Logger.getLogger(KafkaRebalancedConsumerRebalanceListener.class.getName());
+
+    /**
+     * When receiving a list of partitions will search for the earliest offset within 10 minutes
+     * and seek the consumer to it.
+     *
+     * @param consumer underlying consumer
+     * @param partitions set of assigned topic partitions
+     */
+    @Override
+    public void onPartitionsAssigned(Consumer<?, ?> consumer,
+            Collection<org.apache.kafka.common.TopicPartition> partitions) {
+        long now = System.currentTimeMillis();
+        long shouldStartAt = now - 600_000L; //10 minute ago
+
+        Map<org.apache.kafka.common.TopicPartition, Long> request = new HashMap<>();
+        for (org.apache.kafka.common.TopicPartition partition : partitions) {
+            LOGGER.info("Assigned " + partition);
+            request.put(partition, shouldStartAt);
+        }
+        Map<org.apache.kafka.common.TopicPartition, OffsetAndTimestamp> offsets = consumer
+                .offsetsForTimes(request);
+        for (Map.Entry<org.apache.kafka.common.TopicPartition, OffsetAndTimestamp> position : offsets.entrySet()) {
+            long target = position.getValue() == null ? 0L : position.getValue().offset();
+            LOGGER.info("Seeking position " + target + " for " + position.getKey());
+            consumer.seek(position.getKey(), target);
+        }
+    }
+
+}
+
    +
    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
    package kafka.inbound;
+
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Acknowledgment;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord;
+
+@ApplicationScoped
+public class KafkaRebalancedConsumer {
+
+    @Incoming("rebalanced-example")
+    @Acknowledgment(Acknowledgment.Strategy.NONE)
+    public CompletionStage<Void> consume(IncomingKafkaRecord<Integer, String> message) {
+        // We don't need to ACK messages because in this example we set offset during consumer re-balance
+        return CompletableFuture.completedFuture(null);
+    }
+
+}
+
    +
    +

    To configure the inbound connector to use the provided listener we +either set the consumer rebalance listener’s name:

    +
      +
    • mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer
      • +
    +

    Or have the listener’s name be the same as the group id:

    +
      +
    • mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer
      • +
    +

    Setting the consumer rebalance listener’s name takes precedence over +using the group id.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/default-configuration/index.html b/3.25.0/kafka/default-configuration/index.html new file mode 100644 index 0000000000..2ce17954be --- /dev/null +++ b/3.25.0/kafka/default-configuration/index.html @@ -0,0 +1,1616 @@ + + + + + + + + + + + + + + + + + + Customizing Default Kafka Configuration - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Retrieving Kafka default configuration

    +

    If your application/runtime exposes as a CDI bean of type +Map<String, Object with the identifier default-kafka-broker, this +configuration is used to establish the connection with the Kafka broker.

    +

    For example, you can imagine exposing this map as follows:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
    @Produces
+@ApplicationScoped
+@Identifier("default-kafka-broker")
+public Map<String, Object> createKafkaRuntimeConfig() {
+    Map<String, Object> properties = new HashMap<>();
+
+    StreamSupport
+        .stream(config.getPropertyNames().spliterator(), false)
+        .map(String::toLowerCase)
+        .filter(name -> name.startsWith("kafka"))
+        .distinct()
+        .sorted()
+        .forEach(name -> {
+            final String key = name.substring("kafka".length() + 1).toLowerCase().replaceAll("[^a-z0-9.]", ".");
+            final String value = config.getOptionalValue(name, String.class).orElse("");
+            properties.put(key, value);
+        });
+
+    return properties;
+}
+
    +
    +

    This previous example would extract all the configuration keys from +MicroProfile Config starting with kafka.

    +
    +

    Quarkus

    +

    Starting with Quarkus 1.5, a map corresponding to the previous example +is automatically provided.

    +
    +

    In addition to this default configuration, you can configure the name of +the Map producer using the kafka-configuration attribute:

    +
    1
+2
    mp.messaging.incoming.my-channel.connector=smallrye-kafka
+mp.messaging.incoming.my-channel.kafka-configuration=my-configuration
+
    +
    +

    In this case, the connector looks for the Map associated with the +my-configuration name. If kafka-configuration is not set, an +optional lookup for a Map exposed with the channel name (my-channel +in the previous example) is done.

    +
    +

    Important

    +

    If kafka-configuration is set and no Map can be found, the +deployment fails.

    +
    +

    Attribute values are resolved as follows:

    +
      +
    1. +

      if the attribute is set directly on the channel configuration + (mp.messaging.incoming.my-channel.attribute=value), this value is + used

      +
      2. +
    2. +

      if the attribute is not set on the channel, the connector looks for + a Map with the channel name or the configured + kafka-configuration (if set) and the value is retrieved from that + Map

      +
      3. +
    3. +

      If the resolved Map does not contain the value the default Map + is used (exposed with the default-kafka-broker name)

      +
      4. +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/health/index.html b/3.25.0/kafka/health/index.html new file mode 100644 index 0000000000..de83913738 --- /dev/null +++ b/3.25.0/kafka/health/index.html @@ -0,0 +1,1662 @@ + + + + + + + + + + + + + + + + + + Health Checks - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Health reporting

    +

    The Kafka connector reports the readiness and liveness of each channel +managed by the connector.

    +
    +

    Note

    +

    To disable health reporting, set the health-enabled attribute for the +channel to false.

    +
    +

    Readiness

    +

    On the inbound side, two strategies are available to check the readiness +of the application. The default strategy verifies that we have at least +one active connection with the broker. This strategy is lightweight.

    +

    You can also enable another strategy by setting the +health-readiness-topic-verification attribute to true. In this case, +the check verifies that:

    +
      +
    • +

      the broker is available

      +
      • +
    • +

      the Kafka topic is created (available in the broker).

      +
      • +
    • +

      no failures have been caught

      +
      • +
    +

    With this second strategy, if you consume multiple topics using the +topics attribute, the readiness check verifies that all the consumed +topics are available. If you use a pattern (using the pattern +attribute), the readiness check verifies that at least one existing +topic matches the pattern.

    +

    On the outbound side (writing records to Kafka), two strategies are also +offered. The default strategy just verifies that the producer has at +least one active connection with the broker.

    +

    You can also enable another strategy by setting the +health-readiness-topic-verification attribute to true. In this case, +teh check verifies that

    +
      +
    • +

      the broker is available

      +
      • +
    • +

      the Kafka topic is created (available in the broker).

      +
      • +
    +

    With this second strategy, the readiness check uses a Kafka Admin Client +to retrieve the existing topics. Retrieving the topics can be a lengthy +operation. You can configure a timeout using the +health-readiness-timeout attribute. The default timeout is set to 2 +seconds.

    +

    Also, you can disable the readiness checks altogether by setting +health-readiness-enabled to false.

    +

    Liveness

    +

    On the inbound side (receiving records from Kafka), the liveness check +verifies that:

    +
      +
    • +

      no failures have been caught

      +
      • +
    • +

      the client is connected to the broker

      +
      • +
    +

    On the outbound side (writing records to Kafka), the liveness check +verifies that:

    +
      +
    • no failures have been caught
      • +
    +

    Note that a message processing failures nacks the message which is +then handled by the failure-strategy. It the responsibility of the +failure-strategy to report the failure and influence the outcome of the +liveness checks. The fail failure strategy reports the failure and so +the liveness check will report the failure.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/kafka/index.html b/3.25.0/kafka/kafka/index.html new file mode 100644 index 0000000000..45a11ce475 --- /dev/null +++ b/3.25.0/kafka/kafka/index.html @@ -0,0 +1,1623 @@ + + + + + + + + + + + + + + + + + + Apache Kafka Connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Apache Kafka Connector

    +

    The Kafka connector adds support for Kafka to Reactive Messaging. With +it you can receive Kafka Records as well as write message into Kafka.

    +

    Apache Kafka is a popular distributed +streaming platform. It lets you:

    +
      +
    • +

      Publish and subscribe to streams of records, similar to a message + queue or enterprise messaging system.

      +
      • +
    • +

      Store streams of records in a fault-tolerant durable way.

      +
      • +
    • +

      Process streams of records as they occur.

      +
      • +
    +

    The Kafka cluster stores streams of records in categories called +topics. Each record consists of a key, a value, and a timestamp.

    +

    For more details about Kafka, check the +documentation.

    +

    Using the Kafka Connector

    +

    To use the Kafka Connector, add the following dependency to your +project:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-kafka</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
    +
    +

    The connector name is: smallrye-kafka.

    +

    So, to indicate that a channel is managed by this connector you need:

    +
    1
+2
+3
+4
+5
    # Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-kafka
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-kafka
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/kerberos/index.html b/3.25.0/kafka/kerberos/index.html new file mode 100644 index 0000000000..994abc8e46 --- /dev/null +++ b/3.25.0/kafka/kerberos/index.html @@ -0,0 +1,1558 @@ + + + + + + + + + + + + + + + + + + Kerberos authentication - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Kerberos authentication

    +

    When using Kerberos +authentication, you need to configure the connector with:

    +
      +
    • +

      the security protocol set to SASL_PLAINTEXT

      +
      • +
    • +

      the SASL mechanism set to GSSAPI

      +
      • +
    • +

      the Jaas config configured with Krb5LoginModule

      +
      • +
    • +

      the Kerberos service name

      +
      • +
    +

    The following snippet provides an example:

    +
    1
+2
+3
+4
+5
    kafka.bootstrap.servers=ip-192-168-0-207.us-east-2.compute.internal:9094
+kafka.sasl.mechanism=GSSAPI
+kafka.security.protocol=SASL_PLAINTEXT
+kafka.sasl.jaas.config=com.sun.security.auth.module.Krb5LoginModule required doNotPrompt=true refreshKrb5Config=true useKeyTab=true storeKey=true keyTab="file:/opt/kafka/krb5/kafka-producer.keytab" principal="kafka-producer/ip-192-168-0-207.us-east-2.compute.internal@INTERNAL";
+kafka.sasl.kerberos.service.name=kafka
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/protobuf-configuration/index.html b/3.25.0/kafka/protobuf-configuration/index.html new file mode 100644 index 0000000000..5879a44e87 --- /dev/null +++ b/3.25.0/kafka/protobuf-configuration/index.html @@ -0,0 +1,1687 @@ + + + + + + + + + + + + + + + + + + Using Protobuf - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Using Google Protobuf serializer/deserializer

    +

    If you are using Protocol +Buffers +serializer/deserializer, please note the following configuration +properties.

    +

    For Confluent Schema Registry

    +

    Confluent protobuf library is io.confluent:kafka-protobuf-serializer. +Note that this library is not available in Maven Central, you need to +use the Confluent Maven +repository.

    +

    Consumer

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.deserializerio.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer
    schema.registry.urlhttp://{your_host}:{your_port}/
    mp.messaging.incoming.[channel].specific.protobuf.value.typeyour.package.DomainObjectKey$Key
    mp.messaging.incoming.[channel].specific.protobuf.key.typeyour.package.DomainObjectValue$Value
    +

    Example:

    +
    1
+2
+3
+4
    mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer
+mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/
+mp.messaging.incoming.[channel].specific.protobuf.value.type=your.package.DomainObjectKey$Key
+mp.messaging.incoming.[channel].specific.protobuf.key.type=your.package.DomainObjectValue$Value
+
    +
    +

    Producer

    + + + + + + + + + + + + + + + + + +
    PropertyRecommended value
    value.serializerio.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer
    schema.registry.urlhttp://{your_host}:{your_port}/
    +

    Example:

    +
    1
+2
    mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer
+mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/receiving-kafka-records/index.html b/3.25.0/kafka/receiving-kafka-records/index.html new file mode 100644 index 0000000000..d64ba0821a --- /dev/null +++ b/3.25.0/kafka/receiving-kafka-records/index.html @@ -0,0 +1,3394 @@ + + + + + + + + + + + + + + + + + + Receiving records - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Receiving Kafka Records

    +

    The Kafka Connector retrieves Kafka Records from Kafka Brokers and maps +each of them to Reactive Messaging Messages.

    +

    Example

    +

    Let’s imagine you have a Kafka broker running, and accessible using the +kafka:9092 address (by default it would use localhost:9092). +Configure your application to receive Kafka records from a Kafka topic +on the prices channel as follows:

    +
    1
+2
+3
+4
+5
    kafka.bootstrap.servers=kafka:9092 # <1>
+
+mp.messaging.incoming.prices.connector=smallrye-kafka # <2>
+mp.messaging.incoming.prices.value.deserializer=org.apache.kafka.common.serialization.DoubleDeserializer # <3>
+mp.messaging.incoming.prices.broadcast=true # <4>
+
    +
    +
      +
    1. +

      Configure the broker location. You can configure it globally or per + channel

      +
      2. +
    2. +

      Configure the connector to manage the prices channel

      +
      3. +
    3. +

      Sets the (Kafka) deserializer to read the record’s value

      +
      4. +
    4. +

      Make sure that we can receive from more than one consumer (see + KafkaPriceConsumer and KafkaPriceMessageConsumer below)

      +
      5. +
    +
    +

    Note

    +

    You don’t need to set the Kafka topic. By default, it uses the channel +name (prices). You can configure the topic attribute to override it.

    +
    +

    Then, your application receives Message<Double>. You can consume the +payload directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    package kafka.inbound;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class KafkaPriceConsumer {
+
+    @Incoming("prices")
+    public void consume(double price) {
+        // process your price.
+    }
+
+}
+
    +
    +

    Or, you can retrieve the Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
    package kafka.inbound;
+
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class KafkaPriceMessageConsumer {
+
+    @Incoming("prices")
+    public CompletionStage<Void> consume(Message<Double> price) {
+        // process your price.
+
+        // Acknowledge the incoming message (commit the offset)
+        return price.ack();
+    }
+
+}
+
    +
    +

    Deserialization

    +

    The deserialization is handled by the underlying Kafka Client. You need +to configure the:

    +
      +
    • +

      mp.messaging.incoming.[channel-name].value.deserializer to + configure the value deserializer (mandatory)

      +
      • +
    • +

      mp.messaging.incoming.[channel-name].key.deserializer to configure + the key deserializer (optional, default to String)

      +
      • +
    +

    If you want to use a custom deserializer, add it to your CLASSPATH and +configure the associate attribute.

    +

    In addition, the Kafka Connector also provides a set of message +converters. So you can receive payloads representing records from +Kafka using:

    +
      +
    • Record - a pair key/value
      • +
    • ConsumerRecord - + a structure representing the record with all its metadata
      • +
    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
    @Incoming("topic-a")
+public void consume(Record<String, String> record) {
+    String key = record.key(); // Can be `null` if the incoming record has no key
+    String value = record.value(); // Can be `null` if the incoming record has no value
+}
+
+@Incoming("topic-b")
+public void consume(ConsumerRecord<String, String> record) {
+    String key = record.key(); // Can be `null` if the incoming record has no key
+    String value = record.value(); // Can be `null` if the incoming record has no value
+    String topic = record.topic();
+    int partition = record.partition();
+    // ...
+}
+
    +
    +

    Inbound Metadata

    +

    Messages coming from Kafka contains an instance of +IncomingKafkaRecordMetadata +in the metadata. It provides the key, topic, partitions, +headers and so on:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    IncomingKafkaRecordMetadata<String, Double> metadata = incoming.getMetadata(IncomingKafkaRecordMetadata.class)
+        .orElse(null);
+if (metadata != null) {
+    // The topic
+    String topic = metadata.getTopic();
+
+    // The key
+    String key = metadata.getKey();
+
+    // The timestamp
+    Instant timestamp = metadata.getTimestamp();
+
+    // The underlying record
+    ConsumerRecord<String, Double> record = metadata.getRecord();
+
+    // ...
+}
+
    +
    +

    Acknowledgement

    +

    When a message produced from a Kafka record is acknowledged, the +connector invokes a commit strategy. These strategies decide when the +consumer offset for a specific topic/partition is committed. Committing +an offset indicates that all previous records have been processed. It is +also the position where the application would restart the processing +after a crash recovery or a restart.

    +

    Committing every offset has performance penalties as Kafka offset +management can be slow. However, not committing the offset often enough +may lead to message duplication if the application crashes between two +commits.

    +

    The Kafka connector supports three strategies:

    +
      +
    • +

      throttled keeps track of received messages and commit to the next + offset after the latest acked message in sequence. This strategy + guarantees at-least-once delivery even if the channel performs + asynchronous processing. The connector tracks the received records + and periodically (period specified by auto.commit.interval.ms + (default: 5000)) commits the highest consecutive offset. The + connector will be marked as unhealthy if a message associated with a + record is not acknowledged in + throttled.unprocessed-record-max-age.ms (default: 60000). Indeed, + this strategy cannot commit the offset as soon as a single record + processing fails (see failure-strategy to configure what happens on + failing processing). If throttled.unprocessed-record-max-age.ms is + set to less than or equal to 0, it does not perform any health check + verification. Such a setting might lead to running out of memory if + there are poison pill messages. This strategy is the default if + enable.auto.commit is not explicitly set to true.

      +
      • +
    • +

      checkpoint allows persisting consumer offsets on a "state store", + instead of committing them back to the Kafka broker. Using the + CheckpointMetadata API, consumer code can persist a processing + state with the offset to mark the progress of a consumer. + When the processing continues from a previously persisted offset, + it seeks the Kafka consumer to that offset and also restores the + persisted state, continuing the stateful processing from where it + left off. The checkpoint strategy holds locally the processing + state associated with the latest offset, and persists it + periodically to the state store (period specified by + auto.commit.interval.ms (default: 5000)). The connector will be + marked as unhealthy if no processing state is persisted to the state + store in checkpoint.unsynced-state-max-age.ms (default: 10000). + Using the CheckpointMetadata API the user code can force to persist + the state on message ack. If checkpoint.unsynced-state-max-age.ms + is set to less than or equal to 0, it does not perform any health + check verification. For more information, see + Stateful processing with Checkpointing

      +
      • +
    • +

      latest commits the record offset received by the Kafka consumer as + soon as the associated message is acknowledged (if the offset is + higher than the previously committed offset). This strategy provides + at-least-once delivery if the channel processes the message + without performing any asynchronous processing. This strategy should + not be used on high-load as offset commit is expensive. However, it + reduces the risk of duplicates.

      +
      • +
    • +

      ignore performs no commit. This strategy is the default strategy + when the consumer is explicitly configured with enable.auto.commit + to true. It delegates the offset commit to the Kafka client. When + enable.auto.commit is true this strategy DOES NOT guarantee + at-least-once delivery. However, if the processing failed between + two commits, messages received after the commit and before the + failure will be re-processed.

      +
      • +
    +
    +

    Important

    +

    The Kafka connector disables the Kafka auto commit if not explicitly +enabled. This behavior differs from the traditional Kafka consumer.

    +
    +

    If high-throughout is important for you, and not limited by the +downstream, we recommend to either:

    +
      +
    • Use the throttled policy
      • +
    • or set enable.auto.commit to true and annotate the consuming + method with @Acknowledgment(Acknowledgment.Strategy.NONE)
      • +
    +

    Failure Management

    +

    If a message produced from a Kafka record is nacked, a failure +strategy is applied. The Kafka connector supports 3 strategies:

    +
      +
    • +

      fail - fail the application, no more records will be processed. + (default) The offset of the record that has not been processed + correctly is not committed.

      +
      • +
    • +

      ignore - the failure is logged, but the processing continue. The + offset of the record that has not been processed correctly is + committed.

      +
      • +
    • +

      dead-letter-queue - the offset of the record that has not been + processed correctly is committed, but the record is written to a + (Kafka) dead letter queue topic.

      +
      • +
    +

    The strategy is selected using the failure-strategy attribute.

    +

    In the case of dead-letter-queue, you can configure the following +attributes:

    +
      +
    • dead-letter-queue.topic: the topic to use to write the records not + processed correctly, default is dead-letter-topic-$channel, with + $channel being the name of the channel.
      • +
    • +

      dead-letter-queue.producer-client-id: the client id used by the kafka +producer when sending records to dead letter queue topic. If not specified +it will default to kafka-dead-letter-topic-producer-$client-id, with $client-id +being the value obtained from consumer client id.

      +
      • +
    • +

      dead-letter-queue.key.serializer: the serializer used to write the + record key on the dead letter queue. By default, it deduces the + serializer from the key deserializer.

      +
      • +
    • +

      dead-letter-queue.value.serializer: the serializer used to write + the record value on the dead letter queue. By default, it deduces + the serializer from the value deserializer.

      +
      • +
    +

    The record written on the dead letter topic contains the original +record’s headers, as well as a set of additional headers about the +original record:

    +
      +
    • +

      dead-letter-reason - the reason of the failure (the Throwable + passed to nack())

      +
      • +
    • +

      dead-letter-cause - the cause of the failure (the getCause() of + the Throwable passed to nack()), if any

      +
      • +
    • +

      dead-letter-topic - the original topic of the record

      +
      • +
    • +

      dead-letter-partition - the original partition of the record + (integer mapped to String)

      +
      • +
    • +

      dead-letter-offset - the original offset of the record (long + mapped to String)

      +
      • +
    +

    When using dead-letter-queue, it is also possible to change some +metadata of the record that is sent to the dead letter topic. To do +that, use the Message.nack(Throwable, Metadata) method:

    +
    1
+2
+3
+4
+5
+6
+7
+8
+9
    @Incoming("in")
+public CompletionStage<Void> consume(KafkaRecord<String, String> message) {
+    return message.nack(new Exception("Failed!"), Metadata.of(
+            OutgoingKafkaRecordMetadata.builder()
+                    .withKey("failed-record")
+                    .withHeaders(new RecordHeaders()
+                            .add("my-header", "my-header-value".getBytes(StandardCharsets.UTF_8)))
+                    .build()));
+}
+
    +
    +

    The Metadata may contain an instance of OutgoingKafkaRecordMetadata. +If the instance is present, the following properties will be used:

    +
      +
    • +

      key; if not present, the original record’s key will be used

      +
      • +
    • +

      topic; if not present, the configured dead letter topic will be used

      +
      • +
    • +

      partition; if not present, partition will be assigned automatically

      +
      • +
    • +

      headers; combined with the original record’s headers, as well as the + dead-letter-* headers described above

      +
      • +
    +

    Custom commit and failure strategies

    +

    In addition to provided strategies, it is possible to implement custom +commit and failure strategies and configure Kafka channels with them.

    +

    For example, for a custom commit strategy, implement the +KafkaCommitHandler interface, +and provide a managed bean implementing the KafkaCommitHandler.Factory interface, +identified using @Identifier qualifier.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
    package kafka.inbound;
+
+import java.util.Collection;
+import java.util.function.BiConsumer;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.kafka.common.TopicPartition;
+
+import io.smallrye.common.annotation.Identifier;
+import io.smallrye.mutiny.Uni;
+import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord;
+import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration;
+import io.smallrye.reactive.messaging.kafka.KafkaConsumer;
+import io.smallrye.reactive.messaging.kafka.commit.KafkaCommitHandler;
+import io.vertx.mutiny.core.Vertx;
+
+public class KafkaCustomCommit implements KafkaCommitHandler {
+
+    @Override
+    public <K, V> Uni<Void> handle(IncomingKafkaRecord<K, V> record) {
+        // called on message ack
+        return Uni.createFrom().voidItem();
+    }
+
+    @Override
+    public <K, V> Uni<IncomingKafkaRecord<K, V>> received(IncomingKafkaRecord<K, V> record) {
+        // called before message processing
+        return Uni.createFrom().item(record);
+    }
+
+    @Override
+    public void terminate(boolean graceful) {
+        // called on channel shutdown
+    }
+
+    @Override
+    public void partitionsAssigned(Collection<TopicPartition> partitions) {
+        // called on partitions assignment
+    }
+
+    @Override
+    public void partitionsRevoked(Collection<TopicPartition> partitions) {
+        // called on partitions revoked
+    }
+
+    @ApplicationScoped
+    @Identifier("custom")
+    public static class Factory implements KafkaCommitHandler.Factory {
+
+        @Override
+        public KafkaCommitHandler create(KafkaConnectorIncomingConfiguration config,
+                Vertx vertx,
+                KafkaConsumer<?, ?> consumer,
+                BiConsumer<Throwable, Boolean> reportFailure) {
+            return new KafkaCustomCommit(/* ... */);
+        }
+    }
+
+}
+
    +
    +

    Finally, to use the custom commit strategy, +set the commit-strategy attribute to the identifier of the commit handler factory: +mp.messaging.incoming.$channel.commit-strategy=custom. +Similarly, custom failure strategies can be configured using failure-strategy attribute.

    +
    +

    Note

    +

    If the custom strategy implementation inherits +ContextHolder class it can access the +Vert.x event-loop context created for the Kafka consumer

    +
    +

    Retrying processing

    +

    You can combine Reactive Messaging with SmallRye Fault +Tolerance, and +retry processing when it fails:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("kafka")
+@Outgoing("processed")
+@Retry(delay = 10, maxRetries = 5)
+public String process(String v) {
+   // ... retry if this method throws an exception
+}
+
    +
    +

    You can configure the delay, the number of retries, the jitter...

    +

    If your method returns a Uni, you need to add the @NonBlocking +annotation:

    +
    1
+2
+3
+4
+5
+6
+7
    @Incoming("kafka")
+@Outgoing("processed")
+@Retry(delay = 10, maxRetries = 5)
+@NonBlocking
+public Uni<String> process(String v) {
+   // ... retry if this method throws an exception or the returned Uni produce a failure
+}
+
    +
    +

    The incoming messages are acknowledged only once the processing +completes successfully. So, it commits the offset after the successful +processing. If after the retries the processing still failed, the +message is nacked and the failure strategy is applied.

    +

    You can also use @Retry on methods only consuming incoming messages:

    +
    1
+2
+3
+4
+5
    @Incoming("kafka")
+@Retry(delay = 10, maxRetries = 5)
+public void consume(String v) {
+   // ... retry if this method throws an exception
+}
+
    +
    +

    Handling deserialization failures

    +

    Because deserialization happens before creating a Message, the failure +strategy presented above cannot be applied. However, when a +deserialization failure occurs, you can intercept it and provide a +fallback value. To achieve this, create a CDI bean implementing the +DeserializationFailureHandler +interface:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
    @ApplicationScoped
+@Identifier("failure-retry") // Set the name of the failure handler
+public class MyDeserializationFailureHandler
+    implements DeserializationFailureHandler<JsonObject> { // Specify the expected type
+
+    @Override
+    public JsonObject decorateDeserialization(Uni<JsonObject> deserialization,
+            String topic, boolean isKey, String deserializer, byte[] data,
+            Headers headers) {
+        return deserialization
+                    .onFailure().retry().atMost(3)
+                    .await().atMost(Duration.ofMillis(200));
+    }
+}
+
    +
    +

    The bean must be exposed with the @Identifier qualifier specifying the +name of the bean. Then, in the connector configuration, specify the +following attribute:

    +
      +
    • +

      mp.messaging.incoming.$channel.key-deserialization-failure-handler: + name of the bean handling deserialization failures happening for the + record’s key

      +
      • +
    • +

      mp.messaging.incoming.$channel.value-deserialization-failure-handler: + name of the bean handling deserialization failures happening for the + record’s value,

      +
      • +
    +

    The handler is called with the deserialization action as a Uni<T>, the +record’s topic, a boolean indicating whether the failure happened on a +key, the class name of the deserializer that throws the exception, the +corrupted data, the exception, and the records headers augmented with +headers describing the failure (which ease the write to a dead letter). +On the deserialization Uni failure strategies like retry, providing a +fallback value or applying timeout can be implemented. Note that the +method must await on the result and return the deserialized object. +Alternatively, the handler can only implement +handleDeserializationFailure method and provide a fallback value, +which may be null.

    +

    If you don’t configure a deserialization failure handlers and a +deserialization failure happens, the application is marked unhealthy. +You can also ignore the failure, which will log the exception and +produce a null value. To enable this behavior, set the +mp.messaging.incoming.$channel.fail-on-deserialization-failure +attribute to false.

    +

    Receiving Cloud Events

    +

    The Kafka connector supports Cloud Events. +When the connector detects a structured or binary Cloud Events, it +adds a IncomingKafkaCloudEventMetadata in the metadata of the +Message. IncomingKafkaCloudEventMetadata contains the various (mandatory and optional) Cloud Event attributes.

    +

    If the connector cannot extract the Cloud Event metadata, it sends the +Message without the metadata.

    +

    Binary Cloud Events

    +

    For binary Cloud Events, all mandatory Cloud Event attributes must +be set in the record header, prefixed by ce_ (as mandated by the +protocol +binding). +The connector considers headers starting with the ce_ prefix but not +listed in the specification as extensions. You can access them using the +getExtension method from IncomingKafkaCloudEventMetadata. You can +retrieve them as String.

    +

    The datacontenttype attribute is mapped to the content-type header +of the record. The partitionkey attribute is mapped to the record’s +key, if any.

    +

    Note that all headers are read as UTF-8.

    +

    With binary Cloud Events, the record’s key and value can use any +deserializer.

    +

    Structured Cloud Events

    +

    For structured Cloud Events, the event is encoded in the record’s +value. Only JSON is supported, so your event must be encoded as JSON in +the record’s value.

    +

    Structured Cloud Event must set the content-type header of the record +to application/cloudevents or prefix the value with +application/cloudevents such as: +application/cloudevents+json; charset=UTF-8.

    +

    To receive structured Cloud Events, your value deserializer must be:

    +
      +
    • +

      org.apache.kafka.common.serialization.StringDeserializer

      +
      • +
    • +

      org.apache.kafka.common.serialization.ByteArrayDeserializer

      +
      • +
    • +

      io.vertx.kafka.client.serialization.JsonObjectDeserializer

      +
      • +
    +

    As mentioned previously, the value must be a valid JSON object +containing at least all the mandatory Cloud Events attributes.

    +

    If the record is a structured Cloud Event, the created Message’s payload +is the Cloud Event data.

    +

    The partitionkey attribute is mapped to the record’s key if any.

    +

    Consumer Rebalance Listener

    +

    To handle offset commit and assigned partitions yourself, you can +provide a consumer rebalance listener. To achieve this, implement the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +interface, make the implementing class a bean, and add the @Identifier +qualifier. A usual use case is to store offset in a separate data store +to implement exactly-once semantic, or starting the processing at a +specific offset.

    +

    The listener is invoked every time the consumer topic/partition +assignment changes. For example, when the application starts, it invokes +the partitionsAssigned callback with the initial set of +topics/partitions associated with the consumer. If, later, this set +changes, it calls the partitionsRevoked and partitionsAssigned +callbacks again, so you can implement custom logic.

    +

    Note that the rebalance listener methods are called from the Kafka +polling thread and must block the caller thread until completion. +That’s because the rebalance protocol has synchronization barriers, and +using asynchronous code in a rebalance listener may be executed after +the synchronization barrier.

    +

    When topics/partitions are assigned or revoked from a consumer, it +pauses the message delivery and restarts once the rebalance completes.

    +

    If the rebalance listener handles offset commit on behalf of the user +(using the ignore commit strategy), the rebalance listener must +commit the offset synchronously in the partitionsRevoked callback. We +also recommend applying the same logic when the application stops.

    +

    Unlike the ConsumerRebalanceListener from Apache Kafka, the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +methods pass the Kafka Consumer and the set of topics/partitions.

    +

    Example

    +

    In this example we set-up a consumer that always starts on messages from +at most 10 minutes ago (or offset 0). First we need to provide a bean +that implements the +io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener +interface and is annotated with @Identifier. We then must configure +our inbound connector to use this named bean.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
    package kafka.inbound;
+
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.logging.Logger;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.kafka.clients.consumer.Consumer;
+import org.apache.kafka.clients.consumer.OffsetAndTimestamp;
+
+import io.smallrye.common.annotation.Identifier;
+import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener;
+
+@ApplicationScoped
+@Identifier("rebalanced-example.rebalancer")
+public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener {
+
+    private static final Logger LOGGER = Logger.getLogger(KafkaRebalancedConsumerRebalanceListener.class.getName());
+
+    /**
+     * When receiving a list of partitions will search for the earliest offset within 10 minutes
+     * and seek the consumer to it.
+     *
+     * @param consumer underlying consumer
+     * @param partitions set of assigned topic partitions
+     */
+    @Override
+    public void onPartitionsAssigned(Consumer<?, ?> consumer,
+            Collection<org.apache.kafka.common.TopicPartition> partitions) {
+        long now = System.currentTimeMillis();
+        long shouldStartAt = now - 600_000L; //10 minute ago
+
+        Map<org.apache.kafka.common.TopicPartition, Long> request = new HashMap<>();
+        for (org.apache.kafka.common.TopicPartition partition : partitions) {
+            LOGGER.info("Assigned " + partition);
+            request.put(partition, shouldStartAt);
+        }
+        Map<org.apache.kafka.common.TopicPartition, OffsetAndTimestamp> offsets = consumer
+                .offsetsForTimes(request);
+        for (Map.Entry<org.apache.kafka.common.TopicPartition, OffsetAndTimestamp> position : offsets.entrySet()) {
+            long target = position.getValue() == null ? 0L : position.getValue().offset();
+            LOGGER.info("Seeking position " + target + " for " + position.getKey());
+            consumer.seek(position.getKey(), target);
+        }
+    }
+
+}
+
    +
    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
    package kafka.inbound;
+
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Acknowledgment;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord;
+
+@ApplicationScoped
+public class KafkaRebalancedConsumer {
+
+    @Incoming("rebalanced-example")
+    @Acknowledgment(Acknowledgment.Strategy.NONE)
+    public CompletionStage<Void> consume(IncomingKafkaRecord<Integer, String> message) {
+        // We don't need to ACK messages because in this example we set offset during consumer re-balance
+        return CompletableFuture.completedFuture(null);
+    }
+
+}
+
    +
    +

    To configure the inbound connector to use the provided listener we +either set the consumer rebalance listener’s name:

    +
      +
    • mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer
      • +
    +

    Or have the listener’s name be the same as the group id:

    +
      +
    • mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer
      • +
    +

    Setting the consumer rebalance listener’s name takes precedence over +using the group id.

    +

    Receiving Kafka Records in Batches

    +

    By default, incoming methods receive each Kafka record individually. +Under the hood, Kafka consumer clients poll the broker constantly and +receive records in batches, presented inside the ConsumerRecords +container.

    +

    In batch mode, your application can receive all the records returned +by the consumer poll in one go.

    +

    To achieve this you need to set +mp.messaging.incoming.$channel.batch=true and specify a compatible +container type to receive all the data:

    +
    1
+2
+3
+4
+5
+6
    @Incoming("prices")
+public void consume(List<Double> prices) {
+    for (double price : prices) {
+        // process price
+    }
+}
+
    +
    +

    The incoming method can also receive Message<List<Payload>, +KafkaBatchRecords<Payload> ConsumerRecords<Key, Payload> types, They +give access to record details such as offset or timestamp :

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
    @Incoming("prices")
+public CompletionStage<Void> consumeMessage(KafkaRecordBatch<String, Double> records) {
+    for (KafkaRecord<String, Double> record : records) {
+        record.getMetadata(IncomingKafkaRecordMetadata.class).ifPresent(metadata -> {
+            int partition = metadata.getPartition();
+            long offset = metadata.getOffset();
+            Instant timestamp = metadata.getTimestamp();
+            //... process messages
+        });
+    }
+    // ack will commit the latest offsets (per partition) of the batch.
+    return records.ack();
+}
+
+@Incoming("prices")
+public void consumeRecords(ConsumerRecords<String, Double> records) {
+    for (TopicPartition partition : records.partitions()) {
+        for (ConsumerRecord<String, Double> record : records.records(partition)) {
+            //... process messages
+        }
+    }
+}
+
    +
    +

    Note that the successful processing of the incoming record batch will +commit the latest offsets for each partition received inside the batch. +The configured commit strategy will be applied for these records only.

    +

    Conversely, if the processing throws an exception, all messages are +nacked, applying the failure strategy for all the records inside the +batch.

    +

    Stateful processing with Checkpointing

    +
    +

    Experimental

    +

    Checkpointing is experimental, and APIs and features are subject +to change in the future.

    +
    +

    The checkpoint commit strategy allows for a Kafka incoming channel to +manage topic-partition offsets, not by committing on the Kafka broker, +but by persisting consumers' advancement on a +state store.

    +

    In addition to that, if the consumer builds an internal state as +a result of consumed records, the topic-partition offset persisted +to the state store can be associated with a processing state, +saving the local state to the persistent store. When a consumer +restarts or consumer group instances scale, i.e. when new partitions +get assigned to the consumer, the checkpointing works by resuming the +processing from the latest offset and its saved state.

    +

    The @Incoming channel consumer code can manipulate the processing +state through the CheckpointMetadata API:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
    @Incoming("prices")
+public CompletionStage<Void> consume(KafkaRecord<String, Double> record) {
+    // Get the `CheckpointMetadata` from the incoming message
+    CheckpointMetadata<Double> checkpoint = CheckpointMetadata.fromMessage(record);
+
+    // `CheckpointMetadata` allows transforming the processing state
+    // Applies the given function, starting from the value `0.0` when no previous state exists
+    checkpoint.transform(0.0, current -> current + record.getPayload(), /* persistOnAck */ true);
+
+    // `persistOnAck` flag set to true, ack will persist the processing state
+    // associated with the latest offset (per partition).
+    return record.ack();
+}
+
    +
    +

    The transform method allows applying a transformation function to +the current state, producing a changed state and registering it +locally for checkpointing. By default, the local state is synced +(persisted) to the state store periodically, period specified by +auto.commit.interval.ms, (default: 5000). If persistOnAck flag +is given, the latest state is persisted to the state store eagerly +on message acknowledgment. The setNext method works similarly +directly setting the latest state.

    +

    The checkpoint commit strategy tracks when a processing state +is last persisted for each topic-partition. If an outstanding state +change can not be persisted for checkpoint.unsynced-state-max-age.ms +(default: 10000), the channel is marked unhealthy.

    +

    Where and how processing states are persisted is decided by the +state store implementation. This can be configured on the incoming +channel using checkpoint.state-store configuration property, +using the state store factory identifier name. +The serialization of state objects depends on the state store +implementation. In order to instruct state stores for serialization +can require configuring the type name of state objects +using checkpoint.state-type property.

    +

    In order to keep Smallrye Reactive Messaging free of persistence-related +dependencies, this library includes only a default state store named file. +It is based on Vert.x Filesystem API and stores the processing state +in Json formatted files, in a local directory configured by the +checkpoint.file.state-dir property. State files follow the naming +scheme [consumer-group-id]:[topic]:[partition].

    +

    Implementing State Stores

    +

    State store implementations are required to implement CheckpointStateStore +interface, and provide a managed bean implementing +CheckpointStateStore.Factory, identified with @Identifier bean +qualifier indicating the name of the state-store. +The factory bean identifier indicates the name to configure on +checkpoint.state-store config property. +The factory is discovered as a CDI managed bean and state store is +created once per channel:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
    package kafka.inbound;
+
+import java.util.Collection;
+import java.util.Map;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.kafka.clients.consumer.ConsumerConfig;
+import org.apache.kafka.common.TopicPartition;
+
+import io.smallrye.common.annotation.Identifier;
+import io.smallrye.mutiny.Uni;
+import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration;
+import io.smallrye.reactive.messaging.kafka.KafkaConsumer;
+import io.smallrye.reactive.messaging.kafka.commit.CheckpointStateStore;
+import io.smallrye.reactive.messaging.kafka.commit.ProcessingState;
+import io.vertx.mutiny.core.Vertx;
+
+public class MyCheckpointStateStore implements CheckpointStateStore {
+
+    private final String consumerGroupId;
+    private final Class<?> stateType;
+
+    public MyCheckpointStateStore(String consumerGroupId, Class<?> stateType) {
+        this.consumerGroupId = consumerGroupId;
+        this.stateType = stateType;
+    }
+
+    /**
+     * Can be used with
+     * {@code mp.reactive.messaging.incoming.my-channel.commit-strategy=checkpoint}
+     * {@code mp.reactive.messaging.incoming.my-channel.checkpoint.state-store=my-store}
+     */
+    @ApplicationScoped
+    @Identifier("my-store")
+    public static class Factory implements CheckpointStateStore.Factory {
+
+        @Override
+        public CheckpointStateStore create(KafkaConnectorIncomingConfiguration config,
+                Vertx vertx,
+                KafkaConsumer<?, ?> consumer,
+                Class<?> stateType /* if configured, otherwise null */) {
+            String consumerGroupId = (String) consumer.configuration().get(ConsumerConfig.GROUP_ID_CONFIG);
+            return new MyCheckpointStateStore(consumerGroupId, stateType);
+        }
+    }
+
+    @Override
+    public Uni<Map<TopicPartition, ProcessingState<?>>> fetchProcessingState(Collection<TopicPartition> partitions) {
+        // Called on Vert.x event loop
+        // Return a Uni completing with the map of topic-partition to processing state
+        // The Uni will be subscribed also on Vert.x event loop
+        return Uni.createFrom().nullItem();
+    }
+
+    @Override
+    public Uni<Void> persistProcessingState(Map<TopicPartition, ProcessingState<?>> state) {
+        // Called on Vert.x event loop
+        // Return a Uni completing with void when the given states are persisted
+        // The Uni will be subscribed also on Vert.x event loop
+        return Uni.createFrom().voidItem();
+    }
+
+    @Override
+    public void close() {
+        /* Called when channel is closing, no-op by default */
+    }
+}
+
    +
    +

    The checkpoint commit strategy calls the state store in following events:

    +
      +
    • fetchProcessingState : on partitions assigned, to seek the consumer to the latest offset.
      • +
    • persistProcessingState on partitions revoked, to persist the state of last processed record.
      • +
    • persistProcessingState on message acknowledgement, if a new state is set during the processing and persistOnAck flag is set.
      • +
    • persistProcessingState on auto.commit.interval.ms intervals, if a new state is set during processing.
      • +
    • persistProcessingState on channel shutdown.
      • +
    • close on channel shutdown.
      • +
    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    auto.offset.resetWhat to do when there is no initial offset in Kafka.Accepted values are earliest, latest and nonestringfalselatest
    batchWhether the Kafka records are consumed in batch. The channel injection point must consume a compatible type, such as List<Payload> or KafkaRecordBatch<Payload>.booleanfalsefalse
    bootstrap.servers (kafka.bootstrap.servers)A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster.stringfalselocalhost:9092
    broadcastWhether the Kafka records should be dispatched to multiple consumerbooleanfalsefalse
    checkpoint.state-storeWhile using the checkpoint commit-strategy, the name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.StateStore.Factory to specify the state store implementation.stringfalse
    checkpoint.state-typeWhile using the checkpoint commit-strategy, the fully qualified type name of the state object to persist in the state store. When provided, it can be used by the state store implementation to help persisting the processing state object.stringfalse
    checkpoint.unsynced-state-max-age.msWhile using the checkpoint commit-strategy, specify the max age in milliseconds that the processing state must be persisted before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring.intfalse10000
    client-id-prefixPrefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value.stringfalse
    cloud-eventsEnables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing, the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata.booleanfalsetrue
    commit-strategySpecify the commit strategy to apply when a message produced from a record is acknowledged. Values can be latest, ignore or throttled. If enable.auto.commit is true then the default is ignore otherwise it is throttledstringfalse
    consumer-rebalance-listener.nameThe name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener. If set, this rebalance listener is applied to the consumer.stringfalse
    dead-letter-queue.key.serializerWhen the failure-strategy is set to dead-letter-queue indicates the key serializer to use. If not set the serializer associated to the key deserializer is usedstringfalse
    dead-letter-queue.producer-client-idWhen the failure-strategy is set to dead-letter-queue indicates what client id the generated producer should use. Defaults is kafka-dead-letter-topic-producer-$client-idstringfalse
    dead-letter-queue.topicWhen the failure-strategy is set to dead-letter-queue indicates on which topic the record is sent. Defaults is dead-letter-topic-$channelstringfalse
    dead-letter-queue.value.serializerWhen the failure-strategy is set to dead-letter-queue indicates the value serializer to use. If not set the serializer associated to the value deserializer is usedstringfalse
    enable.auto.commitIf enabled, consumer's offset will be periodically committed in the background by the underlying Kafka client, ignoring the actual processing outcome of the records. It is recommended to NOT enable this setting and let Reactive Messaging handles the commit.booleanfalsefalse
    fail-on-deserialization-failureWhen no deserialization failure handler is set and a deserialization failure happens, report the failure and mark the application as unhealthy. If set to false and a deserialization failure happens, a null value is forwarded.booleanfalsetrue
    failure-strategySpecify the failure strategy to apply when a message produced from a record is acknowledged negatively (nack). Values can be fail (default), ignore, or dead-letter-queuestringfalsefail
    fetch.min.bytesThe minimum amount of data the server should return for a fetch request. The default setting of 1 byte means that fetch requests are answered as soon as a single byte of data is available or the fetch request times out waiting for data to arrive.intfalse1
    graceful-shutdownWhether or not a graceful shutdown should be attempted when the application terminates.booleanfalsetrue
    group.idA unique string that identifies the consumer group the application belongs to. If not set, a unique, generated id is usedstringfalse
    health-enabledWhether health reporting is enabled (default) or disabledbooleanfalsetrue
    health-readiness-enabledWhether readiness health reporting is enabled (default) or disabledbooleanfalsetrue
    health-readiness-timeoutdeprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead.longfalse
    health-readiness-topic-verificationdeprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead.booleanfalse
    health-topic-verification-enabledWhether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection.booleanfalsefalse
    health-topic-verification-timeoutDuring the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready.longfalse2000
    kafka-configurationIdentifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier.stringfalse
    key-deserialization-failure-handlerThe name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler. If set, deserialization failure happening when deserializing keys are delegated to this handler which may retry or provide a fallback value.stringfalse
    key.deserializerThe deserializer classname used to deserialize the record's keystringfalseorg.apache.kafka.common.serialization.StringDeserializer
    lazy-clientWhether Kafka client is created lazily or eagerly.booleanfalsefalse
    max-queue-size-factorMultiplier factor to determine maximum number of records queued for processing, using max.poll.records * max-queue-size-factor. Defaults to 2. In batch mode max.poll.records is considered 1.intfalse2
    partitionsThe number of partitions to be consumed concurrently. The connector creates the specified amount of Kafka consumers. It should match the number of partition of the targeted topicintfalse1
    patternIndicate that the topic property is a regular expression. Must be used with the topic property. Cannot be used with the topics propertybooleanfalsefalse
    pause-if-no-requestsWhether the polling must be paused when the application does not request items and resume when it does. This allows implementing back-pressure based on the application capacity. Note that polling is not stopped, but will not retrieve any records when paused.booleanfalsetrue
    poll-timeoutThe polling timeout in milliseconds. When polling records, the poll will wait at most that duration before returning records. Default is 1000msintfalse1000
    requestsWhen partitions is greater than 1, this attribute allows configuring how many records are requested by each consumers every time.intfalse128
    retryWhether or not the connection to the broker is re-attempted in case of failurebooleanfalsetrue
    retry-attemptsThe maximum number of reconnection before failing. -1 means infinite retryintfalse-1
    retry-max-waitThe max delay (in seconds) between 2 reconnectsintfalse30
    throttled.unprocessed-record-max-age.msWhile using the throttled commit-strategy, specify the max age in milliseconds that an unprocessed message can be before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring.intfalse60000
    topicThe consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is usedstringfalse
    topicsA comma-separating list of topics to be consumed. Cannot be used with the topic or pattern propertiesstringfalse
    tracing-enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
    value-deserialization-failure-handlerThe name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler. If set, deserialization failure happening when deserializing values are delegated to this handler which may retry or provide a fallback value.stringfalse
    value.deserializerThe deserializer classname used to deserialize the record's valuestringtrue
    +

    You can also pass any property supported by the underlying Kafka +consumer.

    +

    For example, to configure the max.poll.records property, use:

    +
    1
    mp.messaging.incoming.[channel].max.poll.records=1000
+
    +
    +

    Some consumer client properties are configured to sensible default +values:

    +

    If not set, reconnect.backoff.max.ms is set to 10000 to avoid high +load on disconnection.

    +

    If not set, key.deserializer is set to +org.apache.kafka.common.serialization.StringDeserializer.

    +

    The consumer client.id is configured according to the number of +clients to create using mp.messaging.incoming.[channel].partitions +property.

    +
      +
    • +

      If a client.id is provided, it is used as-is or suffixed with + client index if partitions property is set.

      +
      • +
    • +

      If a client.id is not provided, it is generated as + kafka-consumer-[channel][-index].

      +
      • +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/test-companion/index.html b/3.25.0/kafka/test-companion/index.html new file mode 100644 index 0000000000..208f5ac736 --- /dev/null +++ b/3.25.0/kafka/test-companion/index.html @@ -0,0 +1,1983 @@ + + + + + + + + + + + + + + + + + + Test Companion for Kafka - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Kafka Companion

    +
    +

    Experimental

    +

    Kafka Companion is experimental and APIs are subject to change in the future.

    +
    +

    The Kafka Companion is a separate Java library for helping to test Kafka applications. +It is not intended to mock Kafka, but to the contrary, connect to a Kafka broker and provide high-level features.

    +

    It is not limited to the SmallRye Reactive Messaging testing, but intends to improve the testability of applications using Kafka. Some of its features:

    +
      +
    • Running In-container Kafka broker for tests via strimzi-test-container.
      • +
    • Running the Kafka broker behind a toxiproxy for simulating network issues.
      • +
    • Running embedded Kafka Kraft broker for tests.
      • +
    • Base classes for tests to bootstrap tests.
      • +
    • Companion classes for easily creating tasks to produce and consume Kafka records.
      • +
    • Writing assertions for produce and consume tasks, state of consumers, topics, offsets etc.
      • +
    +

    Getting started writing tests

    +

    Easiest way of starting to write Kafka tests is to extend KafkaCompanionTestBase. +It starts a single-node Kafka broker for the test suite using testcontainers and creates the KafkaCompanion to connect to this broker:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
    public class KafkaWithBaseTest extends KafkaCompanionTestBase {
+
+    @Test
+    public void testWithBase() {
+        // companion is created by the base class
+
+        // produce 100 records to messages topic
+        ProducerTask producerTask = companion.produceIntegers()
+                .usingGenerator(i -> new ProducerRecord<>("messages", i), 100);
+        long msgCount = producerTask.awaitCompletion().count();
+        Assertions.assertEquals(msgCount, 100);
+
+        // consume 100 records from messages topic
+        ConsumerTask<String, Integer> consumerTask = companion.consumeIntegers()
+                .fromTopics("messages", 100);
+        ConsumerRecord<String, Integer> lastRecord = consumerTask.awaitCompletion().getLastRecord();
+        Assertions.assertEquals(lastRecord.value(), 99);
+    }
+}
+
    +
    +

    KafkaCompanion can be used on its own to connect to a broker:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
    // Create companion with bootstrap servers and API timeout (default is 10 seconds)
+KafkaCompanion companion = new KafkaCompanion("localhost:9092", Duration.ofSeconds(5));
+
+// Create producer and start producer task
+ProducerBuilder<String, Integer> producer = companion.produceIntegers()
+        .withClientId("my-producer")
+        .withProp("max.block.ms", "5000");
+producer.usingGenerator(i -> new ProducerRecord<>("topic", i), 100);
+
+// Create consumer and start consumer task
+ConsumerBuilder<String, Integer> consumer = companion.consumeIntegers()
+        .withGroupId("my-group")
+        .withCommitAsyncWhen(record -> true);
+ConsumerTask<String, Integer> records = consumer.fromTopics("topic", Duration.ofSeconds(10));
+// Await completion and assert consumed record count
+Assertions.assertEquals(records.awaitCompletion().count(), 100);
+
    +
    +

    There are a couple of things to note on how Kafka companion handles producers, consumers and tasks:

    +

    ProducerBuilder and ConsumerBuilder lazy descriptions of with which configuration to create a producer or a consumer.

    +

    ProducerTask and ConsumerTask run asynchronously on dedicated threads and are started as soon as they are created. +A task terminates when it is explicitly stopped, when it's predefined duration or number of records has been produced/consumed, or when it encounters an error. +An exterior thread can await on records processed, or simply on termination of the task. +At a given time produced or consumed records are accessible through the task.

    +

    The actual creation of the producer or consumer happens when a task is started. When the task terminates the producer or the consumer is automatically closed.

    +

    For example, in the previous example:

    +
      +
    1. We described a producer with a client id my-producer and max.block.ms of 5 seconds.
      2. +
    2. Then we created a task to produce 100 records using the generator function, without waiting for its completion.
      3. +
    3. We then described a consumer with group id my-group and which commits offset synchronously on every received record.
      4. +
    4. Finally, we created a task to consume records for 10 seconds and await its completion.
      5. +
    +

    Producing records

    +

    Produce from records

    +

    Produce given records: +
    1
+2
+3
+4
    companion.produce(byte[].class).fromRecords(
+        new ProducerRecord<>("topic1", "k1", "1".getBytes()),
+        new ProducerRecord<>("topic1", "k2", "2".getBytes()),
+        new ProducerRecord<>("topic1", "k3", "3".getBytes()));
+
    +

    +

    Produce from generator function

    +

    Produce 10 records using the generator function: +
    1
    companion.produceIntegers().usingGenerator(i -> new ProducerRecord<>("topic", i), 10);
+
    +

    +

    Produce from CSV file

    +

    Given a comma-separated file records.csv with the following content +
    1
+2
+3
    messages,0,a,asdf
+messages,1,b,asdf
+messages,3,c,asdf
+
    +

    +

    Produce records from the file: +
    1
    companion.produceStrings().fromCsv("records.csv");
+
    +

    +

    Consuming records

    +

    Consume from topics

    +
    1
    companion.consumeIntegers().fromTopics("topic1", "topic2");
+
    +
    +

    Consume from offsets

    +
    1
+2
+3
+4
    Map<TopicPartition, Long> offsets = new HashMap<>();
+offsets.put(new TopicPartition("topic1", 0), 100L);
+offsets.put(new TopicPartition("topic2", 0), 100L);
+companion.consumeIntegers().fromOffsets(offsets, Duration.ofSeconds(10));
+
    +
    +

    Consumer assignment and offsets

    +

    During execution of the consumer task, information about the underlying consumer's topic partition assignment, position or committed offsets can be accessed. +
    1
+2
+3
+4
+5
+6
    ConsumerBuilder<String, Integer> consumer = companion.consumeIntegers()
+        .withAutoCommit();
+consumer.fromTopics("topic");
+// ...
+await().untilAsserted(consumer::waitForAssignment);
+consumer.committed(new TopicPartition("topic", 1));
+
    +

    +

    Registering Custom Serdes

    +

    KafkaCompanion handles Serializers and Deserializers for default types such as primitives, String, ByteBuffer, UUID.

    +

    Serdes for custom types can be registered to the companion object, and will be used for producer and consumer tasks:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
    KafkaCompanion companion = new KafkaCompanion("localhost:9092");
+
+// Register serde to the companion
+companion.registerSerde(Orders.class, new OrdersSerializer(), new OrdersDeserializer());
+
+// Companion will configure consumer accordingly
+ConsumerTask<Integer, Orders> orders = companion.consume(Integer.class, Orders.class)
+        .fromTopics("orders", 1000).awaitCompletion();
+
+for (ConsumerRecord<Integer, Orders> order : orders) {
+    // ... check consumed records
+}
+
    +
    +

    Topics

    +

    Create, list, describe and delete topics: +
    1
+2
+3
+4
+5
    companion.topics().create("topic1", 1);
+companion.topics().createAndWait("topic2", 3);
+Assertions.assertEquals(companion.topics().list().size(), 2);
+
+companion.topics().delete("topic1");
+
    +

    +

    Consumer Groups and Offsets

    +

    List topic partition offsets: +
    1
+2
    TopicPartition topicPartition = KafkaCompanion.tp("topic", 1);
+long latestOffset = companion.offsets().get(topicPartition, OffsetSpec.latest()).offset();
+
    +

    +

    List, describe, alter consumer groups and their offsets: +
    1
+2
+3
+4
+5
+6
+7
    Collection<ConsumerGroupListing> consumerGroups = companion.consumerGroups().list();
+for (ConsumerGroupListing consumerGroup : consumerGroups) {
+    // check consumer groups
+}
+
+TopicPartition topicPartition = KafkaCompanion.tp("topic", 1);
+companion.consumerGroups().resetOffsets("consumer-group", topicPartition);
+
    +

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/transactions/index.html b/3.25.0/kafka/transactions/index.html new file mode 100644 index 0000000000..4b957c37bc --- /dev/null +++ b/3.25.0/kafka/transactions/index.html @@ -0,0 +1,1780 @@ + + + + + + + + + + + + + + + + + + Kafka Transactions and Exactly-Once Processing - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Kafka Transactions and Exactly-Once Processing

    +
    +

    Experimental

    +

    Kafka Transactions is an experimental feature.

    +
    +

    Kafka transactions enable atomic writes to multiple Kafka topics and partitions. +Inside a transaction, a producer writes records to the Kafka topic partitions as it would normally do. +If the transaction completes successfully, all the records previously written to the broker inside that transaction will be committed, and will be readable for consumers. +If an error during the transaction causes it to be aborted, none will be readable for consumers.

    +

    There are a couple of fundamental things to consider before using transactions:

    +
      +
    • +

      Each transactional producer is configured with a unique identifier called the transactional.id. +This is used to identify the same producer instance across application restarts. +By default, it is not configured, and transactions cannot be used. +When it is configured, the producer is limited to idempotent delivery, therefore enable.idempotence=true is implied.

      +
      • +
    • +

      For only reading transactional messages, a consumer needs to explicitly configure its isolation.level property to read_committed. +This will make sure that the consumer will deliver only records committed inside a transaction, and filter out messages from aborted transactions.

      +
      • +
    • +

      It should also be noted that this does not mean all records atomically written inside a transaction will be read atomically by the consumer. +Transactional producers can write to multiple topics and partitions inside a transaction, but consumers do not know where the transaction starts or ends. +Not only multiple consumers inside a consumer group can share those partitions, +all records which were part of a single transaction can be consumed in different batch of records by a consumer.

      +
      • +
    +

    Kafka connector provides KafkaTransactions custom emitter for writing records inside a transaction. +Before using a transaction we need to make sure that transactional.id is configured on the channel properties.

    +
    1
    mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer
+
    +
    +

    It can be used as a regular emitter @Channel:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
    package kafka.outbound;
+
+import javax.enterprise.context.ApplicationScoped;
+import javax.inject.Inject;
+
+import org.eclipse.microprofile.reactive.messaging.Channel;
+
+import io.smallrye.mutiny.Uni;
+import io.smallrye.reactive.messaging.kafka.KafkaRecord;
+import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions;
+
+@ApplicationScoped
+public class KafkaTransactionalProducer {
+
+    @Inject
+    @Channel("tx-out-example")
+    KafkaTransactions<String> txProducer;
+
+    public Uni<Void> emitInTransaction() {
+        return txProducer.withTransaction(emitter -> {
+            emitter.send(KafkaRecord.of(1, "a"));
+            emitter.send(KafkaRecord.of(2, "b"));
+            emitter.send(KafkaRecord.of(3, "c"));
+            return Uni.createFrom().voidItem();
+        });
+    }
+
+}
+
    +
    +
    +

    Note

    +

    When transactional.id is provided KafkaProducer#initTransactions is called when the underlying Kafka producer is created.

    +
    +

    The function given to the withTransaction method receives a TransactionalEmitter for producing records, and returns a Uni that provides the result of the transaction. +If the processing completes successfully, the producer is flushed and the transaction is committed. +If the processing throws an exception, returns a failing Uni, or marks the TransactionalEmitter for abort, the transaction is aborted.

    +

    If this method is called on a Vert.x context, the processing function is also called on that context. +Otherwise, it is called on the sending thread of the producer.

    +
    +

    Important

    +

    A transaction is considered in progress from the call to the withTransaction until the returned Uni results in success or failure. +While a transaction is in progress, subsequent calls to the withTransaction, including nested ones inside the given function, will throw IllegalStateException. +Note that in Reactive Messaging, the execution of processing methods is already serialized, unless @Blocking(ordered = false) is used. +If withTransaction can be called concurrently, for example from a REST endpoint, it is recommended to limit the concurrency of the execution. +This can be done using the @Bulkhead annotation from Microprofile Fault Tolerance.

    +
    +

    Exactly-Once Processing

    +

    Kafka Transactions API also allows managing consumer offsets inside a transaction, together with produced messages. +This in turn enables coupling a consumer with a transactional producer in a consume-transform-produce pattern, +also known as exactly-once processing. +It means that an application consumes messages from a topic-partition, processes them, publishes the results to a topic-partition, +and commits offsets of the consumed messages in a transaction.

    +

    The KafkaTransactions emitter also provides a way to apply exactly-once processing to an incoming Kafka message inside a transaction.

    +

    The following example includes a batch of Kafka records inside a transaction.

    +
    1
+2
+3
+4
    mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer
+mp.messaging.outgoing.in-channel.batch=true
+mp.messaging.outgoing.in-channel.commit-strategy=ignore
+mp.messaging.outgoing.in-channel.failure-strategy=ignore
+
    +
    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
    package kafka.outbound;
+
+import javax.enterprise.context.ApplicationScoped;
+import javax.inject.Inject;
+
+import org.eclipse.microprofile.reactive.messaging.Channel;
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+import io.smallrye.mutiny.Uni;
+import io.smallrye.reactive.messaging.kafka.KafkaRecord;
+import io.smallrye.reactive.messaging.kafka.KafkaRecordBatch;
+import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions;
+
+@ApplicationScoped
+public class KafkaExactlyOnceProcessor {
+
+    @Inject
+    @Channel("tx-out-example")
+    KafkaTransactions<Integer> txProducer;
+
+    @Incoming("in-channel")
+    public Uni<Void> emitInTransaction(KafkaRecordBatch<String, Integer> batch) {
+        return txProducer.withTransaction(batch, emitter -> {
+            for (KafkaRecord<String, Integer> record : batch) {
+                emitter.send(KafkaRecord.of(record.getKey(), record.getPayload() + 1));
+            }
+            return Uni.createFrom().voidItem();
+        });
+    }
+
+}
+
    +
    +

    If the processing completes successfully, before committing the transaction, the topic partition offsets of the given batch message will be committed to the transaction.

    +

    If the processing needs to abort, after aborting the transaction, the consumer's position is reset to the last committed offset, effectively resuming the consumption from that offset. +If no consumer offset has been committed, the consumer's position is reset to the beginning of the topic, even if the offset reset policy is latest.

    +
    +

    Important

    +

    When using exactly-once processing, consumed message offset commits are handled by the transaction and therefore commit-strategy needs to be ignore.

    +
    +

    Any strategy can be employed for the failure-strategy. +Note that the Uni returned from the #withTransaction will yield a failure if the transaction fails and is aborted.

    +

    The application can choose to handle the error case, but for the message consumption to continue, Uni returned from the @Incoming method must not result in failure. +KafkaTransactions#withTransactionAndAck method will ack and nack the message but will not stop the reactive stream. +Ignoring the failure simply resets the consumer to the last committed offsets and resumes the processing from there.

    +
    +

    Note

    +

    It is recommended to use exactly-once processing along with the batch consumption mode. +While it is possible to use it with a single Kafka message, it'll have a significant performance impact.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/kafka/writing-kafka-records/index.html b/3.25.0/kafka/writing-kafka-records/index.html new file mode 100644 index 0000000000..4dc90a57e5 --- /dev/null +++ b/3.25.0/kafka/writing-kafka-records/index.html @@ -0,0 +1,2661 @@ + + + + + + + + + + + + + + + + + + Writing records - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Writing Kafka Records

    +

    The Kafka Connector can write Reactive Messaging Messages as Kafka +Records.

    +

    Example

    +

    Let’s imagine you have a Kafka broker running, and accessible using the +kafka:9092 address (by default it would use localhost:9092). +Configure your application to write the messages from the prices +channel into a Kafka topic as follows:

    +

    1
+2
+3
+4
+5
    kafka.bootstrap.servers=kafka:9092 # <1>
+
+mp.messaging.outgoing.prices-out.connector=smallrye-kafka # <2>
+mp.messaging.outgoing.prices-out.value.serializer=org.apache.kafka.common.serialization.DoubleSerializer # <3>
+mp.messaging.outgoing.prices-out.topic=prices # <4>
+
    +
    +1. Configure the broker location. You can configure it globally or per + channel +2. Configure the connector to manage the prices channel +3. Sets the (Kafka) serializer to encode the message payload into the + record’s value +4. Make sure the topic name is prices (and not the default + prices-out)

    +

    Then, your application must send Message<Double> to the prices +channel. It can use double payloads as in the following snippet:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    package kafka.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class KafkaPriceProducer {
+
+    private final Random random = new Random();
+
+    @Outgoing("prices-out")
+    public Multi<Double> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble());
+    }
+
+}
+
    +
    +

    Or, you can send Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
    package kafka.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class KafkaPriceMessageProducer {
+
+    private final Random random = new Random();
+
+    @Outgoing("prices-out")
+    public Multi<Message<Double>> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> Message.of(random.nextDouble()));
+    }
+
+}
+
    +
    +

    Serialization

    +

    The serialization is handled by the underlying Kafka Client. You need to +configure the:

    +
      +
    • +

      mp.messaging.outgoing.[channel-name].value.serializer to configure + the value serializer (mandatory)

      +
      • +
    • +

      mp.messaging.outgoing.[channel-name].key.serializer to configure + the key serializer (optional, default to String)

      +
      • +
    +

    If you want to use a custom serializer, add it to your CLASSPATH and +configure the associate attribute.

    +

    By default, the written record contains:

    +
      +
    • +

      the Message payload as value

      +
      • +
    • +

      no key, or the key configured using the key attribute or the key + passed in the metadata attached to the Message

      +
      • +
    • +

      the timestamp computed for the system clock (now) or the timestamp + passed in the metadata attached to the Message

      +
      • +
    +

    Sending key/value pairs

    +

    In the Kafka world, it’s often necessary to send records, i.e. a +key/value pair. The connector provides the io.smallrye.reactive.messaging.kafka.Record +class that you can use to send a pair:

    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public Record<String, String> process(String in) {
+    return Record.of("my-key", in);
+}
+
    +
    +

    When the connector receives a message with a Record payload, it +extracts the key and value from it. The configured serializers for the +key and the value must be compatible with the record’s key and value. +Note that the key and the value can be null. It is also possible +to create a record with a null key AND a null value.

    +

    If you need more control on the written records, use +OutgoingKafkaRecordMetadata.

    +

    Outbound Metadata

    +

    When sending Messages, you can add an instance of +OutgoingKafkaRecordMetadata +to influence how the message is going to be written to Kafka. For example, +you can add Kafka headers, configure the record key…

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
    // Creates an OutgoingKafkaRecordMetadata
+// The type parameter is the type of the record's key
+OutgoingKafkaRecordMetadata<String> metadata = OutgoingKafkaRecordMetadata.<String> builder()
+        .withKey("my-key")
+        .withHeaders(new RecordHeaders().add("my-header", "value".getBytes()))
+        .build();
+
+// Create a new message from the `incoming` message
+// Add `metadata` to the metadata from the `incoming` message.
+return incoming.addMetadata(metadata);
+
    +
    +

    Propagating Record Key

    +

    When processing messages, you can propagate incoming record key to the +outgoing record.

    +

    Consider the following example method, which consumes messages from the +channel in, transforms the payload, and writes the result to the +channel out.

    +
    1
+2
+3
+4
+5
    @Incoming("in")
+@Outgoing("out")
+public double process(int in) {
+    return in * 0.88;
+}
+
    +
    +

    Enabled with +mp.messaging.outgoing.[channel-name].propagate-record-key=true +configuration, record key propagation produces the outgoing record with +the same key as the incoming record.

    +

    If the outgoing record already contains a key, it won’t be +overridden by the incoming record key. If the incoming record does +have a null key, the mp.messaging.outgoing.[channel-name].key +property is used.

    +

    Propagating Record headers

    +

    You can also propagate incoming record headers to the outgoing record, by specifying the list of headers to be considered.

    +

    mp.messaging.outgoing.[channel-name].propagate-headers=Authorization,Proxy-Authorization

    +

    If the ougoing record already defines a header with the same key, it won't be overriden by the incoming header.

    +

    Dynamic topic names

    +

    Sometimes it is desirable to select the destination of a message +dynamically. In this case, you should not configure the topic inside +your application configuration file, but instead, use the outbound +metadata to set the name of the topic.

    +

    For example, you can route to a dynamic topic based on the incoming +message:

    +
    1
+2
+3
+4
+5
+6
+7
+8
    String topicName = selectTopicFromIncommingMessage(incoming);
+OutgoingKafkaRecordMetadata<String> metadata = OutgoingKafkaRecordMetadata.<String> builder()
+        .withTopic(topicName)
+        .build();
+
+// Create a new message from the `incoming` message
+// Add `metadata` to the metadata from the `incoming` message.
+return incoming.addMetadata(metadata);
+
    +
    +

    Acknowledgement

    +

    Kafka acknowledgement can take times depending on the configuration. +Also, it stores in-memory the records that cannot be written.

    +

    By default, the connector does wait for Kafka to acknowledge the record +to continue the processing (acknowledging the received Message). You +can disable this by setting the waitForWriteCompletion attribute to +false.

    +

    Note that the acks attribute has a huge impact on the record +acknowledgement.

    +

    If a record cannot be written, the message is nacked.

    +

    Back-pressure and inflight records

    +

    The Kafka outbound connector handles back-pressure monitoring the number +of in-flight messages waiting to be written to the Kafka broker. The +number of in-flight messages is configured using the +max-inflight-messages attribute and defaults to 1024.

    +

    The connector only sends that amount of messages concurrently. No other +messages will be sent until at least one in-flight message gets +acknowledged by the broker. Then, the connector writes a new message to +Kafka when one of the broker’s in-flight messages get acknowledged. Be +sure to configure Kafka’s batch.size and linger.ms accordingly.

    +

    You can also remove the limit of inflight messages by setting +max-inflight-messages to 0. However, note that the Kafka Producer +may block if the number of requests reaches +max.in.flight.requests.per.connection.

    +

    Handling serialization failures

    +

    For Kafka producer client serialization failures are not recoverable, +thus the message dispatch is not retried. However, using schema +registries, serialization may intermittently fail to contact the +registry. In these cases you may need to apply a failure strategy for +the serializer. To achieve this, create a CDI bean implementing the SerializationFailureHandler +interface:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
    @ApplicationScoped
+@Identifier("failure-fallback") // Set the name of the failure handler
+public class MySerializationFailureHandler
+    implements SerializationFailureHandler<JsonObject> { // Specify the expected type
+
+    @Override
+    public byte[] decorateSerialization(Uni<byte[]> serialization, String topic,
+                boolean isKey, String serializer,
+                Object data, Headers headers) {
+        return serialization
+                    .onFailure().retry().atMost(3)
+                    .await().atMost(Duration.ofMillis(200));
+    }
+}
+
    +
    +

    The bean must be exposed with the @Identifier qualifier specifying the +name of the bean. Then, in the connector configuration, specify the +following attribute:

    +
      +
    • +

      mp.messaging.incoming.$channel.key-serialization-failure-handler: + name of the bean handling serialization failures happening for the + record’s key

      +
      • +
    • +

      mp.messaging.incoming.$channel.value-serialization-failure-handler: + name of the bean handling serialization failures happening for the + record’s value,

      +
      • +
    +

    The handler is called with the serialization action as a Uni, the +record’s topic, a boolean indicating whether the failure happened on a +key, the class name of the deserializer that throws the exception, the +corrupted data, the exception, and the records headers. Failure +strategies like retry, providing a fallback value or applying timeout +can be implemented. Note that the method must await on the result and +return the serialized byte array. Alternatively, the handler can +implement decorateSerialization method which can return a fallback +value.

    +

    Sending Cloud Events

    +

    The Kafka connector supports Cloud Events. +The connector sends the outbound record as Cloud Events if:

    +
      +
    • +

      the message metadata contains an + io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata + instance,

      +
      • +
    • +

      the channel configuration defines the cloud-events-type and + cloud-events-source attributes.

      +
      • +
    +

    You can create +io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances +using:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    package kafka.outbound;
+
+import java.net.URI;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata;
+
+@ApplicationScoped
+public class KafkaCloudEventProcessor {
+
+    @Outgoing("cloud-events")
+    public Message<String> toCloudEvents(Message<String> in) {
+        return in.addMetadata(OutgoingCloudEventMetadata.builder()
+                .withId("id-" + in.getPayload())
+                .withType("greetings")
+                .withSource(URI.create("http://example.com"))
+                .withSubject("greeting-message")
+                .build());
+    }
+
+}
+
    +
    +

    If the metadata does not contain an id, the connector generates one +(random UUID). The type and source can be configured per message or +at the channel level using the cloud-events-type and +cloud-events-source attributes. Other attributes are also +configurable.

    +

    The metadata can be contributed by multiple methods, however, you must +always retrieve the already existing metadata to avoid overriding the +values:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
    package kafka.outbound;
+
+import java.net.URI;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata;
+
+@ApplicationScoped
+public class KafkaCloudEventMultipleProcessors {
+
+    @Incoming("source")
+    @Outgoing("processed")
+    public Message<String> process(Message<String> in) {
+        return in.addMetadata(OutgoingCloudEventMetadata.builder()
+                .withId("id-" + in.getPayload())
+                .withType("greeting")
+                .build());
+    }
+
+    @SuppressWarnings("unchecked")
+    @Incoming("processed")
+    @Outgoing("cloud-events")
+    public Message<String> process2(Message<String> in) {
+        OutgoingCloudEventMetadata<String> metadata = in
+                .getMetadata(OutgoingCloudEventMetadata.class)
+                .orElseGet(() -> OutgoingCloudEventMetadata.builder().build());
+
+        return in.addMetadata(OutgoingCloudEventMetadata.from(metadata)
+                .withSource(URI.create("source://me"))
+                .withSubject("test")
+                .build());
+    }
+
+}
+
    +
    +

    By default, the connector sends the Cloud Events using the binary +format. You can write structured Cloud Events by setting the +cloud-events-mode to structured. Only JSON is supported, so the +created records had its content-type header set to +application/cloudevents+json; charset=UTF-8 When using the +structured mode, the value serializer must be set to +org.apache.kafka.common.serialization.StringSerializer, otherwise the +connector reports the error. In addition, in structured, the connector +maps the message’s payload to JSON, except for String passed directly.

    +

    The record’s key can be set in the channel configuration (key +attribute), in the OutgoingKafkaRecordMetadata or using the +partitionkey Cloud Event attribute.

    +
    +

    Note

    +

    you can disable the Cloud Event support by setting the cloud-events +attribute to false

    +
    +

    Using ProducerRecord

    +

    Kafka built-in type +ProducerRecord\ +can also be used for producing messages:

    +
    1
+2
+3
+4
    @Outgoing("out")
+public ProducerRecord<String, String> generate() {
+    return new ProducerRecord<>("my-topic", "key", "value");
+}
+
    +
    +
    +

    Warning

    +

    This is an advanced feature. The ProducerRecord is sent to Kafka as +is. Any possible metadata attached through Message<ProducerRecord<K, V>> are ignored and lost.

    +
    +

    Producer Interceptors

    +

    Producer interceptors can be configured for Kafka producer clients using the standard interceptor.classes property. +Configured classes will be instantiated by the Kafka producer on client creation.

    +

    Alternatively, producer clients can be configured with a CDI managed-bean implementing org.apache.kafka.clients.producer.ProducerInterceptor interface:

    +

    To achieve this, the bean must be exposed with the @Identifier qualifier specifying the name of the bean:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
    package kafka.outbound;
+
+import java.util.Map;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.apache.kafka.clients.producer.ProducerInterceptor;
+import org.apache.kafka.clients.producer.ProducerRecord;
+import org.apache.kafka.clients.producer.RecordMetadata;
+
+import io.smallrye.common.annotation.Identifier;
+
+@ApplicationScoped
+@Identifier("my-producer-interceptor")
+public class ProducerInterceptorBeanExample implements ProducerInterceptor<Integer, String> {
+
+    @Override
+    public ProducerRecord<Integer, String> onSend(ProducerRecord<Integer, String> producerRecord) {
+        // called before send
+        return producerRecord;
+    }
+
+    @Override
+    public void onAcknowledgement(RecordMetadata recordMetadata, Exception e) {
+        // called on send acknowledgement callback
+    }
+
+    @Override
+    public void close() {
+        // called on client close
+    }
+
+    @Override
+    public void configure(Map<String, ?> map) {
+        // called on client configuration
+    }
+}
+
    +
    +

    Then, in the channel configuration, specify the following attribute: +mp.messaging.incoming.$channel.interceptor-bean=my-producer-interceptor.

    +
    +

    Warning

    +

    The onSend method will be called on the producer sending thread and onAcknowledgement will be called on the Kafka producer I/O thread. +In both cases if implementations are not fast, sending of messages could be delayed.

    +
    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    acksThe number of acknowledgments the producer requires the leader to have received before considering a request complete. This controls the durability of records that are sent. Accepted values are: 0, 1, allstringfalse1
    bootstrap.servers (kafka.bootstrap.servers)A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster.stringfalselocalhost:9092
    buffer.memoryThe total bytes of memory the producer can use to buffer records waiting to be sent to the server.longfalse33554432
    client-id-prefixPrefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value.stringfalse
    close-timeoutThe amount of milliseconds waiting for a graceful shutdown of the Kafka producerintfalse10000
    cloud-eventsEnables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing, the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata.booleanfalsetrue
    cloud-events-data-content-type (cloud-events-default-data-content-type)Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the datacontenttype attribute itselfstringfalse
    cloud-events-data-schema (cloud-events-default-data-schema)Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the dataschema attribute itselfstringfalse
    cloud-events-insert-timestamp (cloud-events-default-timestamp)Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the time attribute itselfbooleanfalsetrue
    cloud-events-modeThe Cloud Event mode (structured or binary (default)). Indicates how are written the cloud events in the outgoing recordstringfalsebinary
    cloud-events-source (cloud-events-default-source)Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the source attribute itselfstringfalse
    cloud-events-subject (cloud-events-default-subject)Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the subject attribute itselfstringfalse
    cloud-events-type (cloud-events-default-type)Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true. This value is used if the message does not configure the type attribute itselfstringfalse
    health-enabledWhether health reporting is enabled (default) or disabledbooleanfalsetrue
    health-readiness-enabledWhether readiness health reporting is enabled (default) or disabledbooleanfalsetrue
    health-readiness-timeoutdeprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead.longfalse
    health-readiness-topic-verificationdeprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead.booleanfalse
    health-topic-verification-enabledWhether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection.booleanfalsefalse
    health-topic-verification-timeoutDuring the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready.longfalse2000
    interceptor-beanThe name set in @Identifier of a bean that implements org.apache.kafka.clients.producer.ProducerInterceptor. If set, the identified bean will be used as the producer interceptor.stringfalse
    kafka-configurationIdentifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier.stringfalse
    keyA key to used when writing the recordstringfalse
    key-serialization-failure-handlerThe name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler. If set, serialization failure happening when serializing keys are delegated to this handler which may provide a fallback value.stringfalse
    key.serializerThe serializer classname used to serialize the record's keystringfalseorg.apache.kafka.common.serialization.StringSerializer
    lazy-clientWhether Kafka client is created lazily or eagerly.booleanfalsefalse
    max-inflight-messagesThe maximum number of messages to be written to Kafka concurrently. It limits the number of messages waiting to be written and acknowledged by the broker. You can set this attribute to 0 remove the limitlongfalse1024
    mergeWhether the connector should allow multiple upstreamsbooleanfalsefalse
    partitionThe target partition id. -1 to let the client determine the partitionintfalse-1
    propagate-headersA comma-separating list of incoming record headers to be propagated to the outgoing recordstringfalse``
    propagate-record-keyPropagate incoming record key to the outgoing recordbooleanfalsefalse
    retriesIf set to a positive number, the connector will try to resend any record that was not delivered successfully (with a potentially transient error) until the number of retries is reached. If set to 0, retries are disabled. If not set, the connector tries to resend any record that failed to be delivered (because of a potentially transient error) during an amount of time configured by delivery.timeout.ms.longfalse2147483647
    topicThe consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is usedstringfalse
    tracing-enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
    value-serialization-failure-handlerThe name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler. If set, serialization failure happening when serializing values are delegated to this handler which may provide a fallback value.stringfalse
    value.serializerThe serializer classname used to serialize the payloadstringtrue
    waitForWriteCompletionWhether the client waits for Kafka to acknowledge the written record before acknowledging the messagebooleanfalsetrue
    +

    You can also pass any property supported by the underlying Kafka +producer.

    +

    For example, to configure the batch.size property, use:

    +
    1
    mp.messaging.outgoing.[channel].batch.size=32768
+
    +
    +

    Some producer client properties are configured to sensible default +values:

    +

    If not set, reconnect.backoff.max.ms is set to 10000 to avoid high +load on disconnection.

    +

    If not set, key.serializer is set to +org.apache.kafka.common.serialization.StringSerializer.

    +

    If not set, producer client.id is generated as +kafka-producer-[channel].

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/mqtt/client-customization/index.html b/3.25.0/mqtt/client-customization/index.html new file mode 100644 index 0000000000..f8ef8d08c3 --- /dev/null +++ b/3.25.0/mqtt/client-customization/index.html @@ -0,0 +1,1559 @@ + + + + + + + + + + + + + + + + + + Customizing the MQTT client - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Customizing the underlying MQTT client

    +

    You can customize the underlying MQTT Client configuration by +producing an instance of +io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    @Produces
+@Identifier("my-options")
+public MqttClientSessionOptions getOptions() {
+    // You can use the produced options to configure the TLS connection
+    PemKeyCertOptions keycert = new PemKeyCertOptions()
+            .addCertPath("./tls/tls.crt")
+            .addKeyPath("./tls/tls.key");
+    PemTrustOptions trust = new PemTrustOptions().addCertPath("./tlc/ca.crt");
+
+    return new MqttClientSessionOptions()
+            .setSsl(true)
+            .setPemKeyCertOptions(keycert)
+            .setPemTrustOptions(trust)
+            .setHostnameVerificationAlgorithm("")
+            .setConnectTimeout(30000)
+            .setReconnectInterval(5000);
+}
+
    +
    +

    This instance is retrieved and used to configure the client used by the +connector. You need to indicate the name of the client using the +client-options-name attribute:

    +
    1
    mp.messaging.incoming.prices.client-options-name=my-options
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/mqtt/mqtt/index.html b/3.25.0/mqtt/mqtt/index.html new file mode 100644 index 0000000000..2446f7ee01 --- /dev/null +++ b/3.25.0/mqtt/mqtt/index.html @@ -0,0 +1,1626 @@ + + + + + + + + + + + + + + + + + + MQTT Connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    MQTT Connector

    +

    The MQTT connector adds support for MQTT to Reactive Messaging.

    +

    It lets you receive messages from an MQTT server or broker as well as +send MQTT messages. The MQTT connector is based on the Vert.x MQTT +Client.

    +

    Introduction

    +

    MQTT is a machine-to-machine (M2M)/"Internet of +Things" connectivity protocol. It was designed as an extremely +lightweight publish/subscribe messaging transport.

    +

    The MQTT Connector allows consuming messages from MQTT as well as +sending MQTT messages.

    +

    Using the MQTT connector

    +

    To you the MQTT Connector, add the following dependency to your project:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-mqtt</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
    +
    +

    The connector name is: smallrye-mqtt.

    +

    So, to indicate that a channel is managed by this connector you need: +
    1
+2
+3
+4
+5
    # Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-mqtt
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-mqtt
+
    +

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/mqtt/receiving-mqtt-messages/index.html b/3.25.0/mqtt/receiving-mqtt-messages/index.html new file mode 100644 index 0000000000..7032491bdb --- /dev/null +++ b/3.25.0/mqtt/receiving-mqtt-messages/index.html @@ -0,0 +1,2027 @@ + + + + + + + + + + + + + + + + + + Receiving MQTT messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Receiving messages from MQTT

    +

    The MQTT Connector connects to a MQTT broker or router, and forward the +messages to the Reactive Messaging application. It maps each of them +into Reactive Messaging Messages.

    +

    Example

    +

    Let’s imagine you have a MQTT server/broker running, and accessible +using the mqtt:1883 address (by default it would use +localhost:1883). Configure your application to receive MQTT messages +on the prices channel as follows:

    +

    1
+2
+3
    mp.messaging.incoming.prices.connector=smallrye-mqtt # <1>
+mp.messaging.incoming.prices.host=mqtt # <2>
+mp.messaging.incoming.prices.port=1883 # <3>
+
    +
    +1. Sets the connector for the prices channel +2. Configure the broker/server host name. +3. Configure the broker/server port. 1883 is the default.

    +
    +

    Note

    +

    You don’t need to set the MQTT topic. By default, it uses the channel +name (prices). You can configure the topic attribute to override it.

    +
    +
    +

    Note

    +

    It is generally recommended to set the client-id. By default, the connector is generating a unique client-id.

    +
    +
    +

    Important

    +

    Message coming from MQTT have a byte[] payload.

    +
    +

    Then, your application receives Message<byte[]>. You can consume the +payload directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    package mqtt.inbound;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class MqttPriceConsumer {
+
+    @Incoming("prices")
+    public void consume(byte[] raw) {
+        double price = Double.parseDouble(new String(raw));
+
+        // process your price.
+    }
+
+}
+
    +
    +

    Or, you can retrieve the Message<byte[]>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
    package mqtt.inbound;
+
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class MqttPriceMessageConsumer {
+
+    @Incoming("prices")
+    public CompletionStage<Void> consume(Message<byte[]> price) {
+        // process your price.
+
+        // Acknowledge the incoming message
+        return price.ack();
+    }
+
+}
+
    +
    +

    The inbound topic can use the MQTT +wildcards (+ and #).

    +

    Deserialization

    +

    The MQTT Connector does not handle the deserialization and creates a +Message<byte[]>.

    +

    Inbound Metadata

    +

    The MQTT connector does not provide inbound metadata.

    +

    Failure Management

    +

    If a message produced from a MQTT message is nacked, a failure +strategy is applied. The MQTT connector supports 3 strategies:

    +
      +
    • +

      fail - fail the application, no more MQTT messages will be + processed. (default) The offset of the record that has not been + processed correctly is not committed.

      +
      • +
    • +

      ignore - the failure is logged, but the processing continue.

      +
      • +
    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    auto-clean-sessionSet to start with a clean session (true by default)booleanfalsetrue
    auto-generated-client-idSet if the MQTT client must generate clientId automaticallybooleanfalsetrue
    auto-keep-aliveSet if the MQTT client must handle PINGREQ automaticallybooleanfalsetrue
    broadcastWhether or not the messages should be dispatched to multiple consumersbooleanfalsefalse
    buffer-sizeThe size buffer of incoming messages waiting to be processedintfalse128
    client-idSet the client identifierstringfalse
    client-options-name (mqtt-client-options-name)The name of the MQTT Client Option bean (io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions) used to customize the MQTT client configurationstringfalse
    connect-timeout-secondsSet the connect timeout (in seconds)intfalse60
    failure-strategySpecify the failure strategy to apply when a message produced from a MQTT message is nacked. Values can be fail (default), or ignorestringfalsefail
    health-enabledWhether health reporting is enabled (default) or disabledbooleanfalsetrue
    hostSet the MQTT server host name/IPstringtrue
    keep-alive-secondsSet the keep alive timeout in secondsintfalse30
    max-inflight-queueSet max count of unacknowledged messagesintfalse10
    max-message-sizeSet max MQTT message size in bytesintfalse8092
    passwordSet the password to connect to the serverstringfalse
    portSet the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without sslintfalse
    qosSet the QoS level when subscribing to the topic or when sending a messageintfalse0
    reconnect-interval-secondsSet the reconnect interval in secondsintfalse1
    server-nameSet the SNI server namestringfalse
    sslSet whether SSL/TLS is enabledbooleanfalsefalse
    ssl.keystore.locationSet the keystore location. In case of pem type this is the server ca cert pathstringfalse
    ssl.keystore.passwordSet the keystore password. In case of pem type this is the key pathstringfalse
    ssl.keystore.typeSet the keystore type [pkcs12, jks, pem]stringfalsepkcs12
    ssl.truststore.locationSet the truststore location. In case of pem type this is the client cert pathstringfalse
    ssl.truststore.passwordSet the truststore password. In case of pem type this is not necessarystringfalse
    ssl.truststore.typeSet the truststore type [pkcs12, jks, pem]stringfalsepkcs12
    topicSet the MQTT topic. If not set, the channel name is usedstringfalse
    trust-allSet whether all server certificates should be trustedbooleanfalsefalse
    unsubscribe-on-disconnectionThis flag restore the old behavior to unsubscribe from the broken on disconnectionbooleanfalsefalse
    usernameSet the username to connect to the serverstringfalse
    will-flagSet if will information are provided on connectionbooleanfalsefalse
    will-qosSet the QoS level for the will messageintfalse0
    will-retainSet if the will message must be retainedbooleanfalsefalse
    +

    The MQTT connector is based on the Vert.x MQTT +client. So +you can pass any attribute supported by this client.

    +
    +

    Important

    +

    A single instance of MqttClient and a single connection is used for +each host / port / server-name / client-id. This client is +reused for both the inbound and outbound connectors.

    +
    +
    +

    Important

    +

    Using auto-clean-session=false the MQTT Connector send Subscribe requests +to the broken only if a Persistent Session is not present (like on the first +connection). This means that if a Session is already present (maybe for a +previous run) and you add a new incoming channel, this will not be subscribed. +Beware to check always the subscription present on Broker when use +auto-clean-session=false.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/mqtt/sending-messages-to-mqtt/index.html b/3.25.0/mqtt/sending-messages-to-mqtt/index.html new file mode 100644 index 0000000000..242063b17d --- /dev/null +++ b/3.25.0/mqtt/sending-messages-to-mqtt/index.html @@ -0,0 +1,2036 @@ + + + + + + + + + + + + + + + + + + Sending MQTT messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Sending messages to MQTT

    +

    The MQTT Connector can write Reactive Messaging Messages as MQTT +Message.

    +

    Example

    +

    Let’s imagine you have a MQTT server/broker running, and accessible +using the mqtt:1883 address (by default it would use +localhost:1883). Configure your application to write the messages from +the prices channel into a MQTT Messages as follows:

    +
    1
+2
+3
    mp.messaging.outgoing.prices.type=smallrye-mqtt
+mp.messaging.outgoing.prices.host=mqtt
+mp.messaging.outgoing.prices.port=1883
+
    +
    +
      +
    1. Sets the connector for the prices channel
      2. +
    2. Configure the broker/server host name.
      3. +
    3. Configure the broker/server port. 1883 is the default.
      4. +
    +
    +

    Note

    +

    You don’t need to set the MQTT topic. By default, it uses the channel +name (prices). You can configure the topic attribute to override it. +NOTE: It is generally recommended to set the client-id. By default, +the connector is generating a unique client-id.

    +
    +

    Then, your application must send Message<Double> to the prices +channel. It can use double payloads as in the following snippet:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    package mqtt.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class MqttPriceProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Double> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble());
+    }
+
+}
+
    +
    +

    Or, you can send Message<Double>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
    package mqtt.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class MqttPriceMessageProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Message<Double>> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> Message.of(random.nextDouble()));
+    }
+
+}
+
    +
    +

    Serialization

    +

    The Message sent to MQTT can have various payload types:

    +
      +
    • +

      JsonObject: + JSON string encoded as byte[]

      +
      • +
    • +

      JsonArray: + JSON string encoded as byte[]

      +
      • +
    • +

      java.lang.String and Java primitive types: toString encoded as + byte[]

      +
      • +
    • +

      byte[]

      +
      • +
    • +

      complex objects: The objects are encoded to JSON and passed as + byte[]

      +
      • +
    +

    Outbound Metadata

    +

    The MQTT connector does not provide outbound metadata.

    +

    Acknowledgement

    +

    MQTT acknowledgement depends on the QoS level. The message is +acknowledged when the broker indicated the successful reception of the +message (or immediately if the level of QoS does not support +acknowledgment).

    +

    If a MQTT message cannot be sent to the broker, the message is nacked.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    auto-clean-sessionSet to start with a clean session (true by default)booleanfalsetrue
    auto-generated-client-idSet if the MQTT client must generate clientId automaticallybooleanfalsetrue
    auto-keep-aliveSet if the MQTT client must handle PINGREQ automaticallybooleanfalsetrue
    client-idSet the client identifierstringfalse
    client-options-name (mqtt-client-options-name)The name of the MQTT Client Option bean (io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions) used to customize the MQTT client configurationstringfalse
    connect-timeout-secondsSet the connect timeout (in seconds)intfalse60
    health-enabledWhether health reporting is enabled (default) or disabledbooleanfalsetrue
    hostSet the MQTT server host name/IPstringtrue
    keep-alive-secondsSet the keep alive timeout in secondsintfalse30
    max-inflight-queueSet max count of unacknowledged messagesintfalse10
    max-message-sizeSet max MQTT message size in bytesintfalse8092
    mergeWhether the connector should allow multiple upstreamsbooleanfalsefalse
    passwordSet the password to connect to the serverstringfalse
    portSet the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without sslintfalse
    qosSet the QoS level when subscribing to the topic or when sending a messageintfalse0
    reconnect-interval-secondsSet the reconnect interval in secondsintfalse1
    server-nameSet the SNI server namestringfalse
    sslSet whether SSL/TLS is enabledbooleanfalsefalse
    ssl.keystore.locationSet the keystore location. In case of pem type this is the server ca cert pathstringfalse
    ssl.keystore.passwordSet the keystore password. In case of pem type this is the key pathstringfalse
    ssl.keystore.typeSet the keystore type [pkcs12, jks, pem]stringfalsepkcs12
    ssl.truststore.locationSet the truststore location. In case of pem type this is the client cert pathstringfalse
    ssl.truststore.passwordSet the truststore password. In case of pem type this is not necessarystringfalse
    ssl.truststore.typeSet the truststore type [pkcs12, jks, pem]stringfalsepkcs12
    topicSet the MQTT topic. If not set, the channel name is usedstringfalse
    trust-allSet whether all server certificates should be trustedbooleanfalsefalse
    unsubscribe-on-disconnectionThis flag restore the old behavior to unsubscribe from the broken on disconnectionbooleanfalsefalse
    usernameSet the username to connect to the serverstringfalse
    will-flagSet if will information are provided on connectionbooleanfalsefalse
    will-qosSet the QoS level for the will messageintfalse0
    will-retainSet if the will message must be retainedbooleanfalsefalse
    +

    The MQTT connector is based on the Vert.x MQTT +client. So +you can pass any attribute supported by this client.

    +
    +

    Important

    +

    A single instance of MqttClient and a single connection is used for +each host / port / server-name / client-id. This client is +reused for both the inbound and outbound connectors.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/rabbitmq-client-customization/index.html b/3.25.0/rabbitmq/rabbitmq-client-customization/index.html new file mode 100644 index 0000000000..15ff4ccc63 --- /dev/null +++ b/3.25.0/rabbitmq/rabbitmq-client-customization/index.html @@ -0,0 +1,1578 @@ + + + + + + + + + + + + + + + + + + Client Customization - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Customizing the underlying RabbitMQ client

    +

    You can customize the underlying RabbitMQ Client configuration by +producing an instance of +RabbitMQOptions:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
    @Produces
+@Identifier("my-named-options")
+public RabbitMQOptions getNamedOptions() {
+    // You can use the produced options to configure the TLS connection
+    PemKeyCertOptions keycert = new PemKeyCertOptions()
+            .addCertPath("./tls/tls.crt")
+            .addKeyPath("./tls/tls.key");
+    PemTrustOptions trust = new PemTrustOptions().addCertPath("./tlc/ca.crt");
+
+    return (RabbitMQOptions) new RabbitMQOptions()
+            .setUser("admin")
+            .setPassword("test")
+            .setSsl(true)
+            .setPemKeyCertOptions(keycert)
+            .setPemTrustOptions(trust)
+            .setHostnameVerificationAlgorithm("")
+            .setConnectTimeout(30000)
+            .setReconnectInterval(5000);
+}
+
    +
    +

    This instance is retrieved and used to configure the client used by the +connector. You need to indicate the name of the client using the +client-options-name attribute:

    +
    1
    mp.messaging.incoming.prices.client-options-name=my-named-options
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/rabbitmq-cloud/index.html b/3.25.0/rabbitmq/rabbitmq-cloud/index.html new file mode 100644 index 0000000000..4964b7e046 --- /dev/null +++ b/3.25.0/rabbitmq/rabbitmq-cloud/index.html @@ -0,0 +1,1634 @@ + + + + + + + + + + + + + + + + + + Connecting to managed instances - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Connecting to managed instances

    +

    This section describes the connector configuration to use managed +RabbitMQ instances (hosted on the Cloud).

    +

    Cloud AMQP

    +

    To connect to an instance of RabbitMQ hosted on Cloud +AMQP, use the following configuration:

    +
    1
+2
+3
+4
+5
+6
    rabbitmq-host=host-name
+rabbitmq-port=5671
+rabbitmq-username=user-name
+rabbitmq-password=password
+rabbitmq-virtual-host=user-name
+rabbitmq-ssl=true
+
    +
    +

    You can extract the values from the AMQPS url displayed on the +administration portal:

    +
    1
    amqps://user-name:password@host/user-name
+
    +
    +

    Amazon MQ

    +

    Amazon MQ can host RabbitMQ brokers +(as well as AMQP 1.0 brokers). To connect to a RabbitMQ instance hosted +on Amazon MQ, use the following configuration:

    +
    1
+2
+3
+4
+5
    rabbitmq-host=host-name
+rabbitmq-port=5671
+rabbitmq-username=user-name
+rabbitmq-password=password
+rabbitmq-ssl=true
+
    +
    +

    You can extract the host value from the AMQPS url displayed on the +administration console:

    +
    1
    amqps://foobarbaz.mq.us-east-2.amazonaws.com:5671
+
    +
    +

    The username and password are configured during the broker creation.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/rabbitmq-health/index.html b/3.25.0/rabbitmq/rabbitmq-health/index.html new file mode 100644 index 0000000000..0e641995af --- /dev/null +++ b/3.25.0/rabbitmq/rabbitmq-health/index.html @@ -0,0 +1,1538 @@ + + + + + + + + + + + + + + + + + + Health Checks - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Health reporting

    +

    The RabbitMQ connector reports the readiness and liveness of each +channel managed by the connector.

    +

    On the inbound side (receiving messages from RabbitMQ), the check +verifies that the receiver is connected to the broker.

    +

    On the outbound side (sending records to RabbitMQ), the check verifies +that the sender is not disconnected from the broker; the sender may +still be in an initialized state (connection not yet attempted), but +this is regarded as live/ready.

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/rabbitmq/index.html b/3.25.0/rabbitmq/rabbitmq/index.html new file mode 100644 index 0000000000..b36e3a73b1 --- /dev/null +++ b/3.25.0/rabbitmq/rabbitmq/index.html @@ -0,0 +1,1624 @@ + + + + + + + + + + + + + + + + + + RabbitMQ Connector - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    RabbitMQ Connector

    +

    The RabbitMQ Connector adds support for RabbitMQ to Reactive Messaging, +based on the AMQP 0-9-1 Protocol Specification.

    +

    Advanced Message Queuing Protocol 0-9-1 (AMQP +0-9-1) is an +open standard for passing business messages between applications or +organizations.

    +

    With this connector, your application can:

    +
      +
    • receive messages from a RabbitMQ queue
      • +
    • send messages to a RabbitMQ exchange
      • +
    +

    The RabbitMQ connector is based on the Vert.x RabbitMQ +Client.

    +
    +

    Important

    +

    The AMQP connector supports the AMQP 1.0 protocol, which is very +different from AMQP 0-9-1. You can use the AMQP connector with +RabbitMQ provided that the latter has the AMQP 1.0 +Plugin +installed, albeit with reduced functionality.

    +
    +

    Using the RabbitMQ connector

    +

    To use the RabbitMQ Connector, add the following dependency to your +project:

    +
    1
+2
+3
+4
+5
    <dependency>
+  <groupId>io.smallrye.reactive</groupId>
+  <artifactId>smallrye-reactive-messaging-rabbitmq</artifactId>
+  <version>3.25.0</version>
+</dependency>
+
    +
    +

    The connector name is: smallrye-rabbitmq.

    +

    So, to indicate that a channel is managed by this connector you need: +
    1
+2
+3
+4
+5
    # Inbound
+mp.messaging.incoming.[channel-name].connector=smallrye-rabbitmq
+
+# Outbound
+mp.messaging.outgoing.[channel-name].connector=smallrye-rabbitmq
+
    +

    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/receiving-messages-from-rabbitmq/index.html b/3.25.0/rabbitmq/receiving-messages-from-rabbitmq/index.html new file mode 100644 index 0000000000..5a301821f5 --- /dev/null +++ b/3.25.0/rabbitmq/receiving-messages-from-rabbitmq/index.html @@ -0,0 +1,2465 @@ + + + + + + + + + + + + + + + + + + Receiving messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Receiving messages from RabbitMQ

    +

    The RabbitMQ connector lets you retrieve messages from a RabbitMQ +broker. The RabbitMQ connector retrieves +RabbitMQ Messages and maps each of them into Reactive Messaging +Messages.

    +
    +

    Note

    +

    In this context, the reactive messaging concept of a Channel is +realised as a RabbitMQ Queue.

    +
    +

    Example

    +

    Let’s imagine you have a RabbitMQ broker running, and accessible using +the rabbitmq:5672 address (by default it would use localhost:5672). +Configure your application to receive RabbitMQ Messages on the prices +channel as follows:

    +
    1
+2
+3
+4
+5
+6
+7
+8
    rabbitmq-host=rabbitmq  # <1>
+rabbitmq-port=5672      # <2>
+rabbitmq-username=my-username   # <3>
+rabbitmq-password=my-password   # <4>
+
+mp.messaging.incoming.prices.connector=smallrye-rabbitmq # <5>
+mp.messaging.incoming.prices.queue.name=my-queue         # <6>
+mp.messaging.incoming.prices.routing-keys=urgent         # <7>
+
    +
    +
      +
    1. +

      Configures the broker/router host name. You can do it per channel + (using the host attribute) or globally using rabbitmq-host.

      +
      2. +
    2. +

      Configures the broker/router port. You can do it per channel (using + the port attribute) or globally using rabbitmq-port. The default + is 5672.

      +
      3. +
    3. +

      Configures the broker/router username if required. You can do it per + channel (using the username attribute) or globally using + rabbitmq-username.

      +
      4. +
    4. +

      Configures the broker/router password if required. You can do it per + channel (using the password attribute) or globally using + rabbitmq-password.

      +
      5. +
    5. +

      Instructs the prices channel to be managed by the RabbitMQ + connector.

      +
      6. +
    6. +

      Configures the RabbitMQ queue to read messages from.

      +
      7. +
    7. +

      Configures the binding between the RabbitMQ exchange and the + RabbitMQ queue using a routing key. The default is # (all messages + will be forwarded from the exchange to the queue) but in general + this can be a comma-separated list of one or more keys.

      +
      8. +
    +

    Then, your application receives Message<String>. You can consume the +payload directly:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
    package rabbitmq.inbound;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+
+@ApplicationScoped
+public class RabbitMQPriceConsumer {
+
+    @Incoming("prices")
+    public void consume(String price) {
+        // process your price.
+    }
+
+}
+
    +
    +

    Or, you can retrieve the Message<String>:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
    package rabbitmq.inbound;
+
+import java.util.concurrent.CompletionStage;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Incoming;
+import org.eclipse.microprofile.reactive.messaging.Message;
+
+@ApplicationScoped
+public class RabbitMQPriceMessageConsumer {
+
+    @Incoming("prices")
+    public CompletionStage<Void> consume(Message<String> price) {
+        // process your price.
+
+        // Acknowledge the incoming message, marking the RabbitMQ message as `accepted`.
+        return price.ack();
+    }
+
+}
+
    +
    +
    +

    Note

    +

    Whether you need to explicitly acknowledge the message depends on the +auto-acknowledgement channel setting; if that is set to true then +your message will be automatically acknowledged on receipt.

    +
    +

    Deserialization

    +

    The connector converts incoming RabbitMQ Messages into Reactive +Messaging Message<T> instances. The payload type T depends on the +value of the RabbitMQ received message Envelope content_type and +content_encoding properties.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    content_encodingcontent_typeType
    Value presentn/abyte[]
    No valuetext/plainString
    No valueapplication/jsona JSON element which can be a JsonArray, JsonObject, String, ... if the buffer contains an array, object, string,...
    No valueAnything elsebyte[]
    +

    If you send objects with this RabbitMQ connector (outbound connector), +they are encoded as JSON and sent with content_type set to +application/json. You can receive this payload using (Vert.x) JSON +Objects, and then map it to the object class you want:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
    @ApplicationScoped
+public static class Generator {
+
+    @Outgoing("to-rabbitmq")
+    public Multi<Price> prices() {             // <1>
+        AtomicInteger count = new AtomicInteger();
+        return Multi.createFrom().ticks().every(Duration.ofMillis(1000))
+                .map(l -> new Price().setPrice(count.incrementAndGet()))
+                .onOverflow().drop();
+    }
+
+}
+
+@ApplicationScoped
+public static class Consumer {
+
+    List<Price> prices = new CopyOnWriteArrayList<>();
+
+    @Incoming("from-rabbitmq")
+    public void consume(JsonObject p) {      // <2>
+        Price price = p.mapTo(Price.class);  // <3>
+        prices.add(price);
+    }
+
+    public List<Price> list() {
+        return prices;
+    }
+}
+
    +
    +
      +
    1. The Price instances are automatically encoded to JSON by the + connector
      2. +
    2. You can receive it using a JsonObject
      3. +
    3. Then, you can reconstruct the instance using the mapTo method
      4. +
    +

    Inbound Metadata

    +

    Messages coming from RabbitMQ contain an instance of IncomingRabbitMQMetadata +in the metadata.

    +

    RabbitMQ message headers can be accessed from the metadata either by +calling getHeader(String header, Class<T> type) to retrieve a single +header value. or getHeaders() to get a map of all header values.

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
    final Optional<IncomingRabbitMQMetadata> metadata = incomingMessage.getMetadata(IncomingRabbitMQMetadata.class);
+metadata.ifPresent(meta -> {
+    final Optional<String> contentEncoding = meta.getContentEncoding();
+    final Optional<String> contentType = meta.getContentType();
+    final Optional<String> correlationId = meta.getCorrelationId();
+    final Optional<ZonedDateTime> timestamp = meta.getTimestamp(ZoneId.systemDefault());
+    final Optional<Integer> priority = meta.getPriority();
+    final Optional<String> replyTo = meta.getReplyTo();
+    final Optional<String> userId = meta.getUserId();
+
+    // Access a single String-valued header
+    final Optional<String> stringHeader = meta.getHeader("my-header", String.class);
+
+    // Access all headers
+    final Map<String, Object> headers = meta.getHeaders();
+    // ...
+});
+
    +
    +

    The type <T> of the header value depends on the RabbitMQ type used for +the header:

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    RabbitMQ Header TypeT
    StringString
    BooleanBoolean
    NumberNumber
    Listjava.util.List
    +

    Acknowledgement

    +

    When a Reactive Messaging Message associated with a RabbitMQ Message is +acknowledged, it informs the broker that the message has been +accepted.

    +

    Whether you need to explicitly acknowledge the message depends on the +auto-acknowledgement setting for the channel; if that is set to true +then your message will be automatically acknowledged on receipt.

    +

    Failure Management

    +

    If a message produced from a RabbitMQ message is nacked, a failure +strategy is applied. The RabbitMQ connector supports three strategies, +controlled by the failure-strategy channel setting:

    +
      +
    • +

      fail - fail the application; no more RabbitMQ messages will be + processed. The RabbitMQ message is marked as rejected.

      +
      • +
    • +

      accept - this strategy marks the RabbitMQ message as accepted. The + processing continues ignoring the failure.

      +
      • +
    • +

      reject - this strategy marks the RabbitMQ message as rejected + (default). The processing continues with the next message.

      +
      • +
    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    auto-acknowledgementWhether the received RabbitMQ messages must be acknowledged when received; if true then delivery constitutes acknowledgementbooleanfalsefalse
    auto-bind-dlqWhether to automatically declare the DLQ and bind it to the binder DLXbooleanfalsefalse
    automatic-recovery-enabledWhether automatic connection recovery is enabledbooleanfalsefalse
    automatic-recovery-on-initial-connectionWhether automatic recovery on initial connections is enabledbooleanfalsetrue
    broadcastWhether the received RabbitMQ messages must be dispatched to multiple subscribersbooleanfalsefalse
    client-options-name (rabbitmq-client-options-name)The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configurationstringfalse
    connection-countThe number of RabbitMQ connections to create for consuming from this queue. This might be necessary to consume from a sharded queue with a single client.intfalse1
    connection-timeoutThe TCP connection timeout (ms); 0 is interpreted as no timeoutintfalse60000
    content-type-overrideOverride the content_type attribute of the incoming message, should be a valid MINE typestringfalse
    credentials-provider-name (rabbitmq-credentials-provider-name)The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ clientstringfalse
    dead-letter-exchangeA DLX to assign to the queue. Relevant only if auto-bind-dlq is truestringfalseDLX
    dead-letter-exchange-typeThe type of the DLX to assign to the queue. Relevant only if auto-bind-dlq is truestringfalsedirect
    dead-letter-queue-modeIf automatically declare DLQ, we can choose different modes of DLQ [lazy, default]stringfalse
    dead-letter-queue-nameThe name of the DLQ; if not supplied will default to the queue name with '.dlq' appendedstringfalse
    dead-letter-queue-typeIf automatically declare DLQ, we can choose different types of DLQ [quorum, classic, stream]stringfalse
    dead-letter-routing-keyA dead letter routing key to assign to the queue; if not supplied will default to the queue namestringfalse
    dlx.declareWhether to declare the dead letter exchange binding. Relevant only if auto-bind-dlq is true; set to false if these are expected to be set up independentlybooleanfalsefalse
    exchange.auto-deleteWhether the exchange should be deleted after usebooleanfalsefalse
    exchange.declareWhether to declare the exchange; set to false if the exchange is expected to be set up independentlybooleanfalsetrue
    exchange.durableWhether the exchange is durablebooleanfalsetrue
    exchange.nameThe exchange that messages are published to or consumed from. If not set, the channel name is used. If set to "", the default exchange is used.stringfalse
    exchange.typeThe exchange type: direct, fanout, headers or topic (default)stringfalsetopic
    failure-strategyThe failure strategy to apply when a RabbitMQ message is nacked. Accepted values are fail, accept, reject (default)stringfalsereject
    handshake-timeoutThe AMQP 0-9-1 protocol handshake timeout (ms)intfalse10000
    host (rabbitmq-host)The broker hostnamestringfalselocalhost
    include-propertiesWhether to include properties when a broker message is passed on the event busbooleanfalsefalse
    keep-most-recentWhether to discard old messages instead of recent onesbooleanfalsefalse
    max-incoming-internal-queue-sizeThe maximum size of the incoming internal queueintfalse500000
    max-outstanding-messagesThe maximum number of outstanding/unacknowledged messages being processed by the connector at a time; must be a positive numberintfalse
    network-recovery-intervalHow long (ms) will automatic recovery wait before attempting to reconnectintfalse5000
    password (rabbitmq-password)The password used to authenticate to the brokerstringfalse
    port (rabbitmq-port)The broker portintfalse5672
    queue.auto-deleteWhether the queue should be deleted after usebooleanfalsefalse
    queue.declareWhether to declare the queue and binding; set to false if these are expected to be set up independentlybooleanfalsetrue
    queue.durableWhether the queue is durablebooleanfalsetrue
    queue.exclusiveWhether the queue is for exclusive usebooleanfalsefalse
    queue.nameThe queue from which messages are consumed.stringtrue
    queue.single-active-consumerIf set to true, only one consumer can actively consume messagesbooleanfalse
    queue.ttlIf specified, the time (ms) for which a message can remain in the queue undelivered before it is deadlongfalse
    queue.x-max-priorityDefine priority level queue consumerintfalse
    queue.x-queue-modeIf automatically declare queue, we can choose different modes of queue [lazy, default]stringfalse
    queue.x-queue-typeIf automatically declare queue, we can choose different types of queue [quorum, classic, stream]stringfalse
    reconnect-attempts (rabbitmq-reconnect-attempts)The number of reconnection attemptsintfalse100
    reconnect-interval (rabbitmq-reconnect-interval)The interval (in seconds) between two reconnection attemptsintfalse10
    requested-channel-maxThe initially requested maximum channel numberintfalse2047
    requested-heartbeatThe initially requested heartbeat interval (seconds), zero for noneintfalse60
    routing-keysA comma-separated list of routing keys to bind the queue to the exchangestringfalse#
    ssl (rabbitmq-ssl)Whether or not the connection should use SSLbooleanfalsefalse
    tracing.attribute-headersA comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=truestringfalse``
    tracing.enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
    trust-all (rabbitmq-trust-all)Whether to skip trust certificate verificationbooleanfalsefalse
    trust-store-password (rabbitmq-trust-store-password)The password of the JKS trust storestringfalse
    trust-store-path (rabbitmq-trust-store-path)The path to a JKS trust storestringfalse
    use-nioWhether usage of NIO Sockets is enabledbooleanfalsefalse
    userThe user name to use when connecting to the brokerstringfalseguest
    username (rabbitmq-username)The username used to authenticate to the brokerstringfalse
    virtual-host (rabbitmq-virtual-host)The virtual host to use when connecting to the brokerstringfalse/
    +

    To use an existing queue, you need to configure the queue.name +attribute.

    +

    For example, if you have a RabbitMQ broker already configured with a +queue called peopleQueue that you wish to read messages from, you need +the following configuration:

    +
    1
+2
    mp.messaging.incoming.people.connector=smallrye-rabbitmq
+mp.messaging.incoming.people.queue.name=peopleQueue
+
    +
    +

    If you want RabbitMQ to create the queue for you but bind it to an +existing topic exchange people, you need the following configuration:

    +
    1
+2
+3
    mp.messaging.incoming.people.connector=smallrye-rabbitmq
+mp.messaging.incoming.people.queue.name=peopleQueue
+mp.messaging.incoming.people.queue.declare=true
+
    +
    +
    +

    Note

    +

    In the above the channel name people is implicitly assumed to be the +name of the exchange; if this is not the case you would need to name the +exchange explicitly using the exchange.name property.

    +
    +
    +

    Note

    +

    The connector supports RabbitMQ's "Server-named Queues" feature to create +an exclusive, auto-deleting, non-durable and randomly named queue. To +enable this feature you set the queue name to exactly (server.auto). +Using this name not only enables the server named queue feature but also +automatically makes ths queue exclusive, auto-deleting, and non-durable; +therefore ignoring any values provided for the exclusive, auto-delete +and durable options.

    +
    +

    If you want RabbitMQ to create the people exchange, queue and binding, +you need the following configuration:

    +
    1
+2
+3
+4
+5
    mp.messaging.incoming.people.connector=smallrye-rabbitmq
+mp.messaging.incoming.people.exchange.declare=true
+mp.messaging.incoming.people.queue.name=peopleQueue
+mp.messaging.incoming.people.queue.declare=true
+mp.messaging.incoming.people.queue.routing-keys=tall,short
+
    +
    +

    In the above we have used an explicit list of routing keys rather than +the default (#). Each component of the list creates a separate binding +between the queue and the exchange, so in the case above we would have +two bindings; one based on a routing key of tall, the other based on +one of short.

    +
    +

    Note

    +

    The default value of routing-keys is # (indicating a match against +all possible routing keys) which is only appropriate for topic +Exchanges. If you are using other types of exchange and/or need to +declare queue bindings, you’ll need to supply a valid value for the +exchange in question.

    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/rabbitmq/sending-messages-to-rabbitmq/index.html b/3.25.0/rabbitmq/sending-messages-to-rabbitmq/index.html new file mode 100644 index 0000000000..1e405edf9a --- /dev/null +++ b/3.25.0/rabbitmq/sending-messages-to-rabbitmq/index.html @@ -0,0 +1,2200 @@ + + + + + + + + + + + + + + + + + + Sending messages - SmallRye Reactive Messaging + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    + + + + + + + +

    Sending messages to RabbitMQ

    +

    The RabbitMQ connector can write Reactive Messaging Messages as +RabbitMQ Messages.

    +
    +

    Note

    +

    In this context, the reactive messaging concept of a Channel is +realised as a RabbitMQ +Exchange.

    +
    +

    Example

    +

    Let’s imagine you have a RabbitMQ broker running, and accessible using +the rabbitmq:5672 address (by default it would use localhost:5672). +Configure your application to send the messages from the prices +channel as a RabbitMQ Message as follows:

    +
    1
+2
+3
+4
+5
+6
+7
    rabbitmq-host=rabbitmq   # <1>
+rabbitmq-port=5672       # <2>
+rabbitmq-username=my-username # <3>
+rabbitmq-password=my-password  # <4>
+
+mp.messaging.outgoing.prices.connector=smallrye-rabbitmq # <5>
+mp.messaging.outgoing.prices.default-routing-key=normal    # <6>
+
    +
    +
      +
    1. +

      Configures the broker/router host name. You can do it per channel + (using the host attribute) or globally using rabbitmq-host

      +
      2. +
    2. +

      Configures the broker/router port. You can do it per channel (using + the port attribute) or globally using rabbitmq-port. The default + is 5672.

      +
      3. +
    3. +

      Configures the broker/router username if required. You can do it per + channel (using the username attribute) or globally using + rabbitmq-username.

      +
      4. +
    4. +

      Configures the broker/router password if required. You can do it per + channel (using the password attribute) or globally using + rabbitmq-password.

      +
      5. +
    5. +

      Instructs the prices channel to be managed by the RabbitMQ + connector

      +
      6. +
    6. +

      Supplies the default routing key to be included in outbound + messages; this will be if the "raw payload" form of message sending + is used (see below).

      +
      7. +
    +
    +

    Note

    +

    You don’t need to set the RabbitMQ exchange name. By default, it uses +the channel name (prices) as the name of the exchange to send messages +to. You can configure the exchange.name attribute to override it.

    +
    +

    Then, your application can send Message<Double> to the prices channel. +It can use double payloads as in the following snippet:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
    package rabbitmq.outbound;
+
+import java.time.Duration;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+
+@ApplicationScoped
+public class RabbitMQPriceProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Double> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> random.nextDouble());
+    }
+
+}
+
    +
    +

    Or, you can send Message<Double>, which affords the opportunity to +explicitly specify metadata on the outgoing message:

    +
     1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
    package rabbitmq.outbound;
+
+import java.time.Duration;
+import java.time.ZonedDateTime;
+import java.util.Random;
+
+import javax.enterprise.context.ApplicationScoped;
+
+import org.eclipse.microprofile.reactive.messaging.Message;
+import org.eclipse.microprofile.reactive.messaging.Metadata;
+import org.eclipse.microprofile.reactive.messaging.Outgoing;
+
+import io.smallrye.mutiny.Multi;
+import io.smallrye.reactive.messaging.rabbitmq.OutgoingRabbitMQMetadata;
+
+@ApplicationScoped
+public class RabbitMQPriceMessageProducer {
+
+    private Random random = new Random();
+
+    @Outgoing("prices")
+    public Multi<Message<Double>> generate() {
+        // Build an infinite stream of random prices
+        // It emits a price every second
+        return Multi.createFrom().ticks().every(Duration.ofSeconds(1))
+                .map(x -> Message.of(random.nextDouble(),
+                        Metadata.of(new OutgoingRabbitMQMetadata.Builder()
+                                .withRoutingKey("normal")
+                                .withTimestamp(ZonedDateTime.now())
+                                .build())));
+    }
+
+}
+
    +
    +

    Serialization

    +

    When sending a Message<T>, the connector converts the message into a +RabbitMQ Message. The payload is converted to the RabbitMQ Message body.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    TRabbitMQ Message Body
    primitive types or UUID/StringString value with content_type set to text/plain
    JsonObject or JsonArraySerialized String payload with content_type set to application/json
    io.vertx.mutiny.core.buffer.BufferBinary content, with content_type set to application/octet-stream
    byte[]Binary content, with content_type set to application/octet-stream
    Any other classThe payload is converted to JSON (using a Json Mapper) then serialized with content_type set to application/json
    +

    If the message payload cannot be serialized to JSON, the message is +nacked.

    +

    Outbound Metadata

    +

    When sending Messages, you can add an instance of OutgoingRabbitMQMetadata +to influence how the message is handled by RabbitMQ. For example, you +can configure the routing key, timestamp and headers:

    +
    1
+2
+3
+4
+5
+6
+7
+8
    final OutgoingRabbitMQMetadata metadata = new OutgoingRabbitMQMetadata.Builder()
+        .withHeader("my-header", "xyzzy")
+        .withRoutingKey("urgent")
+        .withTimestamp(ZonedDateTime.now())
+        .build();
+
+// Add `metadata` to the metadata of the outgoing message.
+return Message.of("Hello", Metadata.of(metadata));
+
    +
    +

    Acknowledgement

    +

    By default, the Reactive Messaging Message is acknowledged when the +broker acknowledges the message.

    +

    Configuration Reference

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Attribute (alias)DescriptionTypeMandatoryDefault
    automatic-recovery-enabledWhether automatic connection recovery is enabledbooleanfalsefalse
    automatic-recovery-on-initial-connectionWhether automatic recovery on initial connections is enabledbooleanfalsetrue
    client-options-name (rabbitmq-client-options-name)The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configurationstringfalse
    connection-timeoutThe TCP connection timeout (ms); 0 is interpreted as no timeoutintfalse60000
    credentials-provider-name (rabbitmq-credentials-provider-name)The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ clientstringfalse
    default-routing-keyThe default routing key to use when sending messages to the exchangestringfalse``
    default-ttlIf specified, the time (ms) sent messages can remain in queues undelivered before they are deadlongfalse
    exchange.auto-deleteWhether the exchange should be deleted after usebooleanfalsefalse
    exchange.declareWhether to declare the exchange; set to false if the exchange is expected to be set up independentlybooleanfalsetrue
    exchange.durableWhether the exchange is durablebooleanfalsetrue
    exchange.nameThe exchange that messages are published to or consumed from. If not set, the channel name is used. If set to "", the default exchange is used.stringfalse
    exchange.typeThe exchange type: direct, fanout, headers or topic (default)stringfalsetopic
    handshake-timeoutThe AMQP 0-9-1 protocol handshake timeout (ms)intfalse10000
    host (rabbitmq-host)The broker hostnamestringfalselocalhost
    include-propertiesWhether to include properties when a broker message is passed on the event busbooleanfalsefalse
    max-inflight-messagesThe maximum number of messages to be written to RabbitMQ concurrently; must be a positive numberlongfalse1024
    max-outgoing-internal-queue-sizeThe maximum size of the outgoing internal queueintfalse
    network-recovery-intervalHow long (ms) will automatic recovery wait before attempting to reconnectintfalse5000
    password (rabbitmq-password)The password used to authenticate to the brokerstringfalse
    port (rabbitmq-port)The broker portintfalse5672
    reconnect-attempts (rabbitmq-reconnect-attempts)The number of reconnection attemptsintfalse100
    reconnect-interval (rabbitmq-reconnect-interval)The interval (in seconds) between two reconnection attemptsintfalse10
    requested-channel-maxThe initially requested maximum channel numberintfalse2047
    requested-heartbeatThe initially requested heartbeat interval (seconds), zero for noneintfalse60
    ssl (rabbitmq-ssl)Whether or not the connection should use SSLbooleanfalsefalse
    tracing.attribute-headersA comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=truestringfalse``
    tracing.enabledWhether tracing is enabled (default) or disabledbooleanfalsetrue
    trust-all (rabbitmq-trust-all)Whether to skip trust certificate verificationbooleanfalsefalse
    trust-store-password (rabbitmq-trust-store-password)The password of the JKS trust storestringfalse
    trust-store-path (rabbitmq-trust-store-path)The path to a JKS trust storestringfalse
    use-nioWhether usage of NIO Sockets is enabledbooleanfalsefalse
    userThe user name to use when connecting to the brokerstringfalseguest
    username (rabbitmq-username)The username used to authenticate to the brokerstringfalse
    virtual-host (rabbitmq-virtual-host)The virtual host to use when connecting to the brokerstringfalse/
    +

    Using existing destinations

    +

    To use an existing exchange, you may need to configure the +exchange.name attribute.

    +

    For example, if you have a RabbitMQ broker already configured with an +exchange called people that you wish to send messages to, you need the +following configuration:

    +
    1
    mp.messaging.outgoing.people.connector=smallrye-rabbitmq
+
    +
    +

    You would need to configure the exchange.name attribute, if the +exchange name were not the channel name:

    +
    1
+2
    mp.messaging.outgoing.people-out.connector=smallrye-rabbitmq
+mp.messaging.outgoing.people-out.exchange.name=people
+
    +
    +

    If you want RabbitMQ to create the people exchange, you need the +following configuration:

    +
    1
+2
+3
    mp.messaging.outgoing.people-out.connector=smallrye-amqp
+mp.messaging.outgoing.people-out.exchange.name=people
+mp.messaging.outgoing.people-out.exchange.declare=true
+
    +
    +
    +

    Note

    +

    The above example will create a topic exchange and use an empty +default routing-key (unless overridden programatically using outgoing +metadata for the message). If you want to create a different type of +exchange or have a different default routing key, then the +exchange.type and default-routing-key properties need to be +explicitly specified.

    +
    +

    Sending to specific queues via the default exchange

    +

    To send a message to a specific queue (usually a reply queue), +you have to configure the default exchange as an outgoing channel and set the name of the queue as routing key in the message metadata. +The name of the exchange needs to be set to "".

    +
    1
+2
    mp.messaging.outgoing.channel-name-for-default-exchange.connector=smallrye-rabbitmq
+mp.messaging.outgoing.channel-name-for-default-exchange.exchange.name=""
+
    +
    + + +
    +
    +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + \ No newline at end of file diff --git a/3.25.0/search/search_index.json b/3.25.0/search/search_index.json new file mode 100644 index 0000000000..47553cb646 --- /dev/null +++ b/3.25.0/search/search_index.json @@ -0,0 +1 @@ +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"SmallRye Reactive Messaging SmallRye Reactive Messaging is a framework for building event-driven, data streaming, and event-sourcing applications. It lets your application interact using various messaging technologies such as Apache Kafka, AMQP or MQTT. The framework provides a flexible programming model bridging CDI and event-driven. SmallRye Reactive Messaging is an implementation of the Eclipse MicroProfile Reactive Messaging specification 2.0.1. Event-Driven Architectures SmallRye Reactive Messaging is used in Quarkus , and Open Liberty . Start with the Getting Started guide to know how it can be used and introduce various features.","title":"Home"},{"location":"#smallrye-reactive-messaging","text":"SmallRye Reactive Messaging is a framework for building event-driven, data streaming, and event-sourcing applications. It lets your application interact using various messaging technologies such as Apache Kafka, AMQP or MQTT. The framework provides a flexible programming model bridging CDI and event-driven. SmallRye Reactive Messaging is an implementation of the Eclipse MicroProfile Reactive Messaging specification 2.0.1. Event-Driven Architectures SmallRye Reactive Messaging is used in Quarkus , and Open Liberty . Start with the Getting Started guide to know how it can be used and introduce various features.","title":"SmallRye Reactive Messaging"},{"location":"getting-started/","text":"Getting Started The easiest way to start using SmallRye Reactive Messaging is from Quarkus . SmallRye Reactive Messaging can also be used standalone, or with Open Liberty . First, go to code.quarkus.io . Select the smallrye-reactive-messaging extension (already done if you use the link), and then click on the generate button to download the code. One downloaded, unzip the project and import it in your IDE. If you look at the pom.xml file, you will see the following dependency: 1 2 3 4 io.quarkus quarkus-smallrye-reactive-messaging It provides the support for SmallRye Reactive Messaging. Ok, so far so good, but we need event-driven beans . Create the quickstart package, and copy the following class into it: For instance: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 package quickstart ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class ReactiveMessagingExample { @Outgoing ( \"source\" ) public Multi < String > source () { return Multi . createFrom (). items ( \"hello\" , \"from\" , \"SmallRye\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"processed-a\" ) public String toUpperCase ( String payload ) { return payload . toUpperCase (); } @Incoming ( \"processed-a\" ) @Outgoing ( \"processed-b\" ) public Multi < String > filter ( Multi < String > input ) { return input . select (). where ( item -> item . length () > 4 ); } @Incoming ( \"processed-b\" ) public void sink ( String word ) { System . out . println ( \">> \" + word ); } } This class contains a set of methods: producing messages ( source ) processing messages ( toUpperCase ) transforming the stream by skipping messages ( filter ) consuming messages ( sink ) Each of these methods are connected through channels . Now, let's see this in action. For the terminal, run: 1 > ./mvnw quarkus:dev Running the previous example should give the following output: 1 2 3 4 >> HELLO >> SMALLRYE >> REACTIVE >> MESSAGE Of course, this is a very simple example. To go further, let's have a look to the core concepts behind SmallRye Reactive Messaging.","title":"Getting Started"},{"location":"getting-started/#getting-started","text":"The easiest way to start using SmallRye Reactive Messaging is from Quarkus . SmallRye Reactive Messaging can also be used standalone, or with Open Liberty . First, go to code.quarkus.io . Select the smallrye-reactive-messaging extension (already done if you use the link), and then click on the generate button to download the code. One downloaded, unzip the project and import it in your IDE. If you look at the pom.xml file, you will see the following dependency: 1 2 3 4 io.quarkus quarkus-smallrye-reactive-messaging It provides the support for SmallRye Reactive Messaging. Ok, so far so good, but we need event-driven beans . Create the quickstart package, and copy the following class into it: For instance: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 package quickstart ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class ReactiveMessagingExample { @Outgoing ( \"source\" ) public Multi < String > source () { return Multi . createFrom (). items ( \"hello\" , \"from\" , \"SmallRye\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"processed-a\" ) public String toUpperCase ( String payload ) { return payload . toUpperCase (); } @Incoming ( \"processed-a\" ) @Outgoing ( \"processed-b\" ) public Multi < String > filter ( Multi < String > input ) { return input . select (). where ( item -> item . length () > 4 ); } @Incoming ( \"processed-b\" ) public void sink ( String word ) { System . out . println ( \">> \" + word ); } } This class contains a set of methods: producing messages ( source ) processing messages ( toUpperCase ) transforming the stream by skipping messages ( filter ) consuming messages ( sink ) Each of these methods are connected through channels . Now, let's see this in action. For the terminal, run: 1 > ./mvnw quarkus:dev Running the previous example should give the following output: 1 2 3 4 >> HELLO >> SMALLRYE >> REACTIVE >> MESSAGE Of course, this is a very simple example. To go further, let's have a look to the core concepts behind SmallRye Reactive Messaging.","title":"Getting Started"},{"location":"amqp/amqp/","text":"AMQP 1.0 Connector The AMQP Connector adds support for AMQP 1.0 to Reactive Messaging. Advanced Message Queuing Protocol 1.0 (AMQP 1.0) is an open standard for passing business messages between applications or organizations. With this connector, your application can: receive messages from an AMQP Broker or Router. send Message to an AMQP address The AMQP connector is based on the Vert.x AMQP Client . Using the AMQP connector To use the AMQP Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-amqp 3.25.0 The connector name is: smallrye-amqp . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-amqp # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-amqp RabbitMQ To use RabbitMQ, refer to Using RabbitMQ .","title":"AMQP 1.0 Connector"},{"location":"amqp/amqp/#amqp-10-connector","text":"The AMQP Connector adds support for AMQP 1.0 to Reactive Messaging. Advanced Message Queuing Protocol 1.0 (AMQP 1.0) is an open standard for passing business messages between applications or organizations. With this connector, your application can: receive messages from an AMQP Broker or Router. send Message to an AMQP address The AMQP connector is based on the Vert.x AMQP Client .","title":"AMQP 1.0 Connector"},{"location":"amqp/amqp/#using-the-amqp-connector","text":"To use the AMQP Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-amqp 3.25.0 The connector name is: smallrye-amqp . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-amqp # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-amqp RabbitMQ To use RabbitMQ, refer to Using RabbitMQ .","title":"Using the AMQP connector"},{"location":"amqp/client-customization/","text":"Customizing the underlying AMQP client You can customize the underlying AMQP Client configuration by producing an instance of AmqpClientOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Produces @Identifier ( \"my-options\" ) public AmqpClientOptions getNamedOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return new AmqpClientOptions () . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . addEnabledSaslMechanism ( \"EXTERNAL\" ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ) . setContainerId ( \"my-container\" ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name = my-named-options Client capabilities Both incoming and outgoing AMQP channels can be configured with a list of capabilities to declare during sender and receiver connections with the AMQP broker. Note that supported capability names are broker specific. 1 2 3 mp.messaging.incoming.sink.capabilities = temporary-topic ... mp.messaging.outgoing.source.capabilities = shared","title":"Client Customization"},{"location":"amqp/client-customization/#customizing-the-underlying-amqp-client","text":"You can customize the underlying AMQP Client configuration by producing an instance of AmqpClientOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Produces @Identifier ( \"my-options\" ) public AmqpClientOptions getNamedOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return new AmqpClientOptions () . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . addEnabledSaslMechanism ( \"EXTERNAL\" ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ) . setContainerId ( \"my-container\" ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name = my-named-options","title":"Customizing the underlying AMQP client"},{"location":"amqp/client-customization/#client-capabilities","text":"Both incoming and outgoing AMQP channels can be configured with a list of capabilities to declare during sender and receiver connections with the AMQP broker. Note that supported capability names are broker specific. 1 2 3 mp.messaging.incoming.sink.capabilities = temporary-topic ... mp.messaging.outgoing.source.capabilities = shared","title":"Client capabilities"},{"location":"amqp/health/","text":"Health reporting The AMQP connector reports the startup, liveness, and readiness of each inbound (Receiving messages) and outbound (sending messages) channel managed by the connector: Startup :: For both inbound and outbound, the startup probe reports OK when the connection with the broker is established, and the AMQP senders and receivers are opened (the links are attached to the broker). Liveness :: For both inbound and outbound, the liveness check verifies that the connection is established. The check still returns OK if the connection got cut, but we are attempting a reconnection. Readiness :: For the inbound, it checks that the connection is established and the receiver is opened. Unlike the liveness check, this probe reports KO until the connection is re-established. For the outbound, it checks that the connection is established and the sender is opened. Unlike the liveness check, this probe reports KO until the connection is re-established. Note To disable health reporting, set the health-enabled attribute for the channel to false . Note that a message processing failures nacks the message, which is then handled by the failure-strategy. It is the responsibility of the failure-strategy to report the failure and influence the outcome of the checks. The fail failure strategy reports the failure, and so the check will report the fault.","title":"Health Checks"},{"location":"amqp/health/#health-reporting","text":"The AMQP connector reports the startup, liveness, and readiness of each inbound (Receiving messages) and outbound (sending messages) channel managed by the connector: Startup :: For both inbound and outbound, the startup probe reports OK when the connection with the broker is established, and the AMQP senders and receivers are opened (the links are attached to the broker). Liveness :: For both inbound and outbound, the liveness check verifies that the connection is established. The check still returns OK if the connection got cut, but we are attempting a reconnection. Readiness :: For the inbound, it checks that the connection is established and the receiver is opened. Unlike the liveness check, this probe reports KO until the connection is re-established. For the outbound, it checks that the connection is established and the sender is opened. Unlike the liveness check, this probe reports KO until the connection is re-established. Note To disable health reporting, set the health-enabled attribute for the channel to false . Note that a message processing failures nacks the message, which is then handled by the failure-strategy. It is the responsibility of the failure-strategy to report the failure and influence the outcome of the checks. The fail failure strategy reports the failure, and so the check will report the fault.","title":"Health reporting"},{"location":"amqp/rabbitmq/","text":"Using RabbitMQ This connector is for AMQP 1.0. RabbitMQ implements AMQP 0.9.1. RabbitMQ does not provide AMQP 1.0 by default, but there is a plugin for it. To use RabbitMQ with this connector, enable and configure the AMQP 1.0 plugin . Despite the plugin, a few features won\u2019t work with RabbitMQ. Thus, we recommend the following configurations. To receive messages from RabbitMQ: Set durable to false 1 2 mp.messaging.incoming.prices.connector = smallrye-amqp mp.messaging.incoming.prices.durable = false To send messages to RabbitMQ: set the destination address (anonymous sender are not supported) 1 2 mp.messaging.outgoing.generated-price.connector = smallrye-amqp mp.messaging.outgoing.generated-price.address = prices It\u2019s not possible to change the destination dynamically (using message metadata) when using RabbitMQ. The connector automatically detects that the broker does not support anonymous sender (See http://docs.oasis-open.org/amqp/anonterm/v1.0/anonterm-v1.0.html ). Alternatively, you can use the RabbitMQ connector .","title":"Using RabbitMQ"},{"location":"amqp/rabbitmq/#using-rabbitmq","text":"This connector is for AMQP 1.0. RabbitMQ implements AMQP 0.9.1. RabbitMQ does not provide AMQP 1.0 by default, but there is a plugin for it. To use RabbitMQ with this connector, enable and configure the AMQP 1.0 plugin . Despite the plugin, a few features won\u2019t work with RabbitMQ. Thus, we recommend the following configurations. To receive messages from RabbitMQ: Set durable to false 1 2 mp.messaging.incoming.prices.connector = smallrye-amqp mp.messaging.incoming.prices.durable = false To send messages to RabbitMQ: set the destination address (anonymous sender are not supported) 1 2 mp.messaging.outgoing.generated-price.connector = smallrye-amqp mp.messaging.outgoing.generated-price.address = prices It\u2019s not possible to change the destination dynamically (using message metadata) when using RabbitMQ. The connector automatically detects that the broker does not support anonymous sender (See http://docs.oasis-open.org/amqp/anonterm/v1.0/anonterm-v1.0.html ). Alternatively, you can use the RabbitMQ connector .","title":"Using RabbitMQ"},{"location":"amqp/receiving-amqp-messages/","text":"Receiving messages from AMQP The AMQP connector lets you retrieve messages from an AMQP broker or router . The AMQP connector retrieves AMQP Messages and maps each of them into Reactive Messaging Messages . Example Let\u2019s imagine you have an AMQP broker (such as Apache ActiveMQ Artemis ) running, and accessible using the amqp:5672 address (by default it would use localhost:5672 ). Configure your application to receive AMQP Messages on the prices channel as follows: 1 2 3 4 5 6 amqp-host = amqp # <1> amqp-port = 5672 # <2> amqp-username = my-username # <3> amqp-password = my-password # <4> mp.messaging.incoming.prices.connector = smallrye-amqp # <5> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using amqp-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using amqp-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using amqp-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using amqp-password . Instructs the prices channel to be managed by the AMQP connector Note You don\u2019t need to set the AMQP address . By default, it uses the channel name ( prices ). You can configure the address attribute to override it. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package amqp.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class AmqpPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package amqp.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class AmqpPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message, marking the AMQP message as `accepted`. return price . ack (); } } Deserialization The connector converts incoming AMQP Messages into Reactive Messaging Message instances. T depends on the body of the received AMQP Message. The AMQP Type System defines the supported types. AMQP Body Type AMQP Value containing a AMQP Primitive Type the corresponding Java type AMQP Value using the Binary type byte[] AMQP Sequence List AMQP Data (with binary content) and the content-type is set to application/json JsonObject AMQP Data with a different content-type byte[] If you send objects with this AMQP connector (outbound connector), it gets encoded as JSON and sent as binary. The content-type is set to application/json . You can receive this payload using (Vert.x) JSON Objects, and then map it to the object class you want: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 @ApplicationScoped public static class Generator { @Outgoing ( \"to-amqp\" ) public Multi < Price > prices () { // <1> AtomicInteger count = new AtomicInteger (); return Multi . createFrom (). ticks (). every ( Duration . ofMillis ( 1000 )) . map ( l -> new Price (). setPrice ( count . incrementAndGet ())) . onOverflow (). drop (); } } @ApplicationScoped public static class Consumer { List < Price > prices = new CopyOnWriteArrayList <> (); @Incoming ( \"from-amqp\" ) public void consume ( JsonObject p ) { // <2> Price price = p . mapTo ( Price . class ); // <3> prices . add ( price ); } public List < Price > list () { return prices ; } } The Price instances are automatically encoded to JSON by the connector You can receive it using a JsonObject Then, you can reconstruct the instance using the mapTo method Inbound Metadata Messages coming from AMQP contains an instance of IncomingAmqpMetadata 1 2 3 4 5 6 7 8 9 Optional < IncomingAmqpMetadata > metadata = incoming . getMetadata ( IncomingAmqpMetadata . class ); metadata . ifPresent ( meta -> { String address = meta . getAddress (); String subject = meta . getSubject (); boolean durable = meta . isDurable (); // Use io.vertx.core.json.JsonObject JsonObject properties = meta . getProperties (); // ... }); Acknowledgement When a Reactive Messaging Message associated with an AMQP Message is acknowledged, it informs the broker that the message has been accepted . Failure Management If a message produced from an AMQP message is nacked , a failure strategy is applied. The AMQP connector supports six strategies: fail - fail the application; no more AMQP messages will be processed (default). The AMQP message is marked as rejected. accept - this strategy marks the AMQP message as accepted . The processing continues ignoring the failure. Refer to the accepted delivery state documentation . release - this strategy marks the AMQP message as released . The processing continues with the next message. The broker can redeliver the message. Refer to the released delivery state documentation . reject - this strategy marks the AMQP message as rejected. The processing continues with the next message. Refer to the rejected delivery state documentation . modified-failed - this strategy marks the AMQP message as modified and indicates that it failed (with the delivery-failed attribute). The processing continues with the next message, but the broker may attempt to redeliver the message. Refer to the modified delivery state documentation modified-failed-undeliverable-here - this strategy marks the AMQP message as modified and indicates that it failed (with the delivery-failed attribute). It also indicates that the application cannot process the message, meaning that the broker will not attempt to redeliver the message to this node. The processing continues with the next message. Refer to the modified delivery state documentation Configuration Reference Attribute ( alias ) Description Type Mandatory Default address The AMQP address. If not set, the channel name is used string false auto-acknowledgement Whether the received AMQP messages must be acknowledged when received boolean false false broadcast Whether the received AMQP messages must be dispatched to multiple subscribers boolean false false capabilities A comma-separated list of capabilities proposed by the sender or receiver client. string false client-options-name (amqp-client-options-name) The name of the AMQP Client Option bean used to customize the AMQP client configuration string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true connect-timeout (amqp-connect-timeout) The connection timeout in milliseconds int false 1000 container-id The AMQP container id string false durable Whether AMQP subscription is durable boolean false false failure-strategy Specify the failure strategy to apply when a message produced from an AMQP message is nacked. Accepted values are fail (default), accept , release , reject , modified-failed , modified-failed-undeliverable-here string false fail health-timeout The max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed. int false 3 host (amqp-host) The broker hostname string false localhost link-name The name of the link. If not set, the channel name is used. string false password (amqp-password) The password used to authenticate to the broker string false port (amqp-port) The broker port int false 5672 reconnect-attempts (amqp-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (amqp-reconnect-interval) The interval in second between two reconnection attempts int false 10 selector Sets a message selector. This attribute is used to define an apache.org:selector-filter:string filter on the source terminus, using SQL-based syntax to request the server filters which messages are delivered to the receiver (if supported by the server in question). Precise functionality supported and syntax needed can vary depending on the server. string false sni-server-name (amqp-sni-server-name) If set, explicitly override the hostname to use for the TLS SNI server name string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true use-ssl (amqp-use-ssl) Whether the AMQP connection uses SSL/TLS boolean false false username (amqp-username) The username used to authenticate to the broker string false virtual-host (amqp-virtual-host) If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use) string false You can also pass any property supported by the Vert.x AMQP client as attribute. To use an existing address or queue , you need to configure the address , container-id and, optionally, the link-name attributes. For example, if you have an Apache Artemis broker configured with: 1 2 3 4 5 6 7
    people
    true artemis     You need the following configuration: 1 2 3 4 mp.messaging.incoming.people.connector = smallrye-amqp mp.messaging.incoming.people.durable = true mp.messaging.incoming.people.address = people mp.messaging.incoming.people.container-id = people You may need to configure the link-name attribute, if the queue name is not the channel name: 1 2 3 4 5 mp.messaging.incoming.people-in.connector = smallrye-amqp mp.messaging.incoming.people-in.durable = true mp.messaging.incoming.people-in.address = people mp.messaging.incoming.people-in.container-id = people mp.messaging.incoming.people-in.link-name = people Receiving Cloud Events The AMQP connector supports Cloud Events . When the connector detects a structured or binary Cloud Events, it adds a IncomingCloudEventMetadata into the metadata of the Message . IncomingCloudEventMetadata contains accessors to the mandatory and optional Cloud Event attributes. If the connector cannot extract the Cloud Event metadata, it sends the Message without the metadata. Binary Cloud Events For binary Cloud Events, all mandatory Cloud Event attributes must be set in the AMQP application properties, prefixed by cloudEvents: (as mandated by the protocol binding ). The connector considers headers starting with the cloudEvents: prefix but not listed in the specification as extensions. You can access them using the getExtension method from IncomingCloudEventMetadata . The datacontenttype attribute is mapped to the content-type header of the record. Structured Cloud Events For structured Cloud Events, the event is encoded in the record\u2019s value. Only JSON is supported, so your event must be encoded as JSON in the record\u2019s value. Structured Cloud Event must set the content-type header of the record to application/cloudevents+json; charset=UTF-8 . The message body must be a valid JSON object containing at least all the mandatory Cloud Events attributes. If the record is a structured Cloud Event, the created Message\u2019s payload is the Cloud Event data .","title":"Receiving messages"},{"location":"amqp/receiving-amqp-messages/#receiving-messages-from-amqp","text":"The AMQP connector lets you retrieve messages from an AMQP broker or router . The AMQP connector retrieves AMQP Messages and maps each of them into Reactive Messaging Messages .","title":"Receiving messages from AMQP"},{"location":"amqp/receiving-amqp-messages/#example","text":"Let\u2019s imagine you have an AMQP broker (such as Apache ActiveMQ Artemis ) running, and accessible using the amqp:5672 address (by default it would use localhost:5672 ). Configure your application to receive AMQP Messages on the prices channel as follows: 1 2 3 4 5 6 amqp-host = amqp # <1> amqp-port = 5672 # <2> amqp-username = my-username # <3> amqp-password = my-password # <4> mp.messaging.incoming.prices.connector = smallrye-amqp # <5> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using amqp-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using amqp-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using amqp-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using amqp-password . Instructs the prices channel to be managed by the AMQP connector Note You don\u2019t need to set the AMQP address . By default, it uses the channel name ( prices ). You can configure the address attribute to override it. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package amqp.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class AmqpPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package amqp.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class AmqpPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message, marking the AMQP message as `accepted`. return price . ack (); } }","title":"Example"},{"location":"amqp/receiving-amqp-messages/#deserialization","text":"The connector converts incoming AMQP Messages into Reactive Messaging Message instances. T depends on the body of the received AMQP Message. The AMQP Type System defines the supported types. AMQP Body Type AMQP Value containing a AMQP Primitive Type the corresponding Java type AMQP Value using the Binary type byte[] AMQP Sequence List AMQP Data (with binary content) and the content-type is set to application/json JsonObject AMQP Data with a different content-type byte[] If you send objects with this AMQP connector (outbound connector), it gets encoded as JSON and sent as binary. The content-type is set to application/json . You can receive this payload using (Vert.x) JSON Objects, and then map it to the object class you want: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 @ApplicationScoped public static class Generator { @Outgoing ( \"to-amqp\" ) public Multi < Price > prices () { // <1> AtomicInteger count = new AtomicInteger (); return Multi . createFrom (). ticks (). every ( Duration . ofMillis ( 1000 )) . map ( l -> new Price (). setPrice ( count . incrementAndGet ())) . onOverflow (). drop (); } } @ApplicationScoped public static class Consumer { List < Price > prices = new CopyOnWriteArrayList <> (); @Incoming ( \"from-amqp\" ) public void consume ( JsonObject p ) { // <2> Price price = p . mapTo ( Price . class ); // <3> prices . add ( price ); } public List < Price > list () { return prices ; } } The Price instances are automatically encoded to JSON by the connector You can receive it using a JsonObject Then, you can reconstruct the instance using the mapTo method","title":"Deserialization"},{"location":"amqp/receiving-amqp-messages/#inbound-metadata","text":"Messages coming from AMQP contains an instance of IncomingAmqpMetadata 1 2 3 4 5 6 7 8 9 Optional < IncomingAmqpMetadata > metadata = incoming . getMetadata ( IncomingAmqpMetadata . class ); metadata . ifPresent ( meta -> { String address = meta . getAddress (); String subject = meta . getSubject (); boolean durable = meta . isDurable (); // Use io.vertx.core.json.JsonObject JsonObject properties = meta . getProperties (); // ... });","title":"Inbound Metadata"},{"location":"amqp/receiving-amqp-messages/#acknowledgement","text":"When a Reactive Messaging Message associated with an AMQP Message is acknowledged, it informs the broker that the message has been accepted .","title":"Acknowledgement"},{"location":"amqp/receiving-amqp-messages/#failure-management","text":"If a message produced from an AMQP message is nacked , a failure strategy is applied. The AMQP connector supports six strategies: fail - fail the application; no more AMQP messages will be processed (default). The AMQP message is marked as rejected. accept - this strategy marks the AMQP message as accepted . The processing continues ignoring the failure. Refer to the accepted delivery state documentation . release - this strategy marks the AMQP message as released . The processing continues with the next message. The broker can redeliver the message. Refer to the released delivery state documentation . reject - this strategy marks the AMQP message as rejected. The processing continues with the next message. Refer to the rejected delivery state documentation . modified-failed - this strategy marks the AMQP message as modified and indicates that it failed (with the delivery-failed attribute). The processing continues with the next message, but the broker may attempt to redeliver the message. Refer to the modified delivery state documentation modified-failed-undeliverable-here - this strategy marks the AMQP message as modified and indicates that it failed (with the delivery-failed attribute). It also indicates that the application cannot process the message, meaning that the broker will not attempt to redeliver the message to this node. The processing continues with the next message. Refer to the modified delivery state documentation","title":"Failure Management"},{"location":"amqp/receiving-amqp-messages/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default address The AMQP address. If not set, the channel name is used string false auto-acknowledgement Whether the received AMQP messages must be acknowledged when received boolean false false broadcast Whether the received AMQP messages must be dispatched to multiple subscribers boolean false false capabilities A comma-separated list of capabilities proposed by the sender or receiver client. string false client-options-name (amqp-client-options-name) The name of the AMQP Client Option bean used to customize the AMQP client configuration string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true connect-timeout (amqp-connect-timeout) The connection timeout in milliseconds int false 1000 container-id The AMQP container id string false durable Whether AMQP subscription is durable boolean false false failure-strategy Specify the failure strategy to apply when a message produced from an AMQP message is nacked. Accepted values are fail (default), accept , release , reject , modified-failed , modified-failed-undeliverable-here string false fail health-timeout The max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed. int false 3 host (amqp-host) The broker hostname string false localhost link-name The name of the link. If not set, the channel name is used. string false password (amqp-password) The password used to authenticate to the broker string false port (amqp-port) The broker port int false 5672 reconnect-attempts (amqp-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (amqp-reconnect-interval) The interval in second between two reconnection attempts int false 10 selector Sets a message selector. This attribute is used to define an apache.org:selector-filter:string filter on the source terminus, using SQL-based syntax to request the server filters which messages are delivered to the receiver (if supported by the server in question). Precise functionality supported and syntax needed can vary depending on the server. string false sni-server-name (amqp-sni-server-name) If set, explicitly override the hostname to use for the TLS SNI server name string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true use-ssl (amqp-use-ssl) Whether the AMQP connection uses SSL/TLS boolean false false username (amqp-username) The username used to authenticate to the broker string false virtual-host (amqp-virtual-host) If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use) string false You can also pass any property supported by the Vert.x AMQP client as attribute. To use an existing address or queue , you need to configure the address , container-id and, optionally, the link-name attributes. For example, if you have an Apache Artemis broker configured with: 1 2 3 4 5 6 7
    people
    true artemis     You need the following configuration: 1 2 3 4 mp.messaging.incoming.people.connector = smallrye-amqp mp.messaging.incoming.people.durable = true mp.messaging.incoming.people.address = people mp.messaging.incoming.people.container-id = people You may need to configure the link-name attribute, if the queue name is not the channel name: 1 2 3 4 5 mp.messaging.incoming.people-in.connector = smallrye-amqp mp.messaging.incoming.people-in.durable = true mp.messaging.incoming.people-in.address = people mp.messaging.incoming.people-in.container-id = people mp.messaging.incoming.people-in.link-name = people","title":"Configuration Reference"},{"location":"amqp/receiving-amqp-messages/#receiving-cloud-events","text":"The AMQP connector supports Cloud Events . When the connector detects a structured or binary Cloud Events, it adds a IncomingCloudEventMetadata into the metadata of the Message . IncomingCloudEventMetadata contains accessors to the mandatory and optional Cloud Event attributes. If the connector cannot extract the Cloud Event metadata, it sends the Message without the metadata.","title":"Receiving Cloud Events"},{"location":"amqp/receiving-amqp-messages/#binary-cloud-events","text":"For binary Cloud Events, all mandatory Cloud Event attributes must be set in the AMQP application properties, prefixed by cloudEvents: (as mandated by the protocol binding ). The connector considers headers starting with the cloudEvents: prefix but not listed in the specification as extensions. You can access them using the getExtension method from IncomingCloudEventMetadata . The datacontenttype attribute is mapped to the content-type header of the record.","title":"Binary Cloud Events"},{"location":"amqp/receiving-amqp-messages/#structured-cloud-events","text":"For structured Cloud Events, the event is encoded in the record\u2019s value. Only JSON is supported, so your event must be encoded as JSON in the record\u2019s value. Structured Cloud Event must set the content-type header of the record to application/cloudevents+json; charset=UTF-8 . The message body must be a valid JSON object containing at least all the mandatory Cloud Events attributes. If the record is a structured Cloud Event, the created Message\u2019s payload is the Cloud Event data .","title":"Structured Cloud Events"},{"location":"amqp/sending-amqp-messages/","text":"Sending messages to AMQP The AMQP connector can write Reactive Messaging Messages as AMQP Messages. Example Let\u2019s imagine you have an AMQP broker (such as Apache ActiveMQ Artemis ) running, and accessible using the amqp:5672 address (by default it would use localhost:5672 ). Configure your application to send the messages from the prices channel as AMQP Message as follows: 1 2 3 4 5 6 amqp-host = amqp # <1> amqp-port = 5672 # <2> amqp-username = my-username # <3> amqp-password = my-password # <4> mp.messaging.outgoing.prices.connector = smallrye-amqp # <5> 1. Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using amqp-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using amqp-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using amqp-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using amqp-password . Instructs the prices channel to be managed by the AMQP connector Note You don\u2019t need to set the address . By default, it uses the channel name ( prices ). You can configure the address attribute to override it. Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package amqp.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class AmqpPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package amqp.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class AmqpPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } } Serialization When receiving a Message , the connector convert the message into an AMQP Message. The payload is converted to the AMQP Message body . T AMQP Message Body primitive types or String AMQP Value with the payload Instant or UUID AMQP Value using the corresponding AMQP Type JsonObject or JsonArray AMQP Data using a binary content. The content-type is set to application/json io.vertx.mutiny.core.buffer.Buffer AMQP Data using a binary content. No content-type set Any other class The payload is converted to JSON (using a Json Mapper). The result is wrapped into AMQP Data using a binary content. The content-type is set to application/json If the message payload cannot be serialized to JSON, the message is nacked . Outbound Metadata When sending Messages , you can add an instance of OutgoingAmqpMetadata to influence how the message is going to be sent to AMQP. For example, you can configure the subjects, properties: 1 2 3 4 5 6 7 8 OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata . builder () . withDurable ( true ) . withSubject ( \"my-subject\" ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); Dynamic address names Sometimes it is desirable to select the destination of a message dynamically. In this case, you should not configure the address inside your application configuration file, but instead, use the outbound metadata to set the address. For example, you can send to a dynamic address based on the incoming message: 1 2 3 4 5 6 7 8 9 String addressName = selectAddressFromIncommingMessage ( incoming ); OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata . builder () . withAddress ( addressName ) . withDurable ( true ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); Note To be able to set the address per message, the connector is using an anonymous sender . Acknowledgement By default, the Reactive Messaging Message is acknowledged when the broker acknowledged the message. When using routers, this acknowledgement may not be enabled. In this case, configure the auto-acknowledgement attribute to acknowledge the message as soon as it has been sent to the router. If an AMQP message is rejected/released/modified by the broker (or cannot be sent successfully), the message is nacked. Back Pressure and Credits The back-pressure is handled by AMQP credits . The outbound connector only requests the amount of allowed credits. When the amount of credits reaches 0, it waits (in a non-blocking fashion) until the broker grants more credits to the AMQP sender. Configuration Reference Attribute ( alias ) Description Type Mandatory Default address The AMQP address. If not set, the channel name is used string false capabilities A comma-separated list of capabilities proposed by the sender or receiver client. string false client-options-name (amqp-client-options-name) The name of the AMQP Client Option bean used to customize the AMQP client configuration string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true cloud-events-data-content-type (cloud-events-default-data-content-type) Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the datacontenttype attribute itself string false cloud-events-data-schema (cloud-events-default-data-schema) Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the dataschema attribute itself string false cloud-events-insert-timestamp (cloud-events-default-timestamp) Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the time attribute itself boolean false true cloud-events-mode The Cloud Event mode ( structured or binary (default)). Indicates how are written the cloud events in the outgoing record string false binary cloud-events-source (cloud-events-default-source) Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the source attribute itself string false cloud-events-subject (cloud-events-default-subject) Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the subject attribute itself string false cloud-events-type (cloud-events-default-type) Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the type attribute itself string false connect-timeout (amqp-connect-timeout) The connection timeout in milliseconds int false 1000 container-id The AMQP container id string false credit-retrieval-period The period (in milliseconds) between two attempts to retrieve the credits granted by the broker. This time is used when the sender run out of credits. int false 2000 durable Whether sent AMQP messages are marked durable boolean false false health-timeout The max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed. int false 3 host (amqp-host) The broker hostname string false localhost link-name The name of the link. If not set, the channel name is used. string false merge Whether the connector should allow multiple upstreams boolean false false password (amqp-password) The password used to authenticate to the broker string false port (amqp-port) The broker port int false 5672 reconnect-attempts (amqp-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (amqp-reconnect-interval) The interval in second between two reconnection attempts int false 10 sni-server-name (amqp-sni-server-name) If set, explicitly override the hostname to use for the TLS SNI server name string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true ttl The time-to-live of the send AMQP messages. 0 to disable the TTL long false 0 use-anonymous-sender Whether or not the connector should use an anonymous sender. Default value is true if the broker supports it, false otherwise. If not supported, it is not possible to dynamically change the destination address. boolean false use-ssl (amqp-use-ssl) Whether the AMQP connection uses SSL/TLS boolean false false username (amqp-username) The username used to authenticate to the broker string false virtual-host (amqp-virtual-host) If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use) string false You can also pass any property supported by the Vert.x AMQP client as attribute. Using existing destinations To use an existing address or queue , you need to configure the address , container-id and, optionally, the link-name attributes. For example, if you have an Apache Artemis broker configured with: 1 2 3 4 5 6 7
    people
    true artemis     You need the following configuration: 1 2 3 4 mp.messaging.outgoing.people.connector = smallrye-amqp mp.messaging.outgoing.people.durable = true mp.messaging.outgoing.people.address = people mp.messaging.outgoing.people.container-id = people You may need to configure the link-name attribute, if the queue name is not the channel name: 1 2 3 4 5 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.durable = true mp.messaging.outgoing.people-out.address = people mp.messaging.outgoing.people-out.container-id = people mp.messaging.outgoing.people-out.link-name = people To use a MULTICAST queue, you need to provide the FQQN (Fully-qualified queue name) instead of just the name of the queue: 1 2 3 4 5 6 7 8 9 10 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.durable = true mp.messaging.outgoing.people-out.address = foo mp.messaging.outgoing.people-out.container-id = foo mp.messaging.incoming.people-out.connector = smallrye-amqp mp.messaging.incoming.people-out.durable = true mp.messaging.incoming.people-out.address = foo::bar # Note the syntax: address-name::queue-name mp.messaging.incoming.people-out.container-id = bar mp.messaging.incoming.people-out.link-name = people More details about the AMQP Address model can be found on the Artemis documentation . Sending Cloud Events The AMQP connector supports Cloud Events . The connector sends the outbound record as Cloud Events if: the message metadata contains an io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instance, the channel configuration defines the cloud-events-type and cloud-events-source attributes. You can create io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances using: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package amqp.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class AmqpCloudEventProcessor { @Outgoing ( \"cloud-events\" ) public Message < String > toCloudEvents ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greetings\" ) . withSource ( URI . create ( \"http://example.com\" )) . withSubject ( \"greeting-message\" ) . build ()); } } If the metadata does not contain an id, the connector generates one (random UUID). The type and source can be configured per message or at the channel level using the cloud-events-type and cloud-events-source attributes. Other attributes are also configurable. The metadata can be contributed by multiple methods, however, you must always retrieve the already existing metadata to avoid overriding the values: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 package amqp.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class AmqpCloudEventMultipleProcessors { @Incoming ( \"source\" ) @Outgoing ( \"processed\" ) public Message < String > process ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greeting\" ) . build ()); } @SuppressWarnings ( \"unchecked\" ) @Incoming ( \"processed\" ) @Outgoing ( \"cloud-events\" ) public Message < String > process2 ( Message < String > in ) { OutgoingCloudEventMetadata < String > metadata = in . getMetadata ( OutgoingCloudEventMetadata . class ) . orElseGet (() -> OutgoingCloudEventMetadata . builder (). build ()); return in . addMetadata ( OutgoingCloudEventMetadata . from ( metadata ) . withSource ( URI . create ( \"source://me\" )) . withSubject ( \"test\" ) . build ()); } } By default, the connector sends the Cloud Events using the binary format. You can write structured Cloud Events by setting the cloud-events-mode to structured . Only JSON is supported, so the created records had its content-type header set to application/cloudevents+json; charset=UTF-8 Note you can disable the Cloud Event support by setting the cloud-events attribute to false","title":"Sending messages"},{"location":"amqp/sending-amqp-messages/#sending-messages-to-amqp","text":"The AMQP connector can write Reactive Messaging Messages as AMQP Messages.","title":"Sending messages to AMQP"},{"location":"amqp/sending-amqp-messages/#example","text":"Let\u2019s imagine you have an AMQP broker (such as Apache ActiveMQ Artemis ) running, and accessible using the amqp:5672 address (by default it would use localhost:5672 ). Configure your application to send the messages from the prices channel as AMQP Message as follows: 1 2 3 4 5 6 amqp-host = amqp # <1> amqp-port = 5672 # <2> amqp-username = my-username # <3> amqp-password = my-password # <4> mp.messaging.outgoing.prices.connector = smallrye-amqp # <5> 1. Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using amqp-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using amqp-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using amqp-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using amqp-password . Instructs the prices channel to be managed by the AMQP connector Note You don\u2019t need to set the address . By default, it uses the channel name ( prices ). You can configure the address attribute to override it. Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package amqp.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class AmqpPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package amqp.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class AmqpPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } }","title":"Example"},{"location":"amqp/sending-amqp-messages/#serialization","text":"When receiving a Message , the connector convert the message into an AMQP Message. The payload is converted to the AMQP Message body . T AMQP Message Body primitive types or String AMQP Value with the payload Instant or UUID AMQP Value using the corresponding AMQP Type JsonObject or JsonArray AMQP Data using a binary content. The content-type is set to application/json io.vertx.mutiny.core.buffer.Buffer AMQP Data using a binary content. No content-type set Any other class The payload is converted to JSON (using a Json Mapper). The result is wrapped into AMQP Data using a binary content. The content-type is set to application/json If the message payload cannot be serialized to JSON, the message is nacked .","title":"Serialization"},{"location":"amqp/sending-amqp-messages/#outbound-metadata","text":"When sending Messages , you can add an instance of OutgoingAmqpMetadata to influence how the message is going to be sent to AMQP. For example, you can configure the subjects, properties: 1 2 3 4 5 6 7 8 OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata . builder () . withDurable ( true ) . withSubject ( \"my-subject\" ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata );","title":"Outbound Metadata"},{"location":"amqp/sending-amqp-messages/#dynamic-address-names","text":"Sometimes it is desirable to select the destination of a message dynamically. In this case, you should not configure the address inside your application configuration file, but instead, use the outbound metadata to set the address. For example, you can send to a dynamic address based on the incoming message: 1 2 3 4 5 6 7 8 9 String addressName = selectAddressFromIncommingMessage ( incoming ); OutgoingAmqpMetadata metadata = OutgoingAmqpMetadata . builder () . withAddress ( addressName ) . withDurable ( true ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); Note To be able to set the address per message, the connector is using an anonymous sender .","title":"Dynamic address names"},{"location":"amqp/sending-amqp-messages/#acknowledgement","text":"By default, the Reactive Messaging Message is acknowledged when the broker acknowledged the message. When using routers, this acknowledgement may not be enabled. In this case, configure the auto-acknowledgement attribute to acknowledge the message as soon as it has been sent to the router. If an AMQP message is rejected/released/modified by the broker (or cannot be sent successfully), the message is nacked.","title":"Acknowledgement"},{"location":"amqp/sending-amqp-messages/#back-pressure-and-credits","text":"The back-pressure is handled by AMQP credits . The outbound connector only requests the amount of allowed credits. When the amount of credits reaches 0, it waits (in a non-blocking fashion) until the broker grants more credits to the AMQP sender.","title":"Back Pressure and Credits"},{"location":"amqp/sending-amqp-messages/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default address The AMQP address. If not set, the channel name is used string false capabilities A comma-separated list of capabilities proposed by the sender or receiver client. string false client-options-name (amqp-client-options-name) The name of the AMQP Client Option bean used to customize the AMQP client configuration string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true cloud-events-data-content-type (cloud-events-default-data-content-type) Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the datacontenttype attribute itself string false cloud-events-data-schema (cloud-events-default-data-schema) Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the dataschema attribute itself string false cloud-events-insert-timestamp (cloud-events-default-timestamp) Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the time attribute itself boolean false true cloud-events-mode The Cloud Event mode ( structured or binary (default)). Indicates how are written the cloud events in the outgoing record string false binary cloud-events-source (cloud-events-default-source) Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the source attribute itself string false cloud-events-subject (cloud-events-default-subject) Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the subject attribute itself string false cloud-events-type (cloud-events-default-type) Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the type attribute itself string false connect-timeout (amqp-connect-timeout) The connection timeout in milliseconds int false 1000 container-id The AMQP container id string false credit-retrieval-period The period (in milliseconds) between two attempts to retrieve the credits granted by the broker. This time is used when the sender run out of credits. int false 2000 durable Whether sent AMQP messages are marked durable boolean false false health-timeout The max number of seconds to wait to determine if the connection with the broker is still established for the readiness check. After that threshold, the check is considered as failed. int false 3 host (amqp-host) The broker hostname string false localhost link-name The name of the link. If not set, the channel name is used. string false merge Whether the connector should allow multiple upstreams boolean false false password (amqp-password) The password used to authenticate to the broker string false port (amqp-port) The broker port int false 5672 reconnect-attempts (amqp-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (amqp-reconnect-interval) The interval in second between two reconnection attempts int false 10 sni-server-name (amqp-sni-server-name) If set, explicitly override the hostname to use for the TLS SNI server name string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true ttl The time-to-live of the send AMQP messages. 0 to disable the TTL long false 0 use-anonymous-sender Whether or not the connector should use an anonymous sender. Default value is true if the broker supports it, false otherwise. If not supported, it is not possible to dynamically change the destination address. boolean false use-ssl (amqp-use-ssl) Whether the AMQP connection uses SSL/TLS boolean false false username (amqp-username) The username used to authenticate to the broker string false virtual-host (amqp-virtual-host) If set, configure the hostname value used for the connection AMQP Open frame and TLS SNI server name (if TLS is in use) string false You can also pass any property supported by the Vert.x AMQP client as attribute.","title":"Configuration Reference"},{"location":"amqp/sending-amqp-messages/#using-existing-destinations","text":"To use an existing address or queue , you need to configure the address , container-id and, optionally, the link-name attributes. For example, if you have an Apache Artemis broker configured with: 1 2 3 4 5 6 7
    people
    true artemis     You need the following configuration: 1 2 3 4 mp.messaging.outgoing.people.connector = smallrye-amqp mp.messaging.outgoing.people.durable = true mp.messaging.outgoing.people.address = people mp.messaging.outgoing.people.container-id = people You may need to configure the link-name attribute, if the queue name is not the channel name: 1 2 3 4 5 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.durable = true mp.messaging.outgoing.people-out.address = people mp.messaging.outgoing.people-out.container-id = people mp.messaging.outgoing.people-out.link-name = people To use a MULTICAST queue, you need to provide the FQQN (Fully-qualified queue name) instead of just the name of the queue: 1 2 3 4 5 6 7 8 9 10 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.durable = true mp.messaging.outgoing.people-out.address = foo mp.messaging.outgoing.people-out.container-id = foo mp.messaging.incoming.people-out.connector = smallrye-amqp mp.messaging.incoming.people-out.durable = true mp.messaging.incoming.people-out.address = foo::bar # Note the syntax: address-name::queue-name mp.messaging.incoming.people-out.container-id = bar mp.messaging.incoming.people-out.link-name = people More details about the AMQP Address model can be found on the Artemis documentation .","title":"Using existing destinations"},{"location":"amqp/sending-amqp-messages/#sending-cloud-events","text":"The AMQP connector supports Cloud Events . The connector sends the outbound record as Cloud Events if: the message metadata contains an io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instance, the channel configuration defines the cloud-events-type and cloud-events-source attributes. You can create io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances using: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package amqp.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class AmqpCloudEventProcessor { @Outgoing ( \"cloud-events\" ) public Message < String > toCloudEvents ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greetings\" ) . withSource ( URI . create ( \"http://example.com\" )) . withSubject ( \"greeting-message\" ) . build ()); } } If the metadata does not contain an id, the connector generates one (random UUID). The type and source can be configured per message or at the channel level using the cloud-events-type and cloud-events-source attributes. Other attributes are also configurable. The metadata can be contributed by multiple methods, however, you must always retrieve the already existing metadata to avoid overriding the values: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 package amqp.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class AmqpCloudEventMultipleProcessors { @Incoming ( \"source\" ) @Outgoing ( \"processed\" ) public Message < String > process ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greeting\" ) . build ()); } @SuppressWarnings ( \"unchecked\" ) @Incoming ( \"processed\" ) @Outgoing ( \"cloud-events\" ) public Message < String > process2 ( Message < String > in ) { OutgoingCloudEventMetadata < String > metadata = in . getMetadata ( OutgoingCloudEventMetadata . class ) . orElseGet (() -> OutgoingCloudEventMetadata . builder (). build ()); return in . addMetadata ( OutgoingCloudEventMetadata . from ( metadata ) . withSource ( URI . create ( \"source://me\" )) . withSubject ( \"test\" ) . build ()); } } By default, the connector sends the Cloud Events using the binary format. You can write structured Cloud Events by setting the cloud-events-mode to structured . Only JSON is supported, so the created records had its content-type header set to application/cloudevents+json; charset=UTF-8 Note you can disable the Cloud Event support by setting the cloud-events attribute to false","title":"Sending Cloud Events"},{"location":"camel/camel-processor/","text":"The processor pattern using Camel Using the processor pattern, you can consume on a channel using a Camel component, and produce on a channel using another Camel component. In that case, the headers present in the incoming metadata will be forwarded in the outgoing metadata. Example Let\u2019s imagine you want to read messages from a Nats subject, process it and produce a message on a Kafka topic. 1 2 3 4 5 6 7 mp.messaging.incoming.mynatssubject.connector = smallrye-camel # <1> mp.messaging.incoming.mynatssubject.endpoint-uri = nats:mynatssubject # <2> mp.messaging.outgoing.mykafkatopic.connector = smallrye-camel # <3> mp.messaging.outgoing.mykafkatopic.endpoint-uri = kafka:mykafkatopic# <4> camel.component.nats.servers = 127.0.0.1:5555 # <5> camel.component.kafka.brokers = 127.0.0.1:9092 # <6> 1. Sets the connector for the mynatssubject channel 2. Configures the endpoint-uri for nats subject 3. Sets the connector for the mykafkatopic channel 4. Configures the endpoint-uri for the kafka topic 5. Sets the URL of the nats server to use 6. Sets the URL of a kafka broker to use 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 package camel.processor ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class CamelProcessor { @Incoming ( \"mynatssubject\" ) @Outgoing ( \"mykafkatopic\" ) public byte [] process ( byte [] message ) { // do some logic return message ; } }","title":"Implementing Camel processor"},{"location":"camel/camel-processor/#the-processor-pattern-using-camel","text":"Using the processor pattern, you can consume on a channel using a Camel component, and produce on a channel using another Camel component. In that case, the headers present in the incoming metadata will be forwarded in the outgoing metadata.","title":"The processor pattern using Camel"},{"location":"camel/camel-processor/#example","text":"Let\u2019s imagine you want to read messages from a Nats subject, process it and produce a message on a Kafka topic. 1 2 3 4 5 6 7 mp.messaging.incoming.mynatssubject.connector = smallrye-camel # <1> mp.messaging.incoming.mynatssubject.endpoint-uri = nats:mynatssubject # <2> mp.messaging.outgoing.mykafkatopic.connector = smallrye-camel # <3> mp.messaging.outgoing.mykafkatopic.endpoint-uri = kafka:mykafkatopic# <4> camel.component.nats.servers = 127.0.0.1:5555 # <5> camel.component.kafka.brokers = 127.0.0.1:9092 # <6> 1. Sets the connector for the mynatssubject channel 2. Configures the endpoint-uri for nats subject 3. Sets the connector for the mykafkatopic channel 4. Configures the endpoint-uri for the kafka topic 5. Sets the URL of the nats server to use 6. Sets the URL of a kafka broker to use 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 package camel.processor ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class CamelProcessor { @Incoming ( \"mynatssubject\" ) @Outgoing ( \"mykafkatopic\" ) public byte [] process ( byte [] message ) { // do some logic return message ; } }","title":"Example"},{"location":"camel/camel/","text":"Apache Camel Connector The Camel connector adds support for Apache Camel to Reactive Messaging. Camel is an open source integration framework let you integrate various systems consuming or producing data. Camel implements the Enterprise Integration Patterns and provides several hundred of components used to access databases, message queues, APIs or basically anything under the sun . Introduction Camel is not a messaging broker. But, it allows your Reactive Messaging application to retrieve data from almost anything and send data to almost anything. So if you want to send Reactive Messaging Message to Telegram or retrieve data from Salesforce or SAP, this is the connector you need. One of the Camel cornerstone is the endpoint and its uri encoding the connection to an external system. For example, file:orders/?delete=true&charset=utf-8 instructs Camel to read the files from the orders directory. URI format and parameters are listed on the component documentation, such as the File component . Using the camel connector To you the camel Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-camel 3.25.0 You will also need the dependency of the Camel component you are using. For example, if you want to process files, you would need to add the Camel File Component artifact: 1 2 3 4 5 org.apache.camel camel-file 3.20.1 The connector name is: smallrye-camel . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector=smallrye-camel # Outbound mp.messaging.outgoing.[channel-name].connector=smallrye-camel","title":"Apache Camel Connector"},{"location":"camel/camel/#apache-camel-connector","text":"The Camel connector adds support for Apache Camel to Reactive Messaging. Camel is an open source integration framework let you integrate various systems consuming or producing data. Camel implements the Enterprise Integration Patterns and provides several hundred of components used to access databases, message queues, APIs or basically anything under the sun .","title":"Apache Camel Connector"},{"location":"camel/camel/#introduction","text":"Camel is not a messaging broker. But, it allows your Reactive Messaging application to retrieve data from almost anything and send data to almost anything. So if you want to send Reactive Messaging Message to Telegram or retrieve data from Salesforce or SAP, this is the connector you need. One of the Camel cornerstone is the endpoint and its uri encoding the connection to an external system. For example, file:orders/?delete=true&charset=utf-8 instructs Camel to read the files from the orders directory. URI format and parameters are listed on the component documentation, such as the File component .","title":"Introduction"},{"location":"camel/camel/#using-the-camel-connector","text":"To you the camel Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-camel 3.25.0 You will also need the dependency of the Camel component you are using. For example, if you want to process files, you would need to add the Camel File Component artifact: 1 2 3 4 5 org.apache.camel camel-file 3.20.1 The connector name is: smallrye-camel . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector=smallrye-camel # Outbound mp.messaging.outgoing.[channel-name].connector=smallrye-camel","title":"Using the camel connector"},{"location":"camel/receiving-messages-from-camel/","text":"Retrieving data using Camel Camel provides many components. To keep this documentation focused on the integration with Camel, we use the File component . This component let use read files from a directory. So the connector configured with this component creates a Message for each file located in the directory. As soon as a file is dropped in the directory, a new Message is created. Example Let\u2019s imagine you want to read the files from the orders directory and send them to the files channel. Configuring the Camel connector to gets the file from this directory only requires 2 properties: 1 2 mp.messaging.incoming.files.connector = smallrye-camel # <1> mp.messaging.incoming.files.endpoint-uri = file:orders/?delete=true&charset=utf-8 # <2> 1. Sets the connector for the files channel 2. Configures the endpoint-uri Then, your application receives Message> . Note The Camel File component produces org.apache.camel.component.file.GenericFile instances. You can retrieve the actual File using getFile() . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 package camel.inbound ; import java.io.File ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class CamelFileConsumer { @Incoming ( \"files\" ) public void consume ( GenericFile < File > gf ) { File file = gf . getFile (); // process the file } } You can also retrieve the Message> : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package camel.inbound ; import java.io.File ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class CamelFileMessageConsumer { @Incoming ( \"files\" ) public CompletionStage < Void > consume ( Message < GenericFile < File >> msg ) { File file = msg . getPayload (). getFile (); // process the file return msg . ack (); } } Deserialization Each Camel component is producing specific objects. As we have seen, the File component produces GenericFile . Refer to the component documentation to check which type is produced. Inbound Metadata Messages coming from Camel contains an instance of IncomingExchangeMetadata in the metadata. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 package camel.inbound ; import java.io.File ; import java.util.Optional ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.Exchange ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import io.smallrye.reactive.messaging.camel.IncomingExchangeMetadata ; @ApplicationScoped public class IncomingCamelMetadataExample { @Incoming ( \"files\" ) public CompletionStage < Void > consume ( Message < GenericFile < File >> msg ) { Optional < IncomingExchangeMetadata > metadata = msg . getMetadata ( IncomingExchangeMetadata . class ); if ( metadata . isPresent ()) { // Retrieve the camel exchange: Exchange exchange = metadata . get (). getExchange (); } return msg . ack (); } } This object lets you retrieve the Camel Exchange . Failure Management If a message produced from a Camel exchange is nacked , a failure strategy is applied. The Camel connector supports 3 strategies: fail - fail the application, no more MQTT messages will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue. In both cases, the exchange is marked as rollback only and the nack reason is attached to the exchange. Configuration Reference Attribute ( alias ) Description Type Mandatory Default endpoint-uri The URI of the Camel endpoint (read from or written to) string true failure-strategy Specify the failure strategy to apply when a message produced from a Camel exchange is nacked. Values can be fail (default) or ignore string false fail","title":"Receiving messages from Camel"},{"location":"camel/receiving-messages-from-camel/#retrieving-data-using-camel","text":"Camel provides many components. To keep this documentation focused on the integration with Camel, we use the File component . This component let use read files from a directory. So the connector configured with this component creates a Message for each file located in the directory. As soon as a file is dropped in the directory, a new Message is created.","title":"Retrieving data using Camel"},{"location":"camel/receiving-messages-from-camel/#example","text":"Let\u2019s imagine you want to read the files from the orders directory and send them to the files channel. Configuring the Camel connector to gets the file from this directory only requires 2 properties: 1 2 mp.messaging.incoming.files.connector = smallrye-camel # <1> mp.messaging.incoming.files.endpoint-uri = file:orders/?delete=true&charset=utf-8 # <2> 1. Sets the connector for the files channel 2. Configures the endpoint-uri Then, your application receives Message> . Note The Camel File component produces org.apache.camel.component.file.GenericFile instances. You can retrieve the actual File using getFile() . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 package camel.inbound ; import java.io.File ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class CamelFileConsumer { @Incoming ( \"files\" ) public void consume ( GenericFile < File > gf ) { File file = gf . getFile (); // process the file } } You can also retrieve the Message> : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package camel.inbound ; import java.io.File ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class CamelFileMessageConsumer { @Incoming ( \"files\" ) public CompletionStage < Void > consume ( Message < GenericFile < File >> msg ) { File file = msg . getPayload (). getFile (); // process the file return msg . ack (); } }","title":"Example"},{"location":"camel/receiving-messages-from-camel/#deserialization","text":"Each Camel component is producing specific objects. As we have seen, the File component produces GenericFile . Refer to the component documentation to check which type is produced.","title":"Deserialization"},{"location":"camel/receiving-messages-from-camel/#inbound-metadata","text":"Messages coming from Camel contains an instance of IncomingExchangeMetadata in the metadata. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 package camel.inbound ; import java.io.File ; import java.util.Optional ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.apache.camel.Exchange ; import org.apache.camel.component.file.GenericFile ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import io.smallrye.reactive.messaging.camel.IncomingExchangeMetadata ; @ApplicationScoped public class IncomingCamelMetadataExample { @Incoming ( \"files\" ) public CompletionStage < Void > consume ( Message < GenericFile < File >> msg ) { Optional < IncomingExchangeMetadata > metadata = msg . getMetadata ( IncomingExchangeMetadata . class ); if ( metadata . isPresent ()) { // Retrieve the camel exchange: Exchange exchange = metadata . get (). getExchange (); } return msg . ack (); } } This object lets you retrieve the Camel Exchange .","title":"Inbound Metadata"},{"location":"camel/receiving-messages-from-camel/#failure-management","text":"If a message produced from a Camel exchange is nacked , a failure strategy is applied. The Camel connector supports 3 strategies: fail - fail the application, no more MQTT messages will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue. In both cases, the exchange is marked as rollback only and the nack reason is attached to the exchange.","title":"Failure Management"},{"location":"camel/receiving-messages-from-camel/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default endpoint-uri The URI of the Camel endpoint (read from or written to) string true failure-strategy Specify the failure strategy to apply when a message produced from a Camel exchange is nacked. Values can be fail (default) or ignore string false fail","title":"Configuration Reference"},{"location":"camel/sending-messages-to-camel/","text":"Sending data with Camel You can use the Camel connector to send data to almost any type of system. To keep this document focused on the Camel connector, we use the Camel File component. However, the connector can be used with any Camel component. Example Let\u2019s imagine you want to write generated prices into files. Configure your application to write the messages from the prices channel into a files as follows: 1 2 mp.messaging.outgoing.prices.connector = smallrye-camel # <1> mp.messaging.outgoing.prices.endpoint-uri = file:prices/?fileName=${date:now:yyyyMMddssSS}.txt&charset=utf-8 # <2> 1. Sets the connector for the prices channel 2. Configure the endpoint-uri to write into files in the prices directory Important Depending on your implementation of MicroProfile Reactive Messaging, the $ may need to be escaped as follows: $${...} Then, your application must send Message to the prices channel. It can use String payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package camel.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class CamelPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < String > generate () { // Build an infinite stream of random prices return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . onOverflow (). drop () . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 package camel.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class CamelPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < String >> generate () { // Build an infinite stream of random prices return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )) . map ( Message :: of ); } } Serialization The serialization is handled by the Camel component. Refer to the Camel documentation to check which payload type is supported by the component. Outbound Metadata When sending Messages , you can add an instance of OutgoingExchangeMetadata to the message metadata. You can then influence how the outbound Camel Exchange is created, for example by adding properties: 1 2 3 4 5 6 return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )) . map ( s -> Message . of ( s ) . addMetadata ( new OutgoingExchangeMetadata () . putProperty ( \"my-property\" , \"my-value\" ))); Acknowledgement The incoming messages are acknowledged when the underlying Camel exchange completes. If the exchange fails, the message is nacked. Configuration Reference Attribute ( alias ) Description Type Mandatory Default endpoint-uri The URI of the Camel endpoint (read from or written to) string true merge Whether the connector should allow multiple upstreams boolean false false","title":"Sending messages to Camel"},{"location":"camel/sending-messages-to-camel/#sending-data-with-camel","text":"You can use the Camel connector to send data to almost any type of system. To keep this document focused on the Camel connector, we use the Camel File component. However, the connector can be used with any Camel component.","title":"Sending data with Camel"},{"location":"camel/sending-messages-to-camel/#example","text":"Let\u2019s imagine you want to write generated prices into files. Configure your application to write the messages from the prices channel into a files as follows: 1 2 mp.messaging.outgoing.prices.connector = smallrye-camel # <1> mp.messaging.outgoing.prices.endpoint-uri = file:prices/?fileName=${date:now:yyyyMMddssSS}.txt&charset=utf-8 # <2> 1. Sets the connector for the prices channel 2. Configure the endpoint-uri to write into files in the prices directory Important Depending on your implementation of MicroProfile Reactive Messaging, the $ may need to be escaped as follows: $${...} Then, your application must send Message to the prices channel. It can use String payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package camel.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class CamelPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < String > generate () { // Build an infinite stream of random prices return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . onOverflow (). drop () . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 package camel.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class CamelPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < String >> generate () { // Build an infinite stream of random prices return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )) . map ( Message :: of ); } }","title":"Example"},{"location":"camel/sending-messages-to-camel/#serialization","text":"The serialization is handled by the Camel component. Refer to the Camel documentation to check which payload type is supported by the component.","title":"Serialization"},{"location":"camel/sending-messages-to-camel/#outbound-metadata","text":"When sending Messages , you can add an instance of OutgoingExchangeMetadata to the message metadata. You can then influence how the outbound Camel Exchange is created, for example by adding properties: 1 2 3 4 5 6 return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()) . map ( p -> Double . toString ( p )) . map ( s -> Message . of ( s ) . addMetadata ( new OutgoingExchangeMetadata () . putProperty ( \"my-property\" , \"my-value\" )));","title":"Outbound Metadata"},{"location":"camel/sending-messages-to-camel/#acknowledgement","text":"The incoming messages are acknowledged when the underlying Camel exchange completes. If the exchange fails, the message is nacked.","title":"Acknowledgement"},{"location":"camel/sending-messages-to-camel/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default endpoint-uri The URI of the Camel endpoint (read from or written to) string true merge Whether the connector should allow multiple upstreams boolean false false","title":"Configuration Reference"},{"location":"camel/using-existing-routes/","text":"Using the Camel API The Camel connector is based on the Reactive Streams support from Camel. If you have an application already using the Camel API (routes, from ...), you can integrate it with Reactive Messaging. Getting the CamelReactiveStreamsService Once you add the Camel connector to your application, you can retrieve the org.apache.camel.component.reactive.streams.api.CamelReactiveStreamsService object: 1 2 @Inject CamelReactiveStreamsService reactiveStreamsService ; This CamelReactiveStreamsService lets you create Publisher and Subscriber instances from existing routes. Using Camel Route with @Outgoing If you have an existing Camel route, you can transform it as a Publisher using the CamelReactiveStreamsService . Then, you can return this Publisher from a method annotated with @Outgoing : 1 2 3 4 @Outgoing ( \"camel\" ) public Publisher < Exchange > retrieveDataFromCamelRoute () { return reactiveStreamsService . from ( \"seda:camel\" ); } You can also use RouteBuilder : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @ApplicationScoped static class MyRouteBuilder extends RouteBuilder { @Inject CamelReactiveStreamsService reactiveStreamsService ; @Outgoing ( \"sink\" ) public Publisher < String > getDataFromCamelRoute () { return reactiveStreamsService . fromStream ( \"my-stream\" , String . class ); } @Override public void configure () { from ( \"seda:camel\" ). process ( exchange -> exchange . getMessage (). setBody ( exchange . getIn (). getBody ( String . class ). toUpperCase ())) . to ( \"reactive-streams:my-stream\" ); } } Using Camel Route with @Incoming If you have an existing Camel route, you can transform it as a Subscriber using the CamelReactiveStreamsService . Then, you can return this Subscriber from a method annotated with @Incoming : 1 2 3 4 5 @Incoming ( \"to-camel\" ) public Subscriber < String > sendDataToCamelRoute () { return reactiveStreamsService . subscriber ( \"file:./target?fileName=values.txt&fileExist=append\" , String . class ); } You can also use a producer: 1 2 3 4 5 6 7 8 @Inject CamelContext camel ; @Incoming ( \"to-camel\" ) public CompletionStage < Void > sink ( String value ) { return camel . createProducerTemplate () . asyncSendBody ( \"file:./target?fileName=values.txt&fileExist=append\" , value ). thenApply ( x -> null ); }","title":"Using existing Camel routes"},{"location":"camel/using-existing-routes/#using-the-camel-api","text":"The Camel connector is based on the Reactive Streams support from Camel. If you have an application already using the Camel API (routes, from ...), you can integrate it with Reactive Messaging.","title":"Using the Camel API"},{"location":"camel/using-existing-routes/#getting-the-camelreactivestreamsservice","text":"Once you add the Camel connector to your application, you can retrieve the org.apache.camel.component.reactive.streams.api.CamelReactiveStreamsService object: 1 2 @Inject CamelReactiveStreamsService reactiveStreamsService ; This CamelReactiveStreamsService lets you create Publisher and Subscriber instances from existing routes.","title":"Getting the CamelReactiveStreamsService"},{"location":"camel/using-existing-routes/#using-camel-route-with-outgoing","text":"If you have an existing Camel route, you can transform it as a Publisher using the CamelReactiveStreamsService . Then, you can return this Publisher from a method annotated with @Outgoing : 1 2 3 4 @Outgoing ( \"camel\" ) public Publisher < Exchange > retrieveDataFromCamelRoute () { return reactiveStreamsService . from ( \"seda:camel\" ); } You can also use RouteBuilder : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @ApplicationScoped static class MyRouteBuilder extends RouteBuilder { @Inject CamelReactiveStreamsService reactiveStreamsService ; @Outgoing ( \"sink\" ) public Publisher < String > getDataFromCamelRoute () { return reactiveStreamsService . fromStream ( \"my-stream\" , String . class ); } @Override public void configure () { from ( \"seda:camel\" ). process ( exchange -> exchange . getMessage (). setBody ( exchange . getIn (). getBody ( String . class ). toUpperCase ())) . to ( \"reactive-streams:my-stream\" ); } }","title":"Using Camel Route with @Outgoing"},{"location":"camel/using-existing-routes/#using-camel-route-with-incoming","text":"If you have an existing Camel route, you can transform it as a Subscriber using the CamelReactiveStreamsService . Then, you can return this Subscriber from a method annotated with @Incoming : 1 2 3 4 5 @Incoming ( \"to-camel\" ) public Subscriber < String > sendDataToCamelRoute () { return reactiveStreamsService . subscriber ( \"file:./target?fileName=values.txt&fileExist=append\" , String . class ); } You can also use a producer: 1 2 3 4 5 6 7 8 @Inject CamelContext camel ; @Incoming ( \"to-camel\" ) public CompletionStage < Void > sink ( String value ) { return camel . createProducerTemplate () . asyncSendBody ( \"file:./target?fileName=values.txt&fileExist=append\" , value ). thenApply ( x -> null ); }","title":"Using Camel Route with @Incoming"},{"location":"concepts/acknowledgement/","text":"Acknowledgement Acknowledgment is an essential concept in messaging. A message is acknowledged when its processing or reception has been successful. It allows the broker to move to the next message. How acknowledgment is used, and the exact behavior in terms of retry and resilience depends on the broker. For example, for Kafka, it would commit the offset. For AMQP, it would inform the broker that the message has been accepted . Reactive Messaging supports acknowledgement. The default acknowledgement depends on the method signature. Also, the acknowledgement policy can be configured using the @Acknowledgement annotation. Chain of acknowledgment If we reuse this example: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Outgoing ( \"source\" ) public Multi < String > generate () { return Multi . createFrom (). items ( \"Hello\" , \"from\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"sink\" ) public String process ( String in ) { return in . toUpperCase (); } @Incoming ( \"sink\" ) public void consume ( String processed ) { System . out . println ( processed ); } The framework automatically acknowledges the message received from the sink channel when the consume method returns. As a consequence, the message received by the process method is acknowledged, and so on. In other words, it creates a chain of acknowledgement - from the outbound channel to the inbound channel. When using connectors to receive and consume messages, the outbound connector acknowledges the messages when they are dispatched successfully to the broker. The acknowledgment chain would, as a result, acknowledges the inbound connector, which would be able to send an acknowledgment to the broker. This chain of acknowledgment is automatically implemented when processing payloads. Acknowledgment when using Messages When using Messages , the user controls the acknowledgment, and so the chain is not formed automatically. It gives you more flexibility about when and how the incoming messages are acknowledged. If you create a Message using the with method, is copy the acknowledgment function from the incoming message: 1 2 3 4 5 6 7 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < Integer > process ( Message < Integer > in ) { // The acknowledgement is forwarded, when the consumer // acknowledges the message, `in` will be acknowledged return in . withPayload ( in . getPayload () + 1 ); } To have more control over the acknowledgment, you can create a brand new Message and pass the acknowledgment function: 1 2 3 4 5 6 7 8 9 10 Message < String > message = Message . of ( \"hello\" , () -> { // called when the consumer acknowledges the message // return a CompletionStage completed when the // acknowledgment of the created message is // completed. // For immediate ack use: return CompletableFuture . completedFuture ( null ); }); However, you may need to create the acknowledgment chain, to acknowledge the incoming message: 1 2 3 4 5 6 7 8 9 10 11 12 13 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < Integer > processAndProduceNewMessage ( Message < Integer > in ) { // The acknowledgement is forwarded, when the consumer // acknowledges the message, `in` will be acknowledged return Message . of ( in . getPayload () + 1 , () -> { // Called when the consumer acknowledges the message // ... // Don't forget to acknowledge the incoming message: return in . ack (); }); } To trigger the acknowledgment of the incoming message, use the ack() method. It returns a CompletionStage , receiving null as value when the acknowledgment has completed. Acknowledgment when using streams When transforming streams of Message , the acknowledgment is delegated to the user. It means that it\u2019s up to the user to acknowledge the incoming messages: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Publisher < Message < String >> transform ( Multi < Message < String >> stream ) { return stream . map ( message -> message . withPayload ( message . getPayload (). toUpperCase ())); } In the previous example, we only generate a single message per incoming message so that we can use the with method. It becomes more sophisticated when grouping incoming messages or when each incoming message produces multiple messages. In the case of a stream of payloads, the default strategy acknowledges the incoming messages before being processed by the method (regardless of the outcome). 1 2 3 4 5 6 7 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Publisher < String > transformPayload ( Multi < String > stream ) { return stream // The incoming messages are already acknowledged . map ( String :: toUpperCase ); } Controlling acknowledgement The Acknowledgment annotation lets you customize the default strategy presented in the previous sections. The @Acknowledgement annotation takes a strategy as parameter. Reactive Messaging proposed 4 strategies: POST_PROCESSING - the acknowledgement of the incoming message is executed once the produced message is acknowledged. PRE_PROCESSING - the acknowledgement of the incoming message is executed before the message is processed by the method. MANUAL - the acknowledgement is doe by the user. NONE - No acknowledgment is performed, neither manually or automatically. It is recommended to use POST_PROCESSING as it guarantees that the full processing has completed before acknowledging the incoming message. However, sometimes it\u2019s not possible, and this strategy is not available if you manipulate streams of Messages or payloads. The PRE_PROCESSING strategy can be useful to acknowledge a message early in the process: 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Acknowledgment ( Acknowledgment . Strategy . PRE_PROCESSING ) public String process ( String input ) { // The message wrapping the payload is already acknowledged // The default would have waited the produced message to be // acknowledged return input . toUpperCase (); } It cuts the acknowledgment chain, meaning that the rest of the processing is not linked to the incoming message anymore. This strategy is the default strategy when manipulating streams of payloads. Refer to the signature list to determine which strategies are available for a specific method signature and what\u2019s the default strategy. Negative acknowledgement Messages can also be nacked , which indicates that the message was not processed correctly. The Message.nack method indicates failing processing (and supply the reason), and, as for successful acknowledgment, the nack is propagated through the chain of messages. If the message has been produced by a connector, this connector implements specific behavior when receiving a nack . It can fail (default), or ignore the failing, or implement a dead-letter queue mechanism. Refer to the connector documentation for further details about the available strategies. If the message is sent by an emitter using the send(P) method, the returned CompletionStage is completed exceptionally with the nack reason. 1 2 3 4 5 6 7 8 9 10 11 12 @Inject @Channel ( \"data\" ) Emitter < String > emitter ; public void emitPayload () { CompletionStage < Void > completionStage = emitter . send ( \"hello\" ); completionStage . whenComplete (( acked , nacked ) -> { if ( nacked != null ) { // the processing has failed } }); } Negative acknowledgment can be manual or automatic. If your method handles instances of Message and the acknowledgment strategy is MANUAL , you can nack a message explicitly. You must indicate the reason (an exception) when calling the nack method. As for successful acknowledgment, the nack returns a CompletionStage completed when the nack has been processed. If your method uses the POST_PROCESSING acknowledgment strategy, and the method fails (either by throwing an exception or by producing a failure), the message is automatically nacked with the caught exception: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 @Incoming ( \"data\" ) @Outgoing ( \"out\" ) public String process ( String s ) { if ( s . equalsIgnoreCase ( \"b\" )) { // Throwing an exception triggers a nack throw new IllegalArgumentException ( \"b\" ); } if ( s . equalsIgnoreCase ( \"e\" )) { // Returning null would skip the message (it will be acked) return null ; } return s . toUpperCase (); } @Incoming ( \"data\" ) @Outgoing ( \"out\" ) public Uni < String > processAsync ( String s ) { if ( s . equalsIgnoreCase ( \"a\" )) { // Returning a failing Uni triggers a nack return Uni . createFrom (). failure ( new Exception ( \"a\" )); } if ( s . equalsIgnoreCase ( \"b\" )) { // Throwing an exception triggers a nack throw new IllegalArgumentException ( \"b\" ); } if ( s . equalsIgnoreCase ( \"e\" )) { // Returning null would skip the message (it will be acked not nacked) return Uni . createFrom (). nullItem (); } if ( s . equalsIgnoreCase ( \"f\" )) { // returning `null` is invalid for method returning Unis, the message is nacked return null ; } return Uni . createFrom (). item ( s . toUpperCase ()); }","title":"Acknowledgement"},{"location":"concepts/acknowledgement/#acknowledgement","text":"Acknowledgment is an essential concept in messaging. A message is acknowledged when its processing or reception has been successful. It allows the broker to move to the next message. How acknowledgment is used, and the exact behavior in terms of retry and resilience depends on the broker. For example, for Kafka, it would commit the offset. For AMQP, it would inform the broker that the message has been accepted . Reactive Messaging supports acknowledgement. The default acknowledgement depends on the method signature. Also, the acknowledgement policy can be configured using the @Acknowledgement annotation.","title":"Acknowledgement"},{"location":"concepts/acknowledgement/#chain-of-acknowledgment","text":"If we reuse this example: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Outgoing ( \"source\" ) public Multi < String > generate () { return Multi . createFrom (). items ( \"Hello\" , \"from\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"sink\" ) public String process ( String in ) { return in . toUpperCase (); } @Incoming ( \"sink\" ) public void consume ( String processed ) { System . out . println ( processed ); } The framework automatically acknowledges the message received from the sink channel when the consume method returns. As a consequence, the message received by the process method is acknowledged, and so on. In other words, it creates a chain of acknowledgement - from the outbound channel to the inbound channel. When using connectors to receive and consume messages, the outbound connector acknowledges the messages when they are dispatched successfully to the broker. The acknowledgment chain would, as a result, acknowledges the inbound connector, which would be able to send an acknowledgment to the broker. This chain of acknowledgment is automatically implemented when processing payloads.","title":"Chain of acknowledgment"},{"location":"concepts/acknowledgement/#acknowledgment-when-using-messages","text":"When using Messages , the user controls the acknowledgment, and so the chain is not formed automatically. It gives you more flexibility about when and how the incoming messages are acknowledged. If you create a Message using the with method, is copy the acknowledgment function from the incoming message: 1 2 3 4 5 6 7 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < Integer > process ( Message < Integer > in ) { // The acknowledgement is forwarded, when the consumer // acknowledges the message, `in` will be acknowledged return in . withPayload ( in . getPayload () + 1 ); } To have more control over the acknowledgment, you can create a brand new Message and pass the acknowledgment function: 1 2 3 4 5 6 7 8 9 10 Message < String > message = Message . of ( \"hello\" , () -> { // called when the consumer acknowledges the message // return a CompletionStage completed when the // acknowledgment of the created message is // completed. // For immediate ack use: return CompletableFuture . completedFuture ( null ); }); However, you may need to create the acknowledgment chain, to acknowledge the incoming message: 1 2 3 4 5 6 7 8 9 10 11 12 13 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < Integer > processAndProduceNewMessage ( Message < Integer > in ) { // The acknowledgement is forwarded, when the consumer // acknowledges the message, `in` will be acknowledged return Message . of ( in . getPayload () + 1 , () -> { // Called when the consumer acknowledges the message // ... // Don't forget to acknowledge the incoming message: return in . ack (); }); } To trigger the acknowledgment of the incoming message, use the ack() method. It returns a CompletionStage , receiving null as value when the acknowledgment has completed.","title":"Acknowledgment when using Messages"},{"location":"concepts/acknowledgement/#acknowledgment-when-using-streams","text":"When transforming streams of Message , the acknowledgment is delegated to the user. It means that it\u2019s up to the user to acknowledge the incoming messages: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Publisher < Message < String >> transform ( Multi < Message < String >> stream ) { return stream . map ( message -> message . withPayload ( message . getPayload (). toUpperCase ())); } In the previous example, we only generate a single message per incoming message so that we can use the with method. It becomes more sophisticated when grouping incoming messages or when each incoming message produces multiple messages. In the case of a stream of payloads, the default strategy acknowledges the incoming messages before being processed by the method (regardless of the outcome). 1 2 3 4 5 6 7 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Publisher < String > transformPayload ( Multi < String > stream ) { return stream // The incoming messages are already acknowledged . map ( String :: toUpperCase ); }","title":"Acknowledgment when using streams"},{"location":"concepts/acknowledgement/#controlling-acknowledgement","text":"The Acknowledgment annotation lets you customize the default strategy presented in the previous sections. The @Acknowledgement annotation takes a strategy as parameter. Reactive Messaging proposed 4 strategies: POST_PROCESSING - the acknowledgement of the incoming message is executed once the produced message is acknowledged. PRE_PROCESSING - the acknowledgement of the incoming message is executed before the message is processed by the method. MANUAL - the acknowledgement is doe by the user. NONE - No acknowledgment is performed, neither manually or automatically. It is recommended to use POST_PROCESSING as it guarantees that the full processing has completed before acknowledging the incoming message. However, sometimes it\u2019s not possible, and this strategy is not available if you manipulate streams of Messages or payloads. The PRE_PROCESSING strategy can be useful to acknowledge a message early in the process: 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Acknowledgment ( Acknowledgment . Strategy . PRE_PROCESSING ) public String process ( String input ) { // The message wrapping the payload is already acknowledged // The default would have waited the produced message to be // acknowledged return input . toUpperCase (); } It cuts the acknowledgment chain, meaning that the rest of the processing is not linked to the incoming message anymore. This strategy is the default strategy when manipulating streams of payloads. Refer to the signature list to determine which strategies are available for a specific method signature and what\u2019s the default strategy.","title":"Controlling acknowledgement"},{"location":"concepts/acknowledgement/#negative-acknowledgement","text":"Messages can also be nacked , which indicates that the message was not processed correctly. The Message.nack method indicates failing processing (and supply the reason), and, as for successful acknowledgment, the nack is propagated through the chain of messages. If the message has been produced by a connector, this connector implements specific behavior when receiving a nack . It can fail (default), or ignore the failing, or implement a dead-letter queue mechanism. Refer to the connector documentation for further details about the available strategies. If the message is sent by an emitter using the send(P) method, the returned CompletionStage is completed exceptionally with the nack reason. 1 2 3 4 5 6 7 8 9 10 11 12 @Inject @Channel ( \"data\" ) Emitter < String > emitter ; public void emitPayload () { CompletionStage < Void > completionStage = emitter . send ( \"hello\" ); completionStage . whenComplete (( acked , nacked ) -> { if ( nacked != null ) { // the processing has failed } }); } Negative acknowledgment can be manual or automatic. If your method handles instances of Message and the acknowledgment strategy is MANUAL , you can nack a message explicitly. You must indicate the reason (an exception) when calling the nack method. As for successful acknowledgment, the nack returns a CompletionStage completed when the nack has been processed. If your method uses the POST_PROCESSING acknowledgment strategy, and the method fails (either by throwing an exception or by producing a failure), the message is automatically nacked with the caught exception: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 @Incoming ( \"data\" ) @Outgoing ( \"out\" ) public String process ( String s ) { if ( s . equalsIgnoreCase ( \"b\" )) { // Throwing an exception triggers a nack throw new IllegalArgumentException ( \"b\" ); } if ( s . equalsIgnoreCase ( \"e\" )) { // Returning null would skip the message (it will be acked) return null ; } return s . toUpperCase (); } @Incoming ( \"data\" ) @Outgoing ( \"out\" ) public Uni < String > processAsync ( String s ) { if ( s . equalsIgnoreCase ( \"a\" )) { // Returning a failing Uni triggers a nack return Uni . createFrom (). failure ( new Exception ( \"a\" )); } if ( s . equalsIgnoreCase ( \"b\" )) { // Throwing an exception triggers a nack throw new IllegalArgumentException ( \"b\" ); } if ( s . equalsIgnoreCase ( \"e\" )) { // Returning null would skip the message (it will be acked not nacked) return Uni . createFrom (). nullItem (); } if ( s . equalsIgnoreCase ( \"f\" )) { // returning `null` is invalid for method returning Unis, the message is nacked return null ; } return Uni . createFrom (). item ( s . toUpperCase ()); }","title":"Negative acknowledgement"},{"location":"concepts/advanced-config/","text":"Advanced configuration Strict Binding Mode By default, SmallRye Reactive Messaging does not enforce whether all mediators are connected. It just prints a warning message. The strict mode fails the deployment if some \"incomings\" are not bound to \"outgoings\". To enable this mode, you can pass the -Dsmallrye-messaging-strict-binding=true via the command line, or you can set the smallrye-messaging-strict-binding attribute to true in the configuration: 1 smallrye-messaging-strict-binding=true Disabling channels You can disable a channel in the configuration by setting the enabled attribute to false : 1 2 mp.messaging.outgoing.dummy-sink.connector=dummy mp.messaging.outgoing.dummy-sink.enabled=false # Disable this channel SmallRye Reactive Messaging does not register disabled channels, so make sure the rest of the application does not rely on them. Publisher metrics SmallRye Reactive Messaging integrates MicroProfile Metrics and Micrometer for registering counter metrics (named mp.messaging.message.count ) of published messages per channel. Both MicroProfile and Micrometer publisher metrics are enabled by default if found on the classpath. They can be disabled with smallrye.messaging.metrics.mp.enabled and smallrye.messaging.metrics.micrometer.enabled properties respectively.","title":"Advanced Configuration"},{"location":"concepts/advanced-config/#advanced-configuration","text":"","title":"Advanced configuration"},{"location":"concepts/advanced-config/#strict-binding-mode","text":"By default, SmallRye Reactive Messaging does not enforce whether all mediators are connected. It just prints a warning message. The strict mode fails the deployment if some \"incomings\" are not bound to \"outgoings\". To enable this mode, you can pass the -Dsmallrye-messaging-strict-binding=true via the command line, or you can set the smallrye-messaging-strict-binding attribute to true in the configuration: 1 smallrye-messaging-strict-binding=true","title":"Strict Binding Mode"},{"location":"concepts/advanced-config/#disabling-channels","text":"You can disable a channel in the configuration by setting the enabled attribute to false : 1 2 mp.messaging.outgoing.dummy-sink.connector=dummy mp.messaging.outgoing.dummy-sink.enabled=false # Disable this channel SmallRye Reactive Messaging does not register disabled channels, so make sure the rest of the application does not rely on them.","title":"Disabling channels"},{"location":"concepts/advanced-config/#publisher-metrics","text":"SmallRye Reactive Messaging integrates MicroProfile Metrics and Micrometer for registering counter metrics (named mp.messaging.message.count ) of published messages per channel. Both MicroProfile and Micrometer publisher metrics are enabled by default if found on the classpath. They can be disabled with smallrye.messaging.metrics.mp.enabled and smallrye.messaging.metrics.micrometer.enabled properties respectively.","title":"Publisher metrics"},{"location":"concepts/blocking/","text":"@Blocking The io.smallrye.reactive.messaging.annotations.Blocking annotation can be used on a method annotated with @Incoming , or @Outgoing to indicate that the method should be executed on a worker pool: 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking public String process ( String s ) { return s . toUpperCase (); } If method execution does not need to be ordered, it can be indicated on the @Blocking annotation: 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking ( ordered = false ) public String process ( String s ) { return s . toUpperCase (); } When unordered, the invocation can happen concurrently. By default, use of @Blocking results in the method being executed in the Vert.x worker pool. If it\u2019s desired to execute methods on a custom worker pool, with specific concurrency needs, it can be defined on @Blocking : 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking ( \"my-custom-pool\" ) public String process ( String s ) { return s . toUpperCase (); } Specifying the concurrency for the above worker pool requires the following configuration property to be defined: 1 smallrye.messaging.worker.my-custom-pool.max-concurrency=3 Supported signatures @Blocking does not support every signature. The following table lists the supported ones. Shape Signature Comment Publisher @Outgoing(\"in\") @Blocking O generator() Invokes the generator from a worker thread. If ordered is set to false , the generator can be called concurrently. Publisher @Outgoing(\"in\") @Blocking Message generator() Invokes the generator from a worker thread. If ordered is set to false , the generator can be called concurrently. Processor @Incoming(\"in\") @Outgoing(\"bar\") @Blocking O process(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Processor @Incoming(\"in\") @Outgoing(\"bar\") @Blocking Message process(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking void consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking Uni consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking CompletionStage consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. When a method can be called concurrently, the max concurrency depends on the number of threads from the worker thread pool. Using io.smallrye.common.annotation.Blocking io.smallrye.common.annotation.Blocking is another annotation with the same semantic. io.smallrye.common.annotation.Blocking is used by multiple SmallRye projects and Quarkus. SmallRye Reactive Messaging also supports io.smallrye.common.annotation.Blocking . However, io.smallrye.common.annotation.Blocking does not allow configuring the ordering (it defaults to ordered=true ). When both annotations are used, io.smallrye.reactive.messaging.annotations.Blocking is preferred.","title":"Blocking Processing"},{"location":"concepts/blocking/#blocking","text":"The io.smallrye.reactive.messaging.annotations.Blocking annotation can be used on a method annotated with @Incoming , or @Outgoing to indicate that the method should be executed on a worker pool: 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking public String process ( String s ) { return s . toUpperCase (); } If method execution does not need to be ordered, it can be indicated on the @Blocking annotation: 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking ( ordered = false ) public String process ( String s ) { return s . toUpperCase (); } When unordered, the invocation can happen concurrently. By default, use of @Blocking results in the method being executed in the Vert.x worker pool. If it\u2019s desired to execute methods on a custom worker pool, with specific concurrency needs, it can be defined on @Blocking : 1 2 3 4 5 6 @Outgoing ( \"Y\" ) @Incoming ( \"X\" ) @Blocking ( \"my-custom-pool\" ) public String process ( String s ) { return s . toUpperCase (); } Specifying the concurrency for the above worker pool requires the following configuration property to be defined: 1 smallrye.messaging.worker.my-custom-pool.max-concurrency=3","title":"@Blocking"},{"location":"concepts/blocking/#supported-signatures","text":"@Blocking does not support every signature. The following table lists the supported ones. Shape Signature Comment Publisher @Outgoing(\"in\") @Blocking O generator() Invokes the generator from a worker thread. If ordered is set to false , the generator can be called concurrently. Publisher @Outgoing(\"in\") @Blocking Message generator() Invokes the generator from a worker thread. If ordered is set to false , the generator can be called concurrently. Processor @Incoming(\"in\") @Outgoing(\"bar\") @Blocking O process(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Processor @Incoming(\"in\") @Outgoing(\"bar\") @Blocking Message process(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking void consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking Uni consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. Subscriber @Incoming(\"in\") @Blocking CompletionStage consume(I in) Invokes the method on a worker thread. If ordered is set to false , the method can be called concurrently. When a method can be called concurrently, the max concurrency depends on the number of threads from the worker thread pool.","title":"Supported signatures"},{"location":"concepts/blocking/#using-iosmallryecommonannotationblocking","text":"io.smallrye.common.annotation.Blocking is another annotation with the same semantic. io.smallrye.common.annotation.Blocking is used by multiple SmallRye projects and Quarkus. SmallRye Reactive Messaging also supports io.smallrye.common.annotation.Blocking . However, io.smallrye.common.annotation.Blocking does not allow configuring the ordering (it defaults to ordered=true ). When both annotations are used, io.smallrye.reactive.messaging.annotations.Blocking is preferred.","title":"Using io.smallrye.common.annotation.Blocking"},{"location":"concepts/broadcast/","text":"Broadcast Experimental @Broadcast is an experimental feature. By default, messages transiting in a channel are only dispatched to a single consumer. Having multiple consumers is considered as an error, and is reported at deployment time. The Broadcast annotation changes this behavior and indicates that messages transiting in the channel are dispatched to all the consumers. @Broadcast must be used with the @Outgoing annotation: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Broadcast public int increment ( int i ) { return i + 1 ; } @Incoming ( \"out\" ) public void consume1 ( int i ) { //... } @Incoming ( \"out\" ) public void consume2 ( int i ) { //... } In the previous example, both consumers get the messages. You can also control the number of consumers to wait before starting to dispatch the messages. This allows waiting for the complete graph to be woven: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Broadcast ( 2 ) public int increment ( int i ) { return i + 1 ; } @Incoming ( \"out\" ) public void consume1 ( int i ) { //... } @Incoming ( \"out\" ) public void consume2 ( int i ) { //... } Note Inbound connectors also support a broadcast attribute that allows broadcasting the messages to multiple downstream subscribers. Use with Emitter For details on how to use @Broadcast with Emitter see the documentation .","title":"Broadcast"},{"location":"concepts/broadcast/#broadcast","text":"Experimental @Broadcast is an experimental feature. By default, messages transiting in a channel are only dispatched to a single consumer. Having multiple consumers is considered as an error, and is reported at deployment time. The Broadcast annotation changes this behavior and indicates that messages transiting in the channel are dispatched to all the consumers. @Broadcast must be used with the @Outgoing annotation: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Broadcast public int increment ( int i ) { return i + 1 ; } @Incoming ( \"out\" ) public void consume1 ( int i ) { //... } @Incoming ( \"out\" ) public void consume2 ( int i ) { //... } In the previous example, both consumers get the messages. You can also control the number of consumers to wait before starting to dispatch the messages. This allows waiting for the complete graph to be woven: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) @Broadcast ( 2 ) public int increment ( int i ) { return i + 1 ; } @Incoming ( \"out\" ) public void consume1 ( int i ) { //... } @Incoming ( \"out\" ) public void consume2 ( int i ) { //... } Note Inbound connectors also support a broadcast attribute that allows broadcasting the messages to multiple downstream subscribers.","title":"Broadcast"},{"location":"concepts/broadcast/#use-with-emitter","text":"For details on how to use @Broadcast with Emitter see the documentation .","title":"Use with Emitter"},{"location":"concepts/concepts/","text":"When dealing with event-driven or data streaming applications, there are a few concepts and vocabulary to introduce. Messages, Payload, Metadata A Message is an envelope around a payload . Your application is going to receive, process, and send Messages . Your application\u2019s logic can generate these Messages or receive them from a message broker. They can also be consumed by your application or sent to a message broker. An application can receive a message, process it and send a resulting message In Reactive Messaging, Message are represented by the Message interface. Each Message contains a payload of type . This payload can be retrieved using message.getPayload() : 1 2 String payload = message . getPayload (); Optional < MyMetadata > metadata = message . getMetadata ( MyMetadata . class ); As you can see in the previous snippet, Messages can also have metadata . Metadata is a way to extend messages with additional data. It can be metadata related to the message broker (like KafkaMessageMetadata ), or contain operational data (such as tracing metadata), or business-related data. Note When retrieving metadata, you get an Optional as it may not be present. Tip Metadata is also used to influence the outbound dispatching (how the message will be sent to the broker). Channels and Streams Inside your application, Messages transit on channel . A channel is a virtual destination identified by a name. The application is a set of channels SmallRye Reactive Messaging connects the component to the channel they read and to the channel they populate. The resulting structure is a stream: Messages flow between components through channels. What about Reactive Streams? You may wonder why Reactive Messaging has Reactive in the name. The Messaging part is kind of obvious. The Reactive part comes from the streams that are created by binding components. These streams are Reactive Streams . They follow the subscription and request protocol and implement back-pressure. It also means that Connectors are intended to use non-blocking IO to interact with the various message brokers. Connectors Your application is interacting with messaging brokers or event backbone using connectors . A connector is a piece of code that connects to a broker and: subscribe/poll/receive messages from the broker and propagate them to the application send/write/dispatch messages provided by the application to the broker Connectors are configured to map incoming messages to a specific channel (consumed by the application) and collect outgoing messages sent to a specific channel. These collected messages are sent to the external broker. Connectors manages the communication between the application and the brokers Each connector is dedicated to a specific technology. For example, a Kafka Connector only deals with Kafka. You don\u2019t necessarily need a connector. When your application does not use connectors, everything happens in-memory , and the streams are created by chaining methods altogether. Each chain is still a reactive stream and enforces the back-pressure protocol. When you don\u2019t use connectors, you need to make sure the chain is complete, meaning it starts with a message source, and it ends with a sink. In other words, you need to generate messages from within the application (using a method with only @Outgoing , or an Emitter ) and consume the messages from within the application (using a method with only @Incoming or using an unmanaged stream).","title":"Introduction"},{"location":"concepts/concepts/#messages-payload-metadata","text":"A Message is an envelope around a payload . Your application is going to receive, process, and send Messages . Your application\u2019s logic can generate these Messages or receive them from a message broker. They can also be consumed by your application or sent to a message broker. An application can receive a message, process it and send a resulting message In Reactive Messaging, Message are represented by the Message interface. Each Message contains a payload of type . This payload can be retrieved using message.getPayload() : 1 2 String payload = message . getPayload (); Optional < MyMetadata > metadata = message . getMetadata ( MyMetadata . class ); As you can see in the previous snippet, Messages can also have metadata . Metadata is a way to extend messages with additional data. It can be metadata related to the message broker (like KafkaMessageMetadata ), or contain operational data (such as tracing metadata), or business-related data. Note When retrieving metadata, you get an Optional as it may not be present. Tip Metadata is also used to influence the outbound dispatching (how the message will be sent to the broker).","title":"Messages, Payload, Metadata"},{"location":"concepts/concepts/#channels-and-streams","text":"Inside your application, Messages transit on channel . A channel is a virtual destination identified by a name. The application is a set of channels SmallRye Reactive Messaging connects the component to the channel they read and to the channel they populate. The resulting structure is a stream: Messages flow between components through channels. What about Reactive Streams? You may wonder why Reactive Messaging has Reactive in the name. The Messaging part is kind of obvious. The Reactive part comes from the streams that are created by binding components. These streams are Reactive Streams . They follow the subscription and request protocol and implement back-pressure. It also means that Connectors are intended to use non-blocking IO to interact with the various message brokers.","title":"Channels and Streams"},{"location":"concepts/concepts/#connectors","text":"Your application is interacting with messaging brokers or event backbone using connectors . A connector is a piece of code that connects to a broker and: subscribe/poll/receive messages from the broker and propagate them to the application send/write/dispatch messages provided by the application to the broker Connectors are configured to map incoming messages to a specific channel (consumed by the application) and collect outgoing messages sent to a specific channel. These collected messages are sent to the external broker. Connectors manages the communication between the application and the brokers Each connector is dedicated to a specific technology. For example, a Kafka Connector only deals with Kafka. You don\u2019t necessarily need a connector. When your application does not use connectors, everything happens in-memory , and the streams are created by chaining methods altogether. Each chain is still a reactive stream and enforces the back-pressure protocol. When you don\u2019t use connectors, you need to make sure the chain is complete, meaning it starts with a message source, and it ends with a sink. In other words, you need to generate messages from within the application (using a method with only @Outgoing , or an Emitter ) and consume the messages from within the application (using a method with only @Incoming or using an unmanaged stream).","title":"Connectors"},{"location":"concepts/connectors/","text":"Connectors Reactive Messaging can handle messages generated from within the application but also interact with remote brokers . Reactive Messaging Connectors interacts with these remote brokers to retrieve messages and send messages using various protocols and technology. Each connector handles to a specific technology. For example, a Kafka Connector is responsible for interacting with Kafka, while an MQTT Connector is responsible for MQTT interactions. Connector name Each connector has a name. This name is referenced by the application to indicate that this connector manages a specific channel. For example, the SmallRye Kafka Connector is named: smallrye-kafka . Inbound and Outbound connectors Connector can: retrieve messages from a remote broker (inbound) send messages to a remote broker (outbound) A connector can, of course, implement both directions. Inbound connectors are responsible for: Getting messages from the remote broker, Creating a Reactive Messaging Message associated with the retrieved message. Potentially associating technical metadata with the message. It includes unmarshalling the payload. Associating an acknowledgment callback to acknowledge the incoming message when the Reactive Messaging message is processed/acknowledged. Reactive matters The first step should follow the reactive streams principle: uses non-blocking technology, respects downstream requests. Outbound connectors are responsible for: Receiving Reactive Messaging Message and transform it into a structure understood by the remote broker. It includes marshaling the payload. If the Message contains outbound metadata (metadata set during the processing to influence the outbound structure and routing), taking them into account. Sending the message to the remote broker. Acknowledging the Reactive Messaging Message when the broker has accepted/acknowledged the message. Configuring connectors Applications need to configure the connector used by expressing which channel is managed by which connector. Non-mapped channels are local / in-memory. To configure connectors, you need to have an implementation of MicroProfile Config. If you don\u2019t have one, add an implementation of MicroProfile Config in your classpath , such as: 1 2 3 4 5 io.smallrye.config smallrye-config 2.11.1 Then edit the application configuration, generally src/main/resources/META-INF/microprofile-config.properties . The application configures the connector with a set of properties structured as follows: 1 mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value] For example: 1 2 3 4 mp.messaging.incoming.dummy-incoming-channel.connector=dummy mp.messaging.incoming.dummy-incoming-channel.attribute=value mp.messaging.outgoing.dummy-outgoing-channel.connector=dummy mp.messaging.outgoing.dummy-outgoing-channel.attribute=value You configure each channel (both incoming and outgoing) individually. The [incoming|outgoing] segment indicates the direction. an incoming channel consumes data from a message broker or something producing data. It\u2019s an inbound interaction. It relates to methods annotated with an @Incoming using the same channel name. an outgoing consumes data from the application and forwards it to a message broker or something consuming data. It\u2019s an outbound interaction. It relates to methods annotated with an @Outgoing using the same channel name. The [channel-name] is the name of the channel. If the channel name contains a . (dot), you would need to use \" (double-quote) around it. For example, to configure the dummy.incoming.channel channel, you would need: 1 2 mp.messaging.incoming.\"dummy.incoming.channel\".connector=dummy mp.messaging.incoming.\"dummy.incoming.channel\".attribute=value The [attribute]=[value] sets a specific connector attribute to the given value. Attributes depend on the used connector. So, refer to the connector documentation to check the supported attributes. The connector attribute must be set for each mapped channel and indicates the name of the connector responsible for the channel. Here is an example of a channel using an MQTT connector, consuming data from a MQTT broker, and a channel using a Kafka connector (writing data to Kafka): 1 2 3 4 5 6 7 8 9 10 11 12 # Configure the incoming health channel mp.messaging.incoming.health.topic = neo mp.messaging.incoming.health.connector = smallrye-mqtt mp.messaging.incoming.health.host = localhost mp.messaging.incoming.health.broadcast = true # Configure outgoing data channel mp.messaging.outgoing.data.connector = smallrye-kafka mp.messaging.outgoing.data.bootstrap.servers = localhost:9092 mp.messaging.outgoing.data.key.serializer = org.apache.kafka.common.serialization.StringSerializer mp.messaging.outgoing.data.value.serializer = io.vertx.kafka.client.serialization.JsonObjectSerializer mp.messaging.outgoing.data.acks = 1 Important To use a connector, you need to add it to your CLASSPATH . Generally, adding the dependency to your project is enough. Then, you need to know the connector\u2019s name and set the connector attribute for each channel managed by this connector. Connector attribute table In the connector documentation, you will find a table listing the attribute supported by the connector. Be aware that attributes for inbound and outbound interactions may be different. These tables contain the following entries: The name of the attribute, and potentially an alias . The name of the attribute is used with the mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value] syntax (the attribute segment). The alias (if set) is the name of a global MicroProfile Config property that avoids having to configure the attribute for each managed channel. For example, to set the location of your Kafka broker globally, you can use the kafka.bootstrap.servers alias. The description of the attribute, including the type. Whether that attribute is mandatory. If so, it fails the deployment if not set The default value, if any.","title":"Connectors"},{"location":"concepts/connectors/#connectors","text":"Reactive Messaging can handle messages generated from within the application but also interact with remote brokers . Reactive Messaging Connectors interacts with these remote brokers to retrieve messages and send messages using various protocols and technology. Each connector handles to a specific technology. For example, a Kafka Connector is responsible for interacting with Kafka, while an MQTT Connector is responsible for MQTT interactions.","title":"Connectors"},{"location":"concepts/connectors/#connector-name","text":"Each connector has a name. This name is referenced by the application to indicate that this connector manages a specific channel. For example, the SmallRye Kafka Connector is named: smallrye-kafka .","title":"Connector name"},{"location":"concepts/connectors/#inbound-and-outbound-connectors","text":"Connector can: retrieve messages from a remote broker (inbound) send messages to a remote broker (outbound) A connector can, of course, implement both directions. Inbound connectors are responsible for: Getting messages from the remote broker, Creating a Reactive Messaging Message associated with the retrieved message. Potentially associating technical metadata with the message. It includes unmarshalling the payload. Associating an acknowledgment callback to acknowledge the incoming message when the Reactive Messaging message is processed/acknowledged. Reactive matters The first step should follow the reactive streams principle: uses non-blocking technology, respects downstream requests. Outbound connectors are responsible for: Receiving Reactive Messaging Message and transform it into a structure understood by the remote broker. It includes marshaling the payload. If the Message contains outbound metadata (metadata set during the processing to influence the outbound structure and routing), taking them into account. Sending the message to the remote broker. Acknowledging the Reactive Messaging Message when the broker has accepted/acknowledged the message.","title":"Inbound and Outbound connectors"},{"location":"concepts/connectors/#configuring-connectors","text":"Applications need to configure the connector used by expressing which channel is managed by which connector. Non-mapped channels are local / in-memory. To configure connectors, you need to have an implementation of MicroProfile Config. If you don\u2019t have one, add an implementation of MicroProfile Config in your classpath , such as: 1 2 3 4 5 io.smallrye.config smallrye-config 2.11.1 Then edit the application configuration, generally src/main/resources/META-INF/microprofile-config.properties . The application configures the connector with a set of properties structured as follows: 1 mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value] For example: 1 2 3 4 mp.messaging.incoming.dummy-incoming-channel.connector=dummy mp.messaging.incoming.dummy-incoming-channel.attribute=value mp.messaging.outgoing.dummy-outgoing-channel.connector=dummy mp.messaging.outgoing.dummy-outgoing-channel.attribute=value You configure each channel (both incoming and outgoing) individually. The [incoming|outgoing] segment indicates the direction. an incoming channel consumes data from a message broker or something producing data. It\u2019s an inbound interaction. It relates to methods annotated with an @Incoming using the same channel name. an outgoing consumes data from the application and forwards it to a message broker or something consuming data. It\u2019s an outbound interaction. It relates to methods annotated with an @Outgoing using the same channel name. The [channel-name] is the name of the channel. If the channel name contains a . (dot), you would need to use \" (double-quote) around it. For example, to configure the dummy.incoming.channel channel, you would need: 1 2 mp.messaging.incoming.\"dummy.incoming.channel\".connector=dummy mp.messaging.incoming.\"dummy.incoming.channel\".attribute=value The [attribute]=[value] sets a specific connector attribute to the given value. Attributes depend on the used connector. So, refer to the connector documentation to check the supported attributes. The connector attribute must be set for each mapped channel and indicates the name of the connector responsible for the channel. Here is an example of a channel using an MQTT connector, consuming data from a MQTT broker, and a channel using a Kafka connector (writing data to Kafka): 1 2 3 4 5 6 7 8 9 10 11 12 # Configure the incoming health channel mp.messaging.incoming.health.topic = neo mp.messaging.incoming.health.connector = smallrye-mqtt mp.messaging.incoming.health.host = localhost mp.messaging.incoming.health.broadcast = true # Configure outgoing data channel mp.messaging.outgoing.data.connector = smallrye-kafka mp.messaging.outgoing.data.bootstrap.servers = localhost:9092 mp.messaging.outgoing.data.key.serializer = org.apache.kafka.common.serialization.StringSerializer mp.messaging.outgoing.data.value.serializer = io.vertx.kafka.client.serialization.JsonObjectSerializer mp.messaging.outgoing.data.acks = 1 Important To use a connector, you need to add it to your CLASSPATH . Generally, adding the dependency to your project is enough. Then, you need to know the connector\u2019s name and set the connector attribute for each channel managed by this connector.","title":"Configuring connectors"},{"location":"concepts/connectors/#connector-attribute-table","text":"In the connector documentation, you will find a table listing the attribute supported by the connector. Be aware that attributes for inbound and outbound interactions may be different. These tables contain the following entries: The name of the attribute, and potentially an alias . The name of the attribute is used with the mp.messaging.[incoming|outgoing].[channel-name].[attribute]=[value] syntax (the attribute segment). The alias (if set) is the name of a global MicroProfile Config property that avoids having to configure the attribute for each managed channel. For example, to set the location of your Kafka broker globally, you can use the kafka.bootstrap.servers alias. The description of the attribute, including the type. Whether that attribute is mandatory. If so, it fails the deployment if not set The default value, if any.","title":"Connector attribute table"},{"location":"concepts/converters/","text":"Message Converters SmallRye Reactive Messaging supports message converters , allowing to transform an incoming message into a version accepted by the method. If the incoming messages or payload does not match the invoked method\u2019s expectation, SmallRye Reactive Messaging looks for a suitable converter. If found, it converts the incoming message with this converter. Converters can have multiple purposes, but the main use case is about transforming the message\u2019s payload: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @ApplicationScoped public class MyConverter implements MessageConverter { @Override public boolean canConvert ( Message in , Type target ) { // Checks whether this converter can be used to convert // the incoming message into a message containing a payload // of the type `target`. return in . getPayload (). getClass (). equals ( String . class ) && target . equals ( Person . class ); } @Override public Message convert ( Message in , Type target ) { // Convert the incoming message into the new message. // It's important to build the new message **from** // the received one. return in . withPayload ( new Person (( String ) in . getPayload ())); } } To provide a converter, implement a bean exposing the MessageConverter interface. The canConvert method is called during the lookup and verifies if it can handle the conversion. The target type is the expected payload type. If the converter returns true to canConvert , SmallRye Reactive Messaging calls the convert method to proceed to the conversion. The previous converter can be used in application like the following, to convert Message to Message : 1 2 3 4 5 6 7 8 9 10 11 @Outgoing ( \"persons\" ) public Multi < String > source () { return Multi . createFrom (). items ( \"Neo\" , \"Morpheus\" , \"Trinity\" ); } // The messages need to be converted as they are emitted as Message // and consumed as Message @Incoming ( \"persons\" ) public void consume ( Person p ) { // ... } Converters work for all supported method signatures. However, the signature must be well-formed to allow the extraction of the expected payload type. Wildcards and raw types do not support conversion. If the expected payload type cannot be extracted, or no converter fits, the message is passed as received. If multiple suitable converters are present, implementations should override the getPriority method returning the priority. The default priority is 100 . The converter lookup invokes converters with higher priority (from the least value to the greatest) first.","title":"Message Converters"},{"location":"concepts/converters/#message-converters","text":"SmallRye Reactive Messaging supports message converters , allowing to transform an incoming message into a version accepted by the method. If the incoming messages or payload does not match the invoked method\u2019s expectation, SmallRye Reactive Messaging looks for a suitable converter. If found, it converts the incoming message with this converter. Converters can have multiple purposes, but the main use case is about transforming the message\u2019s payload: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @ApplicationScoped public class MyConverter implements MessageConverter { @Override public boolean canConvert ( Message in , Type target ) { // Checks whether this converter can be used to convert // the incoming message into a message containing a payload // of the type `target`. return in . getPayload (). getClass (). equals ( String . class ) && target . equals ( Person . class ); } @Override public Message convert ( Message in , Type target ) { // Convert the incoming message into the new message. // It's important to build the new message **from** // the received one. return in . withPayload ( new Person (( String ) in . getPayload ())); } } To provide a converter, implement a bean exposing the MessageConverter interface. The canConvert method is called during the lookup and verifies if it can handle the conversion. The target type is the expected payload type. If the converter returns true to canConvert , SmallRye Reactive Messaging calls the convert method to proceed to the conversion. The previous converter can be used in application like the following, to convert Message to Message : 1 2 3 4 5 6 7 8 9 10 11 @Outgoing ( \"persons\" ) public Multi < String > source () { return Multi . createFrom (). items ( \"Neo\" , \"Morpheus\" , \"Trinity\" ); } // The messages need to be converted as they are emitted as Message // and consumed as Message @Incoming ( \"persons\" ) public void consume ( Person p ) { // ... } Converters work for all supported method signatures. However, the signature must be well-formed to allow the extraction of the expected payload type. Wildcards and raw types do not support conversion. If the expected payload type cannot be extracted, or no converter fits, the message is passed as received. If multiple suitable converters are present, implementations should override the getPriority method returning the priority. The default priority is 100 . The converter lookup invokes converters with higher priority (from the least value to the greatest) first.","title":"Message Converters"},{"location":"concepts/decorators/","text":"Channel Decorators SmallRye Reactive Messaging supports decorating reactive streams of incoming and outgoing channels for implementing cross-cutting concerns such as monitoring, tracing or message interception. Two symmetrical APIs are proposed for decorating publisher and subscriber channels, PublisherDecorator and SubscriberDecorator respectively. Important @Incoming channels and channels bound to an outbound connector are both Subscriber s. Conversely @Outgoing channels and channels bound to an inbound connector are Publisher s. For example, to provide a decorator which counts consumed messages from incoming connector, implement a bean exposing the interface PublisherDecorator : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 @ApplicationScoped public class ConsumedMessageDecorator implements PublisherDecorator { private final Map < String , AtomicLong > counters = new HashMap <> (); @Override public Multi > decorate ( Multi > publisher , String channelName , boolean isConnector ) { if ( isConnector ) { AtomicLong counter = new AtomicLong (); counters . put ( channelName , counter ); return publisher . onItem (). invoke ( counter :: incrementAndGet ); } else { return publisher ; } } @Override public int getPriority () { return 10 ; } public long getMessageCount ( String channel ) { return counters . get ( channel ). get (); } } Decorators' decorate method is called only once per channel at application deployment when graph wiring is taking place. Decorators are very powerful because they receive the stream of messages (Mutiny Multi> ) and potentially return a new stream of messages. Note that if a decorator is available it will be called on every channel. The decorate method receives the channel name and whether the channel is a connector or not as parameters. Decorators are called ordered from highest to lowest priority (from the least value to the greatest), obtained using the javax.enterprise.inject.spi.Prioritized#getPriority method. Note The SubscriberDecorator receive a list of channel names because @Incoming annotation is repeatable and consuming methods can be linked to multiple channels. Intercepting Outgoing Messages Decorators can be used to intercept and alter messages, both on incoming and outgoing channels. Smallrye Reactive Messaging provides a SubscriberDecorator by default to allow intercepting outgoing messages for a specific channel. To provide an outgoing interceptor implement a bean exposing the interface OutgoingInterceptor , qualified with a @Identifier with the channel name to intercept. Only one interceptor is allowed to be bound for interception per outgoing channel. If no interceptors are found with a @Identifier but a @Default one is available, it is used. When multiple interceptors are available, the bean with the highest priority is used. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 package interceptors ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.OutgoingInterceptor ; import io.smallrye.reactive.messaging.OutgoingMessageMetadata ; @Identifier ( \"channel-a\" ) @ApplicationScoped public class MyInterceptor implements OutgoingInterceptor { @Override public Message onMessage ( Message message ) { return message . withPayload ( \"changed \" + message . getPayload ()); } @Override public void onMessageAck ( Message message ) { message . getMetadata ( OutgoingMessageMetadata . class ) . ifPresent ( m -> m . getResult ()); } @Override public void onMessageNack ( Message message , Throwable failure ) { } } An OutgoingInterceptor can implement these three methods: Message onMessage(Message message) : Called before passing the message to the outgoing connector for transmission. The message can be altered by returning a new message from this method. void onMessageAck(Message message) : Called after message acknowledgment. This callback can access OutgoingMessageMetadata which will hold the result of the message transmission to the broker, if supported by the connector. This is only supported by MQTT and Kafka connectors. void onMessageNack(Message message, Throwable failure) : Called before message negative-acknowledgment. Note If you are willing to adapt an incoming message payload to fit a consuming method receiving type, you can use MessageConverter s.","title":"Channel Decorators"},{"location":"concepts/decorators/#channel-decorators","text":"SmallRye Reactive Messaging supports decorating reactive streams of incoming and outgoing channels for implementing cross-cutting concerns such as monitoring, tracing or message interception. Two symmetrical APIs are proposed for decorating publisher and subscriber channels, PublisherDecorator and SubscriberDecorator respectively. Important @Incoming channels and channels bound to an outbound connector are both Subscriber s. Conversely @Outgoing channels and channels bound to an inbound connector are Publisher s. For example, to provide a decorator which counts consumed messages from incoming connector, implement a bean exposing the interface PublisherDecorator : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 @ApplicationScoped public class ConsumedMessageDecorator implements PublisherDecorator { private final Map < String , AtomicLong > counters = new HashMap <> (); @Override public Multi > decorate ( Multi > publisher , String channelName , boolean isConnector ) { if ( isConnector ) { AtomicLong counter = new AtomicLong (); counters . put ( channelName , counter ); return publisher . onItem (). invoke ( counter :: incrementAndGet ); } else { return publisher ; } } @Override public int getPriority () { return 10 ; } public long getMessageCount ( String channel ) { return counters . get ( channel ). get (); } } Decorators' decorate method is called only once per channel at application deployment when graph wiring is taking place. Decorators are very powerful because they receive the stream of messages (Mutiny Multi> ) and potentially return a new stream of messages. Note that if a decorator is available it will be called on every channel. The decorate method receives the channel name and whether the channel is a connector or not as parameters. Decorators are called ordered from highest to lowest priority (from the least value to the greatest), obtained using the javax.enterprise.inject.spi.Prioritized#getPriority method. Note The SubscriberDecorator receive a list of channel names because @Incoming annotation is repeatable and consuming methods can be linked to multiple channels.","title":"Channel Decorators"},{"location":"concepts/decorators/#intercepting-outgoing-messages","text":"Decorators can be used to intercept and alter messages, both on incoming and outgoing channels. Smallrye Reactive Messaging provides a SubscriberDecorator by default to allow intercepting outgoing messages for a specific channel. To provide an outgoing interceptor implement a bean exposing the interface OutgoingInterceptor , qualified with a @Identifier with the channel name to intercept. Only one interceptor is allowed to be bound for interception per outgoing channel. If no interceptors are found with a @Identifier but a @Default one is available, it is used. When multiple interceptors are available, the bean with the highest priority is used. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 package interceptors ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.OutgoingInterceptor ; import io.smallrye.reactive.messaging.OutgoingMessageMetadata ; @Identifier ( \"channel-a\" ) @ApplicationScoped public class MyInterceptor implements OutgoingInterceptor { @Override public Message onMessage ( Message message ) { return message . withPayload ( \"changed \" + message . getPayload ()); } @Override public void onMessageAck ( Message message ) { message . getMetadata ( OutgoingMessageMetadata . class ) . ifPresent ( m -> m . getResult ()); } @Override public void onMessageNack ( Message message , Throwable failure ) { } } An OutgoingInterceptor can implement these three methods: Message onMessage(Message message) : Called before passing the message to the outgoing connector for transmission. The message can be altered by returning a new message from this method. void onMessageAck(Message message) : Called after message acknowledgment. This callback can access OutgoingMessageMetadata which will hold the result of the message transmission to the broker, if supported by the connector. This is only supported by MQTT and Kafka connectors. void onMessageNack(Message message, Throwable failure) : Called before message negative-acknowledgment. Note If you are willing to adapt an incoming message payload to fit a consuming method receiving type, you can use MessageConverter s.","title":"Intercepting Outgoing Messages"},{"location":"concepts/emitter/","text":"Emitter and Channels It is not rare to combine in a single application imperative parts (Jax-RS, regular CDI beans ) and reactive parts ( beans with @Incoming and @Outgoing annotations). In these case, it\u2019s often required to send messages from the imperative part to the reactive part. In other words, send messages to channels handled by reactive messaging and how can you retrieve messages. Emitter and @Channel To send things (payload or Message ) from imperative code to a specific channel you need to use: the org.eclipse.microprofile.reactive.messaging.Channel annotations the org.eclipse.microprofile.reactive.messaging.Emitter type The @Channel lets you indicate to which channel you are going to send your payloads or messages. The Emitter is the object to use to send these payloads or messages. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 import org.eclipse.microprofile.reactive.messaging.Channel ; import org.eclipse.microprofile.reactive.messaging.Emitter ; @ApplicationScoped public class MyImperativeBean { @Inject @Channel ( \"prices\" ) Emitter < Double > emitter ; // ... public void send ( double d ) { emitter . send ( d ); } } The Emitter class takes a type parameter. It\u2019s the type of payload. Even if you want to send Messages , the type is the payload type. Important You must have a @Incoming(\"prices\") somewhere in your application (meaning a method consuming messages transiting on the channel prices ), or an outbound connector configured to manage the prices channel ( mp.messaging.outgoing.prices... ) Sending payloads Sending payloads is done as follows: 1 2 3 4 5 6 7 @Inject @Channel ( \"prices\" ) Emitter < Double > emitterForPrices ; public void send ( double d ) { emitterForPrices . send ( d ); } When sending a payload, the emitter returns a CompletionStage . This CompletionStage gets completed once the message created from the payload is acknowledged: 1 2 3 4 5 6 public void sendAndAwaitAcknowledgement ( double d ) { CompletionStage < Void > acked = emitterForPrices . send ( d ); // sending a payload returns a CompletionStage completed // when the message is acknowledged acked . toCompletableFuture (). join (); } If the processing fails, the CompletionStage gets completed exceptionally (with the reason of the nack). Sending messages You can also send Messages : 1 2 3 public void sendAsMessage ( double d ) { emitterForPrices . send ( Message . of ( d )); } When sending a Message , the emitter does not return a CompletionStage , but you can pass the ack/nack callback, and be called when the message is acked/nacked. 1 2 3 4 5 6 7 8 9 10 public void sendAsMessageWithAck ( double d ) { emitterForPrices . send ( Message . of ( d , () -> { // Called when the message is acknowledged. return CompletableFuture . completedFuture ( null ); }, reason -> { // Called when the message is acknowledged negatively. return CompletableFuture . completedFuture ( null ); })); } Sending messages also let you pass metadata. 1 2 3 4 5 6 7 8 9 10 11 12 public void sendAsMessageWithAckAndMetadata ( double d ) { MyMetadata metadata = new MyMetadata (); emitterForPrices . send ( Message . of ( d , Metadata . of ( metadata ), () -> { // Called when the message is acknowledged. return CompletableFuture . completedFuture ( null ); }, reason -> { // Called when the message is acknowledged negatively. return CompletableFuture . completedFuture ( null ); })); } Metadata can be used to propagate some context objects with the message. Overflow management When sending messages from imperative code to reactive code, you must be aware of back-pressure. Indeed, messages sent using the emitter and stored in a queue . If the consumer does not process the messages quickly enough, this queue can become a memory hog and you may even run out of memory. To control what need to happen when the queue becomes out of control, use the OnOverflow annotation. @OnOverflow lets you configure: the maximum size of the queue (default is 256) what needs to happen when this size is reached (fail, drop...) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // Set the max size to 10 and fail if reached @OnOverflow ( value = OnOverflow . Strategy . BUFFER , bufferSize = 10 ) @Inject @Channel ( \"channel\" ) Emitter < String > emitterWithBuffer ; // [DANGER ZONE] no limit @OnOverflow ( OnOverflow . Strategy . UNBOUNDED_BUFFER ) @Inject @Channel ( \"channel\" ) Emitter < String > danger ; // Drop the new messages if the size is reached @OnOverflow ( OnOverflow . Strategy . DROP ) @Inject @Channel ( \"channel\" ) Emitter < String > dropping ; // Drop the previously sent messages if the size is reached @OnOverflow ( OnOverflow . Strategy . LATEST ) @Inject @Channel ( \"channel\" ) Emitter < String > dropOldMessages ; The supported strategies are: OnOverflow.Strategy.BUFFER - use a buffer to store the elements until they are consumed. If the buffer is full, a failure is propagated (and the thread using the emitted gets an exception) OnOverflow.Strategy.UNBOUNDED_BUFFER - use an unbounded buffer to store the elements OnOverflow.Strategy.DROP - drops the most recent value if the downstream can\u2019t keep up. It means that new value emitted by the emitter are ignored. OnOverflow.Strategy.FAIL - propagates a failure in case the downstream can\u2019t keep up. OnOverflow.Strategy.LATEST - keeps only the latest value, dropping any previous value if the downstream can\u2019t keep up. OnOverflow.Strategy.NONE - ignore the back-pressure signals letting the downstream consumer to implement a strategy. Defensive emission Having an emitter injected into your code does not guarantee that someone is ready to consume the message. For example, a subscriber may be connecting to a remote broker. If there are no subscribers, using the send method will throw an exception. The emitter.hasRequests() method indicates that a subscriber subscribes to the channel and requested items. So, you can wrap your emission with: 1 2 3 if ( emitter . hasRequests ()) { emitter . send ( \"hello\" ); } If you use the OnOverflow.Strategy.DROP , you can use the send method even with no subscribers nor demands. The message will be nacked immediately. Retrieving channels You can use the @Channel annotation to inject in your bean the underlying stream. Note that in this case, you will be responsible for the subscription: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Inject @Channel ( \"my-channel\" ) Multi < String > streamOfPayloads ; @Inject @Channel ( \"my-channel\" ) Multi < Message < String >> streamOfMessages ; @Inject @Channel ( \"my-channel\" ) Publisher < String > publisherOfPayloads ; @Inject @Channel ( \"my-channel\" ) Publisher < Message < String >> publisherOfMessages ; Important You must have a @Outgoing(\"my-channel\") somewhere in your application (meaning a method generating messages transiting on the channel my-channel ), or an inbound connector configured to manage the prices channel ( mp.messaging.incoming.prices... ) Injected channels merge all the matching outgoing - so if you have multiple @Outgoing(\"out\") , @Inject @Channel(\"out\") gets all the messages. If your injected channel receives payloads ( Multi ), it acknowledges the message automatically, and support multiple subscribers. If you injected channel receives Message ( Multi> ), you will be responsible for the acknowledgement and broadcasting. Emitter and @Broadcast When using an Emitter , you can now @Broadcast what is emitted to all subscribers. Here is an example of emitting a price with two methods marked @Incoming to receive the broadcast: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 @Inject @Broadcast @Channel ( \"prices\" ) Emitter < Double > emitter ; public void emit ( double d ) { emitter . send ( d ); } @Incoming ( \"prices\" ) public void handle ( double d ) { // Handle the new price } @Incoming ( \"prices\" ) public void audit ( double d ) { // Audit the price change } For more details see @Broadcast documentation. Mutiny Emitter If you prefer to utilize Uni in all your code, there is now a MutinyEmitter that will return Uni instead of void . 1 2 3 4 5 6 7 @Inject @Channel ( \"prices\" ) MutinyEmitter < Double > emitter ; public Uni < Void > send ( double d ) { return emitter . send ( d ); } There\u2019s also the ability to block on sending the event to the emitter. It will only return from the method when the event is acknowledged, or nacked, by the receiver: 1 2 3 public void sendAwait ( double d ) { emitter . sendAndAwait ( d ); } And if you don\u2019t need to worry about the success or failure of sending an event, you can sendAndForget : 1 2 3 public Cancellable sendForget ( double d ) { return emitter . sendAndForget ( d ); } Custom Emitter Implementations Experimental Custom emitter implementations is an experimental feature. Emitter and MutinyEmitter are two implementations of the emitter concept, where imperative code in your application can send messages to Reactive Messaging channels. With EmitterFactory it is possible to provide custom implementations, and application facing emitter interfaces. In the following example, the injectable custom emitter interface is CustomEmitter , and it is implemented by CustomEmitterImpl : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 public interface CustomEmitter < T > extends EmitterType { < M extends Message > void sendAndForget ( M msg ); } public static class CustomEmitterImpl < T > implements CustomEmitter < T > , MessagePublisherProvider < Object > { Publisher < Message > publisher ; public CustomEmitterImpl ( EmitterConfiguration configuration , long defaultBufferSize ) { //... initialize emitter with configuration } @Override public Publisher < Message > getPublisher () { return publisher ; } @Override public < M extends Message > void sendAndForget ( M msg ) { //... send to stream } } Note that CustomEmitter interface extends EmitterType , which is a marker interface for discovering custom emitter types. Also, CustomEmitterImpl implements the MessagePublisherProvider , which is used by the framework to transform this emitter to a channel. Then we need to provide an implementation of the EmitterFactory interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @EmitterFactoryFor ( CustomEmitter . class ) @ApplicationScoped public static class CustomEmitterFactory implements EmitterFactory < CustomEmitterImpl < Object >> { @Inject ChannelRegistry channelRegistry ; @Override public CustomEmitterImpl < Object > createEmitter ( EmitterConfiguration configuration , long defaultBufferSize ) { return new CustomEmitterImpl <> ( configuration , defaultBufferSize ); } @Produces @Channel ( \"\" ) // Stream name is ignored during type-safe resolution < T > CustomEmitter < T > produce ( InjectionPoint injectionPoint ) { String channelName = ChannelProducer . getChannelName ( injectionPoint ); return channelRegistry . getEmitter ( channelName , CustomEmitter . class ); } } The CustomEmitterFactory is a CDI managed bean, which implements the EmitterFactory . It is qualified with EmitterFactoryFor annotation which is configured with the emitter interface CustomEmitter that this factory provides. Smallrye Reactive Messaging discovers the emitter factory during the CDI deployment validation and verifies that custom emitters used by the application have corresponding emitter factories. It'll use the emitter factory to create the emitter implementation and will register the implementation into the ChannelRegistry . Note that the CustomEmitterFactory also uses the ChannelRegistry and provides the custom emitter with @Produces . Finally, the application can inject and use the CustomEmitter as a normal emitter channel: 1 2 3 4 5 6 7 8 9 10 11 @Inject @Channel ( \"custom-emitter-channel\" ) CustomEmitter < String > customEmitter ; //... public void emitMessage () { customEmitter . sendAndForget ( Message . of ( \"a\" )); customEmitter . sendAndForget ( Message . of ( \"b\" )); customEmitter . sendAndForget ( Message . of ( \"c\" )); }","title":"Emitters and Channel"},{"location":"concepts/emitter/#emitter-and-channels","text":"It is not rare to combine in a single application imperative parts (Jax-RS, regular CDI beans ) and reactive parts ( beans with @Incoming and @Outgoing annotations). In these case, it\u2019s often required to send messages from the imperative part to the reactive part. In other words, send messages to channels handled by reactive messaging and how can you retrieve messages.","title":"Emitter and Channels"},{"location":"concepts/emitter/#emitter-and-channel","text":"To send things (payload or Message ) from imperative code to a specific channel you need to use: the org.eclipse.microprofile.reactive.messaging.Channel annotations the org.eclipse.microprofile.reactive.messaging.Emitter type The @Channel lets you indicate to which channel you are going to send your payloads or messages. The Emitter is the object to use to send these payloads or messages. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 import org.eclipse.microprofile.reactive.messaging.Channel ; import org.eclipse.microprofile.reactive.messaging.Emitter ; @ApplicationScoped public class MyImperativeBean { @Inject @Channel ( \"prices\" ) Emitter < Double > emitter ; // ... public void send ( double d ) { emitter . send ( d ); } } The Emitter class takes a type parameter. It\u2019s the type of payload. Even if you want to send Messages , the type is the payload type. Important You must have a @Incoming(\"prices\") somewhere in your application (meaning a method consuming messages transiting on the channel prices ), or an outbound connector configured to manage the prices channel ( mp.messaging.outgoing.prices... )","title":"Emitter and @Channel"},{"location":"concepts/emitter/#sending-payloads","text":"Sending payloads is done as follows: 1 2 3 4 5 6 7 @Inject @Channel ( \"prices\" ) Emitter < Double > emitterForPrices ; public void send ( double d ) { emitterForPrices . send ( d ); } When sending a payload, the emitter returns a CompletionStage . This CompletionStage gets completed once the message created from the payload is acknowledged: 1 2 3 4 5 6 public void sendAndAwaitAcknowledgement ( double d ) { CompletionStage < Void > acked = emitterForPrices . send ( d ); // sending a payload returns a CompletionStage completed // when the message is acknowledged acked . toCompletableFuture (). join (); } If the processing fails, the CompletionStage gets completed exceptionally (with the reason of the nack).","title":"Sending payloads"},{"location":"concepts/emitter/#sending-messages","text":"You can also send Messages : 1 2 3 public void sendAsMessage ( double d ) { emitterForPrices . send ( Message . of ( d )); } When sending a Message , the emitter does not return a CompletionStage , but you can pass the ack/nack callback, and be called when the message is acked/nacked. 1 2 3 4 5 6 7 8 9 10 public void sendAsMessageWithAck ( double d ) { emitterForPrices . send ( Message . of ( d , () -> { // Called when the message is acknowledged. return CompletableFuture . completedFuture ( null ); }, reason -> { // Called when the message is acknowledged negatively. return CompletableFuture . completedFuture ( null ); })); } Sending messages also let you pass metadata. 1 2 3 4 5 6 7 8 9 10 11 12 public void sendAsMessageWithAckAndMetadata ( double d ) { MyMetadata metadata = new MyMetadata (); emitterForPrices . send ( Message . of ( d , Metadata . of ( metadata ), () -> { // Called when the message is acknowledged. return CompletableFuture . completedFuture ( null ); }, reason -> { // Called when the message is acknowledged negatively. return CompletableFuture . completedFuture ( null ); })); } Metadata can be used to propagate some context objects with the message.","title":"Sending messages"},{"location":"concepts/emitter/#overflow-management","text":"When sending messages from imperative code to reactive code, you must be aware of back-pressure. Indeed, messages sent using the emitter and stored in a queue . If the consumer does not process the messages quickly enough, this queue can become a memory hog and you may even run out of memory. To control what need to happen when the queue becomes out of control, use the OnOverflow annotation. @OnOverflow lets you configure: the maximum size of the queue (default is 256) what needs to happen when this size is reached (fail, drop...) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // Set the max size to 10 and fail if reached @OnOverflow ( value = OnOverflow . Strategy . BUFFER , bufferSize = 10 ) @Inject @Channel ( \"channel\" ) Emitter < String > emitterWithBuffer ; // [DANGER ZONE] no limit @OnOverflow ( OnOverflow . Strategy . UNBOUNDED_BUFFER ) @Inject @Channel ( \"channel\" ) Emitter < String > danger ; // Drop the new messages if the size is reached @OnOverflow ( OnOverflow . Strategy . DROP ) @Inject @Channel ( \"channel\" ) Emitter < String > dropping ; // Drop the previously sent messages if the size is reached @OnOverflow ( OnOverflow . Strategy . LATEST ) @Inject @Channel ( \"channel\" ) Emitter < String > dropOldMessages ; The supported strategies are: OnOverflow.Strategy.BUFFER - use a buffer to store the elements until they are consumed. If the buffer is full, a failure is propagated (and the thread using the emitted gets an exception) OnOverflow.Strategy.UNBOUNDED_BUFFER - use an unbounded buffer to store the elements OnOverflow.Strategy.DROP - drops the most recent value if the downstream can\u2019t keep up. It means that new value emitted by the emitter are ignored. OnOverflow.Strategy.FAIL - propagates a failure in case the downstream can\u2019t keep up. OnOverflow.Strategy.LATEST - keeps only the latest value, dropping any previous value if the downstream can\u2019t keep up. OnOverflow.Strategy.NONE - ignore the back-pressure signals letting the downstream consumer to implement a strategy.","title":"Overflow management"},{"location":"concepts/emitter/#defensive-emission","text":"Having an emitter injected into your code does not guarantee that someone is ready to consume the message. For example, a subscriber may be connecting to a remote broker. If there are no subscribers, using the send method will throw an exception. The emitter.hasRequests() method indicates that a subscriber subscribes to the channel and requested items. So, you can wrap your emission with: 1 2 3 if ( emitter . hasRequests ()) { emitter . send ( \"hello\" ); } If you use the OnOverflow.Strategy.DROP , you can use the send method even with no subscribers nor demands. The message will be nacked immediately.","title":"Defensive emission"},{"location":"concepts/emitter/#retrieving-channels","text":"You can use the @Channel annotation to inject in your bean the underlying stream. Note that in this case, you will be responsible for the subscription: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Inject @Channel ( \"my-channel\" ) Multi < String > streamOfPayloads ; @Inject @Channel ( \"my-channel\" ) Multi < Message < String >> streamOfMessages ; @Inject @Channel ( \"my-channel\" ) Publisher < String > publisherOfPayloads ; @Inject @Channel ( \"my-channel\" ) Publisher < Message < String >> publisherOfMessages ; Important You must have a @Outgoing(\"my-channel\") somewhere in your application (meaning a method generating messages transiting on the channel my-channel ), or an inbound connector configured to manage the prices channel ( mp.messaging.incoming.prices... ) Injected channels merge all the matching outgoing - so if you have multiple @Outgoing(\"out\") , @Inject @Channel(\"out\") gets all the messages. If your injected channel receives payloads ( Multi ), it acknowledges the message automatically, and support multiple subscribers. If you injected channel receives Message ( Multi> ), you will be responsible for the acknowledgement and broadcasting.","title":"Retrieving channels"},{"location":"concepts/emitter/#emitter-and-broadcast","text":"When using an Emitter , you can now @Broadcast what is emitted to all subscribers. Here is an example of emitting a price with two methods marked @Incoming to receive the broadcast: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 @Inject @Broadcast @Channel ( \"prices\" ) Emitter < Double > emitter ; public void emit ( double d ) { emitter . send ( d ); } @Incoming ( \"prices\" ) public void handle ( double d ) { // Handle the new price } @Incoming ( \"prices\" ) public void audit ( double d ) { // Audit the price change } For more details see @Broadcast documentation.","title":"Emitter and @Broadcast"},{"location":"concepts/emitter/#mutiny-emitter","text":"If you prefer to utilize Uni in all your code, there is now a MutinyEmitter that will return Uni instead of void . 1 2 3 4 5 6 7 @Inject @Channel ( \"prices\" ) MutinyEmitter < Double > emitter ; public Uni < Void > send ( double d ) { return emitter . send ( d ); } There\u2019s also the ability to block on sending the event to the emitter. It will only return from the method when the event is acknowledged, or nacked, by the receiver: 1 2 3 public void sendAwait ( double d ) { emitter . sendAndAwait ( d ); } And if you don\u2019t need to worry about the success or failure of sending an event, you can sendAndForget : 1 2 3 public Cancellable sendForget ( double d ) { return emitter . sendAndForget ( d ); }","title":"Mutiny Emitter"},{"location":"concepts/emitter/#custom-emitter-implementations","text":"Experimental Custom emitter implementations is an experimental feature. Emitter and MutinyEmitter are two implementations of the emitter concept, where imperative code in your application can send messages to Reactive Messaging channels. With EmitterFactory it is possible to provide custom implementations, and application facing emitter interfaces. In the following example, the injectable custom emitter interface is CustomEmitter , and it is implemented by CustomEmitterImpl : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 public interface CustomEmitter < T > extends EmitterType { < M extends Message > void sendAndForget ( M msg ); } public static class CustomEmitterImpl < T > implements CustomEmitter < T > , MessagePublisherProvider < Object > { Publisher < Message > publisher ; public CustomEmitterImpl ( EmitterConfiguration configuration , long defaultBufferSize ) { //... initialize emitter with configuration } @Override public Publisher < Message > getPublisher () { return publisher ; } @Override public < M extends Message > void sendAndForget ( M msg ) { //... send to stream } } Note that CustomEmitter interface extends EmitterType , which is a marker interface for discovering custom emitter types. Also, CustomEmitterImpl implements the MessagePublisherProvider , which is used by the framework to transform this emitter to a channel. Then we need to provide an implementation of the EmitterFactory interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @EmitterFactoryFor ( CustomEmitter . class ) @ApplicationScoped public static class CustomEmitterFactory implements EmitterFactory < CustomEmitterImpl < Object >> { @Inject ChannelRegistry channelRegistry ; @Override public CustomEmitterImpl < Object > createEmitter ( EmitterConfiguration configuration , long defaultBufferSize ) { return new CustomEmitterImpl <> ( configuration , defaultBufferSize ); } @Produces @Channel ( \"\" ) // Stream name is ignored during type-safe resolution < T > CustomEmitter < T > produce ( InjectionPoint injectionPoint ) { String channelName = ChannelProducer . getChannelName ( injectionPoint ); return channelRegistry . getEmitter ( channelName , CustomEmitter . class ); } } The CustomEmitterFactory is a CDI managed bean, which implements the EmitterFactory . It is qualified with EmitterFactoryFor annotation which is configured with the emitter interface CustomEmitter that this factory provides. Smallrye Reactive Messaging discovers the emitter factory during the CDI deployment validation and verifies that custom emitters used by the application have corresponding emitter factories. It'll use the emitter factory to create the emitter implementation and will register the implementation into the ChannelRegistry . Note that the CustomEmitterFactory also uses the ChannelRegistry and provides the custom emitter with @Produces . Finally, the application can inject and use the CustomEmitter as a normal emitter channel: 1 2 3 4 5 6 7 8 9 10 11 @Inject @Channel ( \"custom-emitter-channel\" ) CustomEmitter < String > customEmitter ; //... public void emitMessage () { customEmitter . sendAndForget ( Message . of ( \"a\" )); customEmitter . sendAndForget ( Message . of ( \"b\" )); customEmitter . sendAndForget ( Message . of ( \"c\" )); }","title":"Custom Emitter Implementations"},{"location":"concepts/incomings/","text":"Multiple Incoming Channels Experimental Multiple @Incomings is an experimental feature. The @Incoming annotation is repeatable. It means that the method receives the messages transiting on every listed channels, in no specific order: 1 2 3 4 5 6 @Incoming ( \"channel-1\" ) @Incoming ( \"channel-2\" ) public String process ( String s ) { // get messages from channel-1 and channel-2 return s . toUpperCase (); }","title":"@Incomings"},{"location":"concepts/incomings/#multiple-incoming-channels","text":"Experimental Multiple @Incomings is an experimental feature. The @Incoming annotation is repeatable. It means that the method receives the messages transiting on every listed channels, in no specific order: 1 2 3 4 5 6 @Incoming ( \"channel-1\" ) @Incoming ( \"channel-2\" ) public String process ( String s ) { // get messages from channel-1 and channel-2 return s . toUpperCase (); }","title":"Multiple Incoming Channels"},{"location":"concepts/logging/","text":"Logging SmallRye Reactive Messaging uses JBoss Logging as logging API. This section explains how to configure the loggers for various logging backends. Tip If you are developing SmallRye Reactive Messaging and wonder about how the logs are managed, it uses JBoss Logging Tools . Logging Backends SmallRye Reactive Messaging uses the JBoss Logging library to write messages to a log file. This library is a logging bridge that integrates different log frameworks. You can decide which of the following frameworks you want to use for your application: JBoss LogManager ( jboss ) Log4j 2 ( log4j2 ) Log4j 1 ( log4j ) Slf4j ( slf4j ) JDK logging ( jul ) You only need to add the chosen framework to the classpath, and the JBoss Logging library will pick it up. If there are multiple frameworks available on the classpath, it picks the first found (in the order from the list). Alternatively, you can set the org.jboss.logging.provider system property is one of the values given above. The concepts and log categories are the same for all frameworks. However, the format of the configuration file and the names of the log levels differ. Check the documentation of your logging library to find out which dependencies are required, the exact name of the log levels, and where the configuration should be written. Log Categories As all applications and frameworks, SmallRye Reactive Messaging writes log messages in different categories and log levels. The categories group messages from specific connectors, classes or components. The following table shows the essential log categories used by SmallRye Reactive Messaging: Category Description io.smallrye.reactive.messaging This category contains all the messages written by SmallRye Reactive Messaging. io.smallrye.reactive.messaging.provider This category contains all the messages generated by the core (provider). io.smallrye.reactive.messaging.kafka This category contains all the messages generated by the Kafka Connector. io.smallrye.reactive.messaging.amqp This category contains all the messages generated by the AMQP Connector. io.smallrye.reactive.messaging.jms This category contains all the messages generated by the JMS Connector. io.smallrye.reactive.messaging.camel This category contains all the messages generated by the Camel Connector. io.smallrye.reactive.messaging.mqtt This category contains all the messages generated by the MQTT (Client) Connector. io.smallrye.reactive.messaging.mqtt-server This category contains all the messages generated by the MQTT (Server) Connector. The names of the log levels are defined by your logging framework and determine the amount and granularity of the log messages. You can assign a log level to each category. If you do not specify a specific category\u2019s log level, it will inherit the level from its parent category. Thus, setting the log level of io.smallrye.reactive.messaging influences every loggers from SmallRye Reactive Messaging. Message Code Each message has an identifier code. They are all prefixed with SRMSG , followed with the numeric code. In the following output, the code is SRMSG00229 : 1 [2020-06-15 13:35:07] [INFO ] SRMSG00229: Channel manager initializing... Recommended logging configurations Development Log4J 1 log4j.properties 1 2 3 4 5 6 7 8 log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.Target = System.out log4j.appender.stdout.layout = org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern = %d{HH:mm:ss,SSS} %-5p [%c] - %m%n log4j.rootLogger = info, stdout log4j.logger.io.smallrye.reactive.messaging = info log4j.logger.org.jboss.weld = warn Log4J 2 log4j2.xml 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 PropertiesConfiguration [%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n > JDK (JUL) logging.properties 1 2 3 4 5 6 7 8 9 handlers = java.util.logging.ConsoleHandler java.util.logging.ConsoleHandler.level = FINEST java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter java.util.logging.SimpleFormatter.format = [%1$tF %1$tT] [%4$-7s] %5$s %n .level = INFO io.smallrye.reactive.messaging.level = INFO org.jboss.weld.level = WARNING LogBack via SLF4J* logback.xml 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n Production Log4J 1 log4j.properties 1 2 3 4 5 6 7 8 log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.Target = System.out log4j.appender.stdout.layout = org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern = %d{HH:mm:ss,SSS} %-5p [%c] - %m%n log4j.rootLogger = info, stdout log4j.logger.io.smallrye.reactive.messaging = warn log4j.logger.org.jboss.weld = error Log4J 2 log4j2.xml 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 PropertiesConfiguration [%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n > JDK (JUL) logging.properties 1 2 3 4 5 6 7 8 9 handlers = java.util.logging.ConsoleHandler java.util.logging.ConsoleHandler.level = INFO java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter java.util.logging.SimpleFormatter.format = [%1$tF %1$tT] [%4$-7s] %5$s %n .level = INFO io.smallrye.reactive.messaging.level = WARNING org.jboss.weld.level = SEVERE logback.xml 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n ","title":"Logging"},{"location":"concepts/logging/#logging","text":"SmallRye Reactive Messaging uses JBoss Logging as logging API. This section explains how to configure the loggers for various logging backends. Tip If you are developing SmallRye Reactive Messaging and wonder about how the logs are managed, it uses JBoss Logging Tools .","title":"Logging"},{"location":"concepts/logging/#logging-backends","text":"SmallRye Reactive Messaging uses the JBoss Logging library to write messages to a log file. This library is a logging bridge that integrates different log frameworks. You can decide which of the following frameworks you want to use for your application: JBoss LogManager ( jboss ) Log4j 2 ( log4j2 ) Log4j 1 ( log4j ) Slf4j ( slf4j ) JDK logging ( jul ) You only need to add the chosen framework to the classpath, and the JBoss Logging library will pick it up. If there are multiple frameworks available on the classpath, it picks the first found (in the order from the list). Alternatively, you can set the org.jboss.logging.provider system property is one of the values given above. The concepts and log categories are the same for all frameworks. However, the format of the configuration file and the names of the log levels differ. Check the documentation of your logging library to find out which dependencies are required, the exact name of the log levels, and where the configuration should be written.","title":"Logging Backends"},{"location":"concepts/logging/#log-categories","text":"As all applications and frameworks, SmallRye Reactive Messaging writes log messages in different categories and log levels. The categories group messages from specific connectors, classes or components. The following table shows the essential log categories used by SmallRye Reactive Messaging: Category Description io.smallrye.reactive.messaging This category contains all the messages written by SmallRye Reactive Messaging. io.smallrye.reactive.messaging.provider This category contains all the messages generated by the core (provider). io.smallrye.reactive.messaging.kafka This category contains all the messages generated by the Kafka Connector. io.smallrye.reactive.messaging.amqp This category contains all the messages generated by the AMQP Connector. io.smallrye.reactive.messaging.jms This category contains all the messages generated by the JMS Connector. io.smallrye.reactive.messaging.camel This category contains all the messages generated by the Camel Connector. io.smallrye.reactive.messaging.mqtt This category contains all the messages generated by the MQTT (Client) Connector. io.smallrye.reactive.messaging.mqtt-server This category contains all the messages generated by the MQTT (Server) Connector. The names of the log levels are defined by your logging framework and determine the amount and granularity of the log messages. You can assign a log level to each category. If you do not specify a specific category\u2019s log level, it will inherit the level from its parent category. Thus, setting the log level of io.smallrye.reactive.messaging influences every loggers from SmallRye Reactive Messaging.","title":"Log Categories"},{"location":"concepts/logging/#message-code","text":"Each message has an identifier code. They are all prefixed with SRMSG , followed with the numeric code. In the following output, the code is SRMSG00229 : 1 [2020-06-15 13:35:07] [INFO ] SRMSG00229: Channel manager initializing...","title":"Message Code"},{"location":"concepts/logging/#recommended-logging-configurations","text":"","title":"Recommended logging configurations"},{"location":"concepts/logging/#development","text":"","title":"Development"},{"location":"concepts/logging/#production","text":"","title":"Production"},{"location":"concepts/merge/","text":"Merge channels Experimental @Merge is an experimental feature. By default, messages transiting in a channel can arise from a single producer. Having multiple producers is considered erroneous and is reported at deployment time. The Merge annotation changes this behavior and indicates that a channel can have multiple producers. @Merge must be used with the @Incoming annotation: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @Incoming ( \"in1\" ) @Outgoing ( \"out\" ) public int increment ( int i ) { return i + 1 ; } @Incoming ( \"in2\" ) @Outgoing ( \"out\" ) public int multiply ( int i ) { return i * 2 ; } @Incoming ( \"out\" ) @Merge public void getAll ( int i ) { //... } In the previous example, the consumer gets all the messages (from both producers). The @Merge annotation allows configuring how the incoming messages (from the different producers) are merged into the channel. The mode attribute allows configuring this behavior: ONE picks a single producer, discarding the other producer; MERGE (default) gets all the messages as they come, without any defined order. Messages from different producers may be interleaved. CONCAT concatenates the producers. The messages from one producer are received until the messages from other producers are received. Note Outbound connectors also support a merge attribute that allows consuming the messages to multiple upstreams. It will dispatch all the received messages.","title":"Merge channels"},{"location":"concepts/merge/#merge-channels","text":"Experimental @Merge is an experimental feature. By default, messages transiting in a channel can arise from a single producer. Having multiple producers is considered erroneous and is reported at deployment time. The Merge annotation changes this behavior and indicates that a channel can have multiple producers. @Merge must be used with the @Incoming annotation: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @Incoming ( \"in1\" ) @Outgoing ( \"out\" ) public int increment ( int i ) { return i + 1 ; } @Incoming ( \"in2\" ) @Outgoing ( \"out\" ) public int multiply ( int i ) { return i * 2 ; } @Incoming ( \"out\" ) @Merge public void getAll ( int i ) { //... } In the previous example, the consumer gets all the messages (from both producers). The @Merge annotation allows configuring how the incoming messages (from the different producers) are merged into the channel. The mode attribute allows configuring this behavior: ONE picks a single producer, discarding the other producer; MERGE (default) gets all the messages as they come, without any defined order. Messages from different producers may be interleaved. CONCAT concatenates the producers. The messages from one producer are received until the messages from other producers are received. Note Outbound connectors also support a merge attribute that allows consuming the messages to multiple upstreams. It will dispatch all the received messages.","title":"Merge channels"},{"location":"concepts/message-context/","text":"Message Contexts Message context provides a way to propagate data along the processing of a message. It can be used to propagate message specific objects in an implicit manner and be able to retrieve them later, such as the user, session or transaction. Important Message contexts are only support by Kafka, AMQP, RabbitMQ and MQTT connectors. Note Message context support is an experimental and SmallRye only feature. What's a message context A message context is execution context on which a message is processed. Each stage of the processing is going to use the same execution context. Thus, it allows storing data which can later be restored. For example, you can imagine storing some authentication ( User in the following example) data in one part of your processing and restore it in a later stage. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Incoming ( \"data\" ) @Outgoing ( \"process\" ) public Message < String > process ( Message < String > input ) { // Extract some data from the message and store it in the context User user = ...; // Store the extracted data into the message context. ContextLocals . put ( \"user\" , user ); record input ; } @Incoming ( \"process\" ) @Outgoing ( \"after-process\" ) public String handle ( String payload ) { // You can retrieve the store data using User user = ContextLocals . get ( \"user\" , null ); // ... return payload ; } The Message context is also available when using blocking or asynchronous stages (stage returning Uni or CompletionStage ) The difference with metadata Message metadata can be used to provide a similar feature. However, it requires using Messages which can be inconvenient (need to handle the acknowledgement manually). Message Contexts provide a simpler API, closer to a Message CDI scope : you can save data, and restore it later. The implicit propagation avoid having to deal with Messages . Supported signatures Message context works with: methods consuming or producing Messages , Uni> and CompletionStage> methods consuming or producing payloads, Uni and CompletionStage . blocking and non-blocking methods However, message context are NOT enforced when using methods consuming or producing: Multi , Publisher and PublisherBuilder Subscriber and SubscriberBuilder Processor and ProcessorBuilder Under the hood Under the hood, the message context feature uses Vert.x duplicated contexts . A duplicated context is a view of the \"root\" (event loop) context, which is restored at each stage of the message processing. Each time that a compatible connector receives a message from a broker, it creates a new duplicated context and attaches it to the message. So the context is stored in the metadata of the message. When the message is processed, SmallRye Reactive Messaging makes sure that this processing is executed on the stored duplicated context.","title":"Message Context"},{"location":"concepts/message-context/#message-contexts","text":"Message context provides a way to propagate data along the processing of a message. It can be used to propagate message specific objects in an implicit manner and be able to retrieve them later, such as the user, session or transaction. Important Message contexts are only support by Kafka, AMQP, RabbitMQ and MQTT connectors. Note Message context support is an experimental and SmallRye only feature.","title":"Message Contexts"},{"location":"concepts/message-context/#whats-a-message-context","text":"A message context is execution context on which a message is processed. Each stage of the processing is going to use the same execution context. Thus, it allows storing data which can later be restored. For example, you can imagine storing some authentication ( User in the following example) data in one part of your processing and restore it in a later stage. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Incoming ( \"data\" ) @Outgoing ( \"process\" ) public Message < String > process ( Message < String > input ) { // Extract some data from the message and store it in the context User user = ...; // Store the extracted data into the message context. ContextLocals . put ( \"user\" , user ); record input ; } @Incoming ( \"process\" ) @Outgoing ( \"after-process\" ) public String handle ( String payload ) { // You can retrieve the store data using User user = ContextLocals . get ( \"user\" , null ); // ... return payload ; } The Message context is also available when using blocking or asynchronous stages (stage returning Uni or CompletionStage )","title":"What's a message context"},{"location":"concepts/message-context/#the-difference-with-metadata","text":"Message metadata can be used to provide a similar feature. However, it requires using Messages which can be inconvenient (need to handle the acknowledgement manually). Message Contexts provide a simpler API, closer to a Message CDI scope : you can save data, and restore it later. The implicit propagation avoid having to deal with Messages .","title":"The difference with metadata"},{"location":"concepts/message-context/#supported-signatures","text":"Message context works with: methods consuming or producing Messages , Uni> and CompletionStage> methods consuming or producing payloads, Uni and CompletionStage . blocking and non-blocking methods However, message context are NOT enforced when using methods consuming or producing: Multi , Publisher and PublisherBuilder Subscriber and SubscriberBuilder Processor and ProcessorBuilder","title":"Supported signatures"},{"location":"concepts/message-context/#under-the-hood","text":"Under the hood, the message context feature uses Vert.x duplicated contexts . A duplicated context is a view of the \"root\" (event loop) context, which is restored at each stage of the message processing. Each time that a compatible connector receives a message from a broker, it creates a new duplicated context and attaches it to the message. So the context is stored in the metadata of the message. When the message is processed, SmallRye Reactive Messaging makes sure that this processing is executed on the stored duplicated context.","title":"Under the hood"},{"location":"concepts/model/","text":"Development Model Reactive Messaging proposes a CDI-based programming model to implement event-driven applications. Following the CDI principles, beans are forming the main building block of your application. Reactive Messaging provides a set of annotations and types to implement beans that generate, consume or process messages. @Incoming and @Outgoing Reactive Messaging provides two main annotations: org.eclipse.microprofile.reactive.messaging.Incoming - indicates the consumed channel org.eclipse.microprofile.reactive.messaging.Outgoing - indicates the populated channel These annotations are used on methods : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 package beans ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class MessageProcessingBean { @Incoming ( \"consumed-channel\" ) @Outgoing ( \"populated-channel\" ) public Message < String > process ( Message < String > in ) { // Process the payload String payload = in . getPayload (). toUpperCase (); // Create a new message from `in` and just update the payload return in . withPayload ( payload ); } } Note Reactive Messaging beans can either be in the application scope ( @ApplicationScoped ) or dependent scope ( @Dependent ). Manipulating messages can be cumbersome. When you are only interested in the payload, you can use the following syntax: The following code is equivalent to the snippet from above: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 package beans ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class PayloadProcessingBean { @Incoming ( \"consumed-channel\" ) @Outgoing ( \"populated-channel\" ) public String process ( String in ) { return in . toUpperCase (); } } Important You should not call methods annotated with @Incoming and/or @Outgoing directly from your code. They are invoked by the framework. Having user code invoking them would not have the expected outcome. SmallRye Reactive Messaging automatically binds matching @Outgoing to @Incoming to form a chain: A chain of components If we consider the following code: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Outgoing ( \"source\" ) public Multi < String > generate () { return Multi . createFrom (). items ( \"Hello\" , \"from\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"sink\" ) public String process ( String in ) { return in . toUpperCase (); } @Incoming ( \"sink\" ) public void consume ( String processed ) { System . out . println ( processed ); } It would generate the following chain: 1 generate --> [ source ] --> process --> [ sink ] --> consume Methods annotated with @Incoming or @Outgoing don\u2019t have to be in the same bean ( class ). You can distribute them among a set of beans. Remote interactions are also possible when using connectors. Methods annotated with: only @Outgoing are used to generate messages or payloads only @Incoming are used to consume messages or payloads both @Incoming and @Outgoing are used to process messages or payloads; or transform the stream Creating messages Messages are envelopes around payload. They are the vehicle. While manipulating payload is convenient, messages let you add metadata, handle acknowledgement... Creating Messages is done using the Message interface directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // Create a simple message wrapping a payload Message < Price > m1 = Message . of ( price ); // Create a message with metadata Message < Price > m2 = Message . of ( price , Metadata . of ( new PriceMetadata ())); // Create a message with several metadata Message < Price > m3 = Message . of ( price , Metadata . of ( new PriceMetadata (), new MyMetadata ())); // Create a message with an acknowledgement callback Message < Price > m4 = Message . of ( price , () -> { // Called when the message is acknowledged by the next consumer. return CompletableFuture . completedFuture ( null ); }); // Create a message with both metadata and acknowledgement callback Message < Price > m5 = Message . of ( price , Metadata . of ( new PriceMetadata ()), () -> { // Called when the message is acknowledged by the next consumer. return CompletableFuture . completedFuture ( null ); }); Messages accept null as payload. Channels connected to outbound connectors interpret messages with null payload differently depending on the technology. 1 2 // Create a message with null payload Message < Price > m6 = Message . of ( null , Metadata . of ( new PriceMetadata ())); You can also create new instance of Message from an existing one: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 // Create a new message with a new payload but with the same metadata Message < Price > m1 = message . withPayload ( new Price ( 12.4 )); // Create a new message with a new payload and add another metadata Message < Price > m2 = message . withPayload ( new Price ( 15.0 )) . withMetadata ( Metadata . of ( new PriceMetadata ())); // Create a new message with a new payload and a custom acknowledgement Message < Price > m3 = message . withPayload ( new Price ( 15.0 )) . withAck (() -> // acknowledge the incoming message message . ack () . thenAccept ( x -> { // do something })); Acknowledgement? Acknowledgement is an important part of messaging systems. This will be covered in the acknowledgement section. Connector Metadata Most connectors are providing metadata to let you extract technical details about the message, but also customize the outbound dispatching. Generating Messages To produce messages to a channel, you need to use the @Outgoing annotation. This annotation takes a single parameter: the name of the populated channel. Generating messages synchronously You can generate messages synchronously. In this case, the method is called for every request from the downstream: 1 2 3 4 @Outgoing ( \"my-channel\" ) public Message < Integer > generateMessagesSynchronously () { return Message . of ( counter . getAndIncrement ()); } Requests? Reactive Messaging connects components to build a reactive stream. In a reactive stream, the emissions are controlled by the consumer (downstream) indicating to the publisher (upstream) how many items it can consume. With this protocol, the consumers are never flooded. Generating messages using CompletionStage You can also return a CompletionStage / CompletableFuture . In this case, Reactive Messaging waits until the CompletionStage gets completed before calling it again. For instance, this signature is useful to poll messages from a source using an asynchronous client: 1 2 3 4 5 @Outgoing ( \"my-channel\" ) public CompletionStage < Message < Price >> generateMessagesAsCompletionStage () { return asyncClient . poll () . thenApply ( Message :: of ); } Generating messages using Uni You can also return a Uni instance. In this case, Reactive Messaging waits until the Uni emits its item before calling it again. This signature is useful when integrating asynchronous clients providing a Mutiny API. 1 2 3 4 @Outgoing ( \"my-channel\" ) public Uni < Message < Integer >> generateMessagesAsync () { return Uni . createFrom (). item (() -> Message . of ( counter . getAndIncrement ())); } Generating Reactive Streams of messages Instead of producing the message one by one, you can return the stream directly. If you have a data source producing Reactive Streams Publisher (or sub-types, such as Multi ), this is the signature you are looking for: 1 2 3 4 public Publisher < Message < String >> generateMessageStream () { Multi < String > multi = reactiveClient . getStream (); return multi . map ( Message :: of ); } In this case, the method is called once to retrieve the Publisher . Generating Payloads Instead of Message , you can produce payloads . In this case, Reactive Messaging produces a simple message from the payload using Message.of . Generating payload synchronously You can produce payloads synchronously. The framework calls the method upon request and create Messages around the produced payloads. 1 2 3 4 @Outgoing ( \"my-channel\" ) public Integer generatePayloadsSynchronously () { return counter . getAndIncrement (); } Generating payload using CompletionStage You can also return CompletionStage or CompletableFuture . For example, if you have an asynchronous client returning CompletionStage , you can use it as follows, to poll the data one by one: 1 2 3 4 @Outgoing ( \"my-channel\" ) public CompletionStage < Price > generatePayloadsAsCompletionStage () { return asyncClient . poll (); } Generating payload by producing Unis You can also return a Uni if you have a client using Mutiny types: 1 2 3 4 @Outgoing ( \"my-channel\" ) public Uni < Integer > generatePayloadsAsync () { return Uni . createFrom (). item (() -> counter . getAndIncrement ()); } Generating Reactive Streams of payloads Finally, you can return a Publisher (or a sub-type such as a Multi ): 1 2 3 4 5 @Outgoing ( \"my-channel\" ) public Multi < String > generatePayloadsStream () { Multi < String > multi = reactiveClient . getStream (); return multi ; } In this case, Reactive Messaging calls the method only once to retrieve the Publisher . Consuming Messages To consume messages from a channel, you need to use the @Incoming annotation. This annotation takes a single parameter: the name of the consumed channel. Because Messages must be acknowledged, consuming messages requires returning asynchronous results that would complete when the incoming message get acknowledged. For example, you can receive the Message , process it and return the acknowledgement as result: 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public CompletionStage < Void > consumeMessage ( Message < Price > message ) { handle ( message . getPayload ()); return message . ack (); } ' You can also return a Uni if you need to implement more complicated processing: 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public Uni < Void > consumeMessageUni ( Message < Price > message ) { return Uni . createFrom (). item ( message ) . onItem (). invoke ( m -> handle ( m . getPayload ())) . onItem (). transformToUni ( x -> Uni . createFrom (). completionStage ( message . ack ())); } Consuming Payloads Unlike consuming messages, consuming payloads support both synchronous and asynchronous consumption. For example, you can consume a payload as follows: 1 2 3 4 @Incoming ( \"my-channel\" ) public void consumePayload ( Price payload ) { // do something } In this case, you don\u2019t need to deal with the acknowledgement yourself. The framework acknowledges the incoming message (that wrapped the payload) once your method returns successfully. If you need to achieve asynchronous actions, you can return a CompletionStage or a Uni : 1 2 3 4 5 @Incoming ( \"my-channel\" ) public CompletionStage < Void > consumePayloadCS ( Price payload ) { CompletionStage < Void > cs = handleAsync ( payload ); return cs ; } 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public Uni < Void > consumePayloadUni ( Price payload ) { return Uni . createFrom (). item ( payload ) . onItem (). invoke ( this :: handle ) . onItem (). ignore (). andContinueWithNull (); } In these 2 cases, the framework acknowledges the incoming message when the returned construct gets completed . Processing Messages You can process Message both synchronously or asynchronously. This later case is useful when you need to execute an asynchronous action during your processing such as invoking a remote service. Do process Messages synchronously uses: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < String > processMessage ( Message < Integer > in ) { return in . withPayload ( Integer . toString ( in . getPayload ())); } This method transforms the int payload to a String , and wraps it into a Message . '''important \"Using Message.withX methods\" You may be surprised by the usage of Message.withX methods. It allows metadata propagation as the metadata would be copied from the incoming message and so dispatched to the next method. You can also process Messages asynchronously: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public CompletionStage < Message < String >> processMessageCS ( Message < Integer > in ) { CompletionStage < String > cs = invokeService ( in . getPayload ()); return cs . thenApply ( in :: withPayload ); } Or using Mutiny: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < Message < String >> processMessageUni ( Message < String > in ) { return invokeService ( in . getPayload ()) . map ( in :: withPayload ); } In general, you want to create the new Message from the incoming one. It enables metadata propagation and post-acknowledgement. For this, use the withX method from the Message class returning a new Message instance but copy the content (metadata, ack/nack...). Processing payloads If you don\u2019t need to manipulate the envelope, you can process payload directly either synchronously or asynchronously: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public String processPayload ( int in ) { return Integer . toString ( in ); } 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public CompletionStage < String > processPayloadCS ( int in ) { return invokeService ( in ); } 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < String > processPayload ( String in ) { return invokeService ( in ); } What about metadata? With these methods, the metadata are automatically propagated. Processing streams The previous processing method were taking single Message or payload. Sometimes you need more advanced manipulation. For this, SmallRye Reactive Messaging lets you process the stream of Message or the stream of payloads directly: 1 2 3 4 5 6 7 8 9 10 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Multi < Message < String >> processMessageStream ( Multi < Message < Integer >> stream ) { return stream . onItem (). transformToUni ( message -> invokeService ( message . getPayload ()) . onFailure (). recoverWithItem ( \"fallback\" ) . onItem (). transform ( message :: withPayload )) . concatenate (); } 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Multi < String > processPayloadStream ( Multi < Integer > stream ) { return stream . onItem (). transformToUni ( payload -> invokeService ( payload ) . onFailure (). recoverWithItem ( \"fallback\" )) . concatenate (); } You can receive either a (Reactive Streams) Publisher , a PublisherBuilder or (Mutiny) Multi . You can return any subclass of Publisher or a Publisher directly. Important These signatures do not support metadata propagation. In the case of a stream of Message , you need to propagate the metadata manually. In the case of a stream of payload, propagation is not supported, and incoming metadata are lost.","title":"Development Model"},{"location":"concepts/model/#development-model","text":"Reactive Messaging proposes a CDI-based programming model to implement event-driven applications. Following the CDI principles, beans are forming the main building block of your application. Reactive Messaging provides a set of annotations and types to implement beans that generate, consume or process messages.","title":"Development Model"},{"location":"concepts/model/#incoming-and-outgoing","text":"Reactive Messaging provides two main annotations: org.eclipse.microprofile.reactive.messaging.Incoming - indicates the consumed channel org.eclipse.microprofile.reactive.messaging.Outgoing - indicates the populated channel These annotations are used on methods : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 package beans ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class MessageProcessingBean { @Incoming ( \"consumed-channel\" ) @Outgoing ( \"populated-channel\" ) public Message < String > process ( Message < String > in ) { // Process the payload String payload = in . getPayload (). toUpperCase (); // Create a new message from `in` and just update the payload return in . withPayload ( payload ); } } Note Reactive Messaging beans can either be in the application scope ( @ApplicationScoped ) or dependent scope ( @Dependent ). Manipulating messages can be cumbersome. When you are only interested in the payload, you can use the following syntax: The following code is equivalent to the snippet from above: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 package beans ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; @ApplicationScoped public class PayloadProcessingBean { @Incoming ( \"consumed-channel\" ) @Outgoing ( \"populated-channel\" ) public String process ( String in ) { return in . toUpperCase (); } } Important You should not call methods annotated with @Incoming and/or @Outgoing directly from your code. They are invoked by the framework. Having user code invoking them would not have the expected outcome. SmallRye Reactive Messaging automatically binds matching @Outgoing to @Incoming to form a chain: A chain of components If we consider the following code: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @Outgoing ( \"source\" ) public Multi < String > generate () { return Multi . createFrom (). items ( \"Hello\" , \"from\" , \"reactive\" , \"messaging\" ); } @Incoming ( \"source\" ) @Outgoing ( \"sink\" ) public String process ( String in ) { return in . toUpperCase (); } @Incoming ( \"sink\" ) public void consume ( String processed ) { System . out . println ( processed ); } It would generate the following chain: 1 generate --> [ source ] --> process --> [ sink ] --> consume Methods annotated with @Incoming or @Outgoing don\u2019t have to be in the same bean ( class ). You can distribute them among a set of beans. Remote interactions are also possible when using connectors. Methods annotated with: only @Outgoing are used to generate messages or payloads only @Incoming are used to consume messages or payloads both @Incoming and @Outgoing are used to process messages or payloads; or transform the stream","title":"@Incoming and @Outgoing"},{"location":"concepts/model/#creating-messages","text":"Messages are envelopes around payload. They are the vehicle. While manipulating payload is convenient, messages let you add metadata, handle acknowledgement... Creating Messages is done using the Message interface directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // Create a simple message wrapping a payload Message < Price > m1 = Message . of ( price ); // Create a message with metadata Message < Price > m2 = Message . of ( price , Metadata . of ( new PriceMetadata ())); // Create a message with several metadata Message < Price > m3 = Message . of ( price , Metadata . of ( new PriceMetadata (), new MyMetadata ())); // Create a message with an acknowledgement callback Message < Price > m4 = Message . of ( price , () -> { // Called when the message is acknowledged by the next consumer. return CompletableFuture . completedFuture ( null ); }); // Create a message with both metadata and acknowledgement callback Message < Price > m5 = Message . of ( price , Metadata . of ( new PriceMetadata ()), () -> { // Called when the message is acknowledged by the next consumer. return CompletableFuture . completedFuture ( null ); }); Messages accept null as payload. Channels connected to outbound connectors interpret messages with null payload differently depending on the technology. 1 2 // Create a message with null payload Message < Price > m6 = Message . of ( null , Metadata . of ( new PriceMetadata ())); You can also create new instance of Message from an existing one: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 // Create a new message with a new payload but with the same metadata Message < Price > m1 = message . withPayload ( new Price ( 12.4 )); // Create a new message with a new payload and add another metadata Message < Price > m2 = message . withPayload ( new Price ( 15.0 )) . withMetadata ( Metadata . of ( new PriceMetadata ())); // Create a new message with a new payload and a custom acknowledgement Message < Price > m3 = message . withPayload ( new Price ( 15.0 )) . withAck (() -> // acknowledge the incoming message message . ack () . thenAccept ( x -> { // do something })); Acknowledgement? Acknowledgement is an important part of messaging systems. This will be covered in the acknowledgement section. Connector Metadata Most connectors are providing metadata to let you extract technical details about the message, but also customize the outbound dispatching.","title":"Creating messages"},{"location":"concepts/model/#generating-messages","text":"To produce messages to a channel, you need to use the @Outgoing annotation. This annotation takes a single parameter: the name of the populated channel.","title":"Generating Messages"},{"location":"concepts/model/#generating-messages-synchronously","text":"You can generate messages synchronously. In this case, the method is called for every request from the downstream: 1 2 3 4 @Outgoing ( \"my-channel\" ) public Message < Integer > generateMessagesSynchronously () { return Message . of ( counter . getAndIncrement ()); } Requests? Reactive Messaging connects components to build a reactive stream. In a reactive stream, the emissions are controlled by the consumer (downstream) indicating to the publisher (upstream) how many items it can consume. With this protocol, the consumers are never flooded.","title":"Generating messages synchronously"},{"location":"concepts/model/#generating-messages-using-completionstage","text":"You can also return a CompletionStage / CompletableFuture . In this case, Reactive Messaging waits until the CompletionStage gets completed before calling it again. For instance, this signature is useful to poll messages from a source using an asynchronous client: 1 2 3 4 5 @Outgoing ( \"my-channel\" ) public CompletionStage < Message < Price >> generateMessagesAsCompletionStage () { return asyncClient . poll () . thenApply ( Message :: of ); }","title":"Generating messages using CompletionStage"},{"location":"concepts/model/#generating-messages-using-uni","text":"You can also return a Uni instance. In this case, Reactive Messaging waits until the Uni emits its item before calling it again. This signature is useful when integrating asynchronous clients providing a Mutiny API. 1 2 3 4 @Outgoing ( \"my-channel\" ) public Uni < Message < Integer >> generateMessagesAsync () { return Uni . createFrom (). item (() -> Message . of ( counter . getAndIncrement ())); }","title":"Generating messages using Uni"},{"location":"concepts/model/#generating-reactive-streams-of-messages","text":"Instead of producing the message one by one, you can return the stream directly. If you have a data source producing Reactive Streams Publisher (or sub-types, such as Multi ), this is the signature you are looking for: 1 2 3 4 public Publisher < Message < String >> generateMessageStream () { Multi < String > multi = reactiveClient . getStream (); return multi . map ( Message :: of ); } In this case, the method is called once to retrieve the Publisher .","title":"Generating Reactive Streams of messages"},{"location":"concepts/model/#generating-payloads","text":"Instead of Message , you can produce payloads . In this case, Reactive Messaging produces a simple message from the payload using Message.of .","title":"Generating Payloads"},{"location":"concepts/model/#generating-payload-synchronously","text":"You can produce payloads synchronously. The framework calls the method upon request and create Messages around the produced payloads. 1 2 3 4 @Outgoing ( \"my-channel\" ) public Integer generatePayloadsSynchronously () { return counter . getAndIncrement (); }","title":"Generating payload synchronously"},{"location":"concepts/model/#generating-payload-using-completionstage","text":"You can also return CompletionStage or CompletableFuture . For example, if you have an asynchronous client returning CompletionStage , you can use it as follows, to poll the data one by one: 1 2 3 4 @Outgoing ( \"my-channel\" ) public CompletionStage < Price > generatePayloadsAsCompletionStage () { return asyncClient . poll (); }","title":"Generating payload using CompletionStage"},{"location":"concepts/model/#generating-payload-by-producing-unis","text":"You can also return a Uni if you have a client using Mutiny types: 1 2 3 4 @Outgoing ( \"my-channel\" ) public Uni < Integer > generatePayloadsAsync () { return Uni . createFrom (). item (() -> counter . getAndIncrement ()); }","title":"Generating payload by producing Unis"},{"location":"concepts/model/#generating-reactive-streams-of-payloads","text":"Finally, you can return a Publisher (or a sub-type such as a Multi ): 1 2 3 4 5 @Outgoing ( \"my-channel\" ) public Multi < String > generatePayloadsStream () { Multi < String > multi = reactiveClient . getStream (); return multi ; } In this case, Reactive Messaging calls the method only once to retrieve the Publisher .","title":"Generating Reactive Streams of payloads"},{"location":"concepts/model/#consuming-messages","text":"To consume messages from a channel, you need to use the @Incoming annotation. This annotation takes a single parameter: the name of the consumed channel. Because Messages must be acknowledged, consuming messages requires returning asynchronous results that would complete when the incoming message get acknowledged. For example, you can receive the Message , process it and return the acknowledgement as result: 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public CompletionStage < Void > consumeMessage ( Message < Price > message ) { handle ( message . getPayload ()); return message . ack (); } ' You can also return a Uni if you need to implement more complicated processing: 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public Uni < Void > consumeMessageUni ( Message < Price > message ) { return Uni . createFrom (). item ( message ) . onItem (). invoke ( m -> handle ( m . getPayload ())) . onItem (). transformToUni ( x -> Uni . createFrom (). completionStage ( message . ack ())); }","title":"Consuming Messages"},{"location":"concepts/model/#consuming-payloads","text":"Unlike consuming messages, consuming payloads support both synchronous and asynchronous consumption. For example, you can consume a payload as follows: 1 2 3 4 @Incoming ( \"my-channel\" ) public void consumePayload ( Price payload ) { // do something } In this case, you don\u2019t need to deal with the acknowledgement yourself. The framework acknowledges the incoming message (that wrapped the payload) once your method returns successfully. If you need to achieve asynchronous actions, you can return a CompletionStage or a Uni : 1 2 3 4 5 @Incoming ( \"my-channel\" ) public CompletionStage < Void > consumePayloadCS ( Price payload ) { CompletionStage < Void > cs = handleAsync ( payload ); return cs ; } 1 2 3 4 5 6 @Incoming ( \"my-channel\" ) public Uni < Void > consumePayloadUni ( Price payload ) { return Uni . createFrom (). item ( payload ) . onItem (). invoke ( this :: handle ) . onItem (). ignore (). andContinueWithNull (); } In these 2 cases, the framework acknowledges the incoming message when the returned construct gets completed .","title":"Consuming Payloads"},{"location":"concepts/model/#processing-messages","text":"You can process Message both synchronously or asynchronously. This later case is useful when you need to execute an asynchronous action during your processing such as invoking a remote service. Do process Messages synchronously uses: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < String > processMessage ( Message < Integer > in ) { return in . withPayload ( Integer . toString ( in . getPayload ())); } This method transforms the int payload to a String , and wraps it into a Message . '''important \"Using Message.withX methods\" You may be surprised by the usage of Message.withX methods. It allows metadata propagation as the metadata would be copied from the incoming message and so dispatched to the next method. You can also process Messages asynchronously: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public CompletionStage < Message < String >> processMessageCS ( Message < Integer > in ) { CompletionStage < String > cs = invokeService ( in . getPayload ()); return cs . thenApply ( in :: withPayload ); } Or using Mutiny: 1 2 3 4 5 6 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < Message < String >> processMessageUni ( Message < String > in ) { return invokeService ( in . getPayload ()) . map ( in :: withPayload ); } In general, you want to create the new Message from the incoming one. It enables metadata propagation and post-acknowledgement. For this, use the withX method from the Message class returning a new Message instance but copy the content (metadata, ack/nack...).","title":"Processing Messages"},{"location":"concepts/model/#processing-payloads","text":"If you don\u2019t need to manipulate the envelope, you can process payload directly either synchronously or asynchronously: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public String processPayload ( int in ) { return Integer . toString ( in ); } 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public CompletionStage < String > processPayloadCS ( int in ) { return invokeService ( in ); } 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < String > processPayload ( String in ) { return invokeService ( in ); } What about metadata? With these methods, the metadata are automatically propagated.","title":"Processing payloads"},{"location":"concepts/model/#processing-streams","text":"The previous processing method were taking single Message or payload. Sometimes you need more advanced manipulation. For this, SmallRye Reactive Messaging lets you process the stream of Message or the stream of payloads directly: 1 2 3 4 5 6 7 8 9 10 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Multi < Message < String >> processMessageStream ( Multi < Message < Integer >> stream ) { return stream . onItem (). transformToUni ( message -> invokeService ( message . getPayload ()) . onFailure (). recoverWithItem ( \"fallback\" ) . onItem (). transform ( message :: withPayload )) . concatenate (); } 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Multi < String > processPayloadStream ( Multi < Integer > stream ) { return stream . onItem (). transformToUni ( payload -> invokeService ( payload ) . onFailure (). recoverWithItem ( \"fallback\" )) . concatenate (); } You can receive either a (Reactive Streams) Publisher , a PublisherBuilder or (Mutiny) Multi . You can return any subclass of Publisher or a Publisher directly. Important These signatures do not support metadata propagation. In the case of a stream of Message , you need to propagate the metadata manually. In the case of a stream of payload, propagation is not supported, and incoming metadata are lost.","title":"Processing streams"},{"location":"concepts/signatures/","text":"Supported signatures The following tables list the supported method signatures and indicate the various supported features. For instance, they indicate the default and available acknowledgement strategies (when applicable). Signature Invocation time @Outgoing Publisher> method() ` Called once at assembly time @Outgoing Publisher method() ` Called once at assembly time @Outgoing Multi> method() ` Called once at assembly time @Outgoing Multi method() ` Called once at assembly time @Outgoing PublisherBuilder> method() ` Called once at assembly time @Outgoing PublisherBuilder method() ` Called once at assembly time @Outgoing Message method() ` Called for every downstream request, sequentially @Outgoing O method() ` Called for every downstream request, sequentially @Outgoing CompletionStage> method() ` Called for every downstream request, sequentially (After the completion of the last returned CompletionStage) @Outgoing CompletionStage method() ` Called for every downstream request, , sequentially (After the completion of the last returned CompletionStage) @Outgoing Uni> method() ` Called for every downstream request, sequentially (After the completion of the last returned Uni) @Outgoing Uni method() ` Called for every downstream request, , sequentially (After the completion of the last returned Uni) Method signatures to generate data Signature Invocation time Supported Acknowledgement Strategies @Incoming void method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING @Incoming CompletionStage method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING @Incoming CompletionStage method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , PRE_PROCESSING, NONE @Incoming Uni method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING @Incoming Uni method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , PRE_PROCESSING, NONE @Incoming Subscriber> method() Called once at assembly time MANUAL , POST_PROCESSING, NONE, PRE_PROCESSING @Incoming Subscriber method() Called once at assembly time POST_PROCESSING , NONE, PRE_PROCESSING Method signatures to consume data Signature Invocation time Supported Acknowledgement Strategies Metadata Propagation @Outgoing @Incoming Message method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming O method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming CompletionStage> method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming CompletionStage method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming Uni> method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Uni method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming Processor, Message> method() Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Processor method() Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming ProcessorBuilder, Message> method() Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming ProcessorBuilder method() Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming Publisher> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Publisher method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic @Outgoing @Incoming Multi> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Multi method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic @Outgoing @Incoming PublisherBuilder> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming PublisherBuilder method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic Method signatures to process data Signature Invocation time Supported Acknowledgement Strategies Metadata Propagation @Outgoing @Incoming Publisher> method(Publisher> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Publisher method(Publisher pub) Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming Multi> method(Multi> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Multi method(Multi pub) Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming PublisherBuilder> method(PublisherBuilder> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming PublisherBuilder method(PublisherBuilder pub) Called once at assembly time NONE, PRE_PROCESSING not supported Method signatures to manipulate streams Important When processing Message , it is often required to chain the incoming Message to enable post-processing acknowledgement and metadata propagation. Use the with (like withPayload ) methods from the incoming message, so it copies the metadata and ack/nack methods. It returns a new Message with the right content.","title":"Method Signatures"},{"location":"concepts/signatures/#supported-signatures","text":"The following tables list the supported method signatures and indicate the various supported features. For instance, they indicate the default and available acknowledgement strategies (when applicable). Signature Invocation time @Outgoing Publisher> method() ` Called once at assembly time @Outgoing Publisher method() ` Called once at assembly time @Outgoing Multi> method() ` Called once at assembly time @Outgoing Multi method() ` Called once at assembly time @Outgoing PublisherBuilder> method() ` Called once at assembly time @Outgoing PublisherBuilder method() ` Called once at assembly time @Outgoing Message method() ` Called for every downstream request, sequentially @Outgoing O method() ` Called for every downstream request, sequentially @Outgoing CompletionStage> method() ` Called for every downstream request, sequentially (After the completion of the last returned CompletionStage) @Outgoing CompletionStage method() ` Called for every downstream request, , sequentially (After the completion of the last returned CompletionStage) @Outgoing Uni> method() ` Called for every downstream request, sequentially (After the completion of the last returned Uni) @Outgoing Uni method() ` Called for every downstream request, , sequentially (After the completion of the last returned Uni) Method signatures to generate data Signature Invocation time Supported Acknowledgement Strategies @Incoming void method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING @Incoming CompletionStage method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING @Incoming CompletionStage method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , PRE_PROCESSING, NONE @Incoming Uni method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING @Incoming Uni method(I p) Called for every incoming payload (sequentially) POST_PROCESSING , PRE_PROCESSING, NONE @Incoming Subscriber> method() Called once at assembly time MANUAL , POST_PROCESSING, NONE, PRE_PROCESSING @Incoming Subscriber method() Called once at assembly time POST_PROCESSING , NONE, PRE_PROCESSING Method signatures to consume data Signature Invocation time Supported Acknowledgement Strategies Metadata Propagation @Outgoing @Incoming Message method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming O method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming CompletionStage> method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming CompletionStage method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming Uni> method(Message msg) Called for every incoming message (sequentially) MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Uni method(I payload) Called for every incoming payload (sequentially) POST_PROCESSING , NONE, PRE_PROCESSING automatic @Outgoing @Incoming Processor, Message> method() Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Processor method() Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming ProcessorBuilder, Message> method() Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming ProcessorBuilder method() Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming Publisher> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Publisher method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic @Outgoing @Incoming Multi> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming Multi method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic @Outgoing @Incoming PublisherBuilder> method(Message msg) Called once at assembly time MANUAL , PRE_PROCESSING, NONE manual @Outgoing @Incoming PublisherBuilder method(I payload) Called once at assembly time PRE_PROCESSING , NONE automatic Method signatures to process data Signature Invocation time Supported Acknowledgement Strategies Metadata Propagation @Outgoing @Incoming Publisher> method(Publisher> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Publisher method(Publisher pub) Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming Multi> method(Multi> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming Multi method(Multi pub) Called once at assembly time PRE_PROCESSING , NONE not supported @Outgoing @Incoming PublisherBuilder> method(PublisherBuilder> pub) Called once at assembly time MANUAL , NONE, PRE_PROCESSING manual @Outgoing @Incoming PublisherBuilder method(PublisherBuilder pub) Called once at assembly time NONE, PRE_PROCESSING not supported Method signatures to manipulate streams Important When processing Message , it is often required to chain the incoming Message to enable post-processing acknowledgement and metadata propagation. Use the with (like withPayload ) methods from the incoming message, so it copies the metadata and ack/nack methods. It returns a new Message with the right content.","title":"Supported signatures"},{"location":"concepts/skipping/","text":"Skipping messages Sometimes you receive a message and don\u2019t want to produce an output message. To handle this, you have several choices: for method processing single message or payload, producing null would produce an ignored message (not forwarded) for method processing streams, you can generate an empty stream. Skipping a single item To skip a single message or payload, return null : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 // Skip when processing payload synchronously - returning `null` @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public String processPayload ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { return null ; } return s . toUpperCase (); } // Skip when processing message synchronously - returning `null` @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < String > processMessage ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { m . ack (); return null ; } return m . withPayload ( s . toUpperCase ()); } // Skip when processing payload asynchronously - returning a `Uni` with a `null` value @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < String > processPayloadAsync ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { // Important, you must not return `null`, but a `null` content return Uni . createFrom (). nullItem (); } return Uni . createFrom (). item ( s . toUpperCase ()); } // Skip when processing message asynchronously - returning a `Uni` with a `null` value @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < Message < String >> processMessageAsync ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { m . ack (); return Uni . createFrom (). nullItem (); } return Uni . createFrom (). item ( m . withPayload ( s . toUpperCase ())); } Skipping in a stream To skip a message or payload when manipulating a stream, emit an empty Multi (or Publisher ): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 @Incoming ( \"in\" ) @Outgoing ( \"out-1\" ) public Multi < String > processPayload ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { return Multi . createFrom (). empty (); } return Multi . createFrom (). item ( s . toUpperCase ()); } @Incoming ( \"in\" ) @Outgoing ( \"out-2\" ) public Multi < Message < String >> processMessage ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { return Multi . createFrom (). empty (); } return Multi . createFrom (). item ( m . withPayload ( s . toUpperCase ())); } @Incoming ( \"in\" ) @Outgoing ( \"out-3\" ) public Multi < String > processPayloadStream ( Multi < String > stream ) { return stream . select (). where ( s -> ! s . equalsIgnoreCase ( \"skip\" )) . onItem (). transform ( String :: toUpperCase ); } @Incoming ( \"in\" ) @Outgoing ( \"out-4\" ) public Multi < Message < String >> processMessageStream ( Multi < Message < String >> stream ) { return stream . select (). where ( m -> ! m . getPayload (). equalsIgnoreCase ( \"skip\" )) . onItem (). transform ( m -> m . withPayload ( m . getPayload (). toUpperCase ())); }","title":"Skipping Messages"},{"location":"concepts/skipping/#skipping-messages","text":"Sometimes you receive a message and don\u2019t want to produce an output message. To handle this, you have several choices: for method processing single message or payload, producing null would produce an ignored message (not forwarded) for method processing streams, you can generate an empty stream.","title":"Skipping messages"},{"location":"concepts/skipping/#skipping-a-single-item","text":"To skip a single message or payload, return null : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 // Skip when processing payload synchronously - returning `null` @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public String processPayload ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { return null ; } return s . toUpperCase (); } // Skip when processing message synchronously - returning `null` @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Message < String > processMessage ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { m . ack (); return null ; } return m . withPayload ( s . toUpperCase ()); } // Skip when processing payload asynchronously - returning a `Uni` with a `null` value @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < String > processPayloadAsync ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { // Important, you must not return `null`, but a `null` content return Uni . createFrom (). nullItem (); } return Uni . createFrom (). item ( s . toUpperCase ()); } // Skip when processing message asynchronously - returning a `Uni` with a `null` value @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Uni < Message < String >> processMessageAsync ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { m . ack (); return Uni . createFrom (). nullItem (); } return Uni . createFrom (). item ( m . withPayload ( s . toUpperCase ())); }","title":"Skipping a single item"},{"location":"concepts/skipping/#skipping-in-a-stream","text":"To skip a message or payload when manipulating a stream, emit an empty Multi (or Publisher ): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 @Incoming ( \"in\" ) @Outgoing ( \"out-1\" ) public Multi < String > processPayload ( String s ) { if ( s . equalsIgnoreCase ( \"skip\" )) { return Multi . createFrom (). empty (); } return Multi . createFrom (). item ( s . toUpperCase ()); } @Incoming ( \"in\" ) @Outgoing ( \"out-2\" ) public Multi < Message < String >> processMessage ( Message < String > m ) { String s = m . getPayload (); if ( s . equalsIgnoreCase ( \"skip\" )) { return Multi . createFrom (). empty (); } return Multi . createFrom (). item ( m . withPayload ( s . toUpperCase ())); } @Incoming ( \"in\" ) @Outgoing ( \"out-3\" ) public Multi < String > processPayloadStream ( Multi < String > stream ) { return stream . select (). where ( s -> ! s . equalsIgnoreCase ( \"skip\" )) . onItem (). transform ( String :: toUpperCase ); } @Incoming ( \"in\" ) @Outgoing ( \"out-4\" ) public Multi < Message < String >> processMessageStream ( Multi < Message < String >> stream ) { return stream . select (). where ( m -> ! m . getPayload (). equalsIgnoreCase ( \"skip\" )) . onItem (). transform ( m -> m . withPayload ( m . getPayload (). toUpperCase ())); }","title":"Skipping in a stream"},{"location":"concepts/testing/","text":"Testing your application It\u2019s not rare to have to test your application but deploying the infrastructure can be cumbersome. While Docker or Test Containers have improved the testing experience, you may want to mock this infrastructure. SmallRye Reactive Messaging proposes an in-memory connector for this exact purpose. It allows switching the connector used for a channel with an in-memory connector. This in-memory connector provides a way to send messages to incoming channels, or check the received messages for outgoing channels. To use the in-memory connector, you need to add the following dependency to your project: 1 2 3 4 5 6 io.smallrye.reactive smallrye-reactive-messaging-in-memory 3.25.0 test Then, in a test, you can do something like: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 package testing ; import javax.enterprise.inject.Any ; import javax.inject.Inject ; import org.junit.jupiter.api.AfterAll ; import org.junit.jupiter.api.Assertions ; import org.junit.jupiter.api.BeforeAll ; import org.junit.jupiter.api.Test ; import io.smallrye.reactive.messaging.providers.connectors.InMemoryConnector ; import io.smallrye.reactive.messaging.providers.connectors.InMemorySink ; import io.smallrye.reactive.messaging.providers.connectors.InMemorySource ; public class MyTest { // 1. Switch the channels to the in-memory connector: @BeforeAll public static void switchMyChannels () { InMemoryConnector . switchIncomingChannelsToInMemory ( \"prices\" ); InMemoryConnector . switchOutgoingChannelsToInMemory ( \"processed-prices\" ); } // 2. Don't forget to reset the channel after the tests: @AfterAll public static void revertMyChannels () { InMemoryConnector . clear (); } // 3. Inject the in-memory connector in your test, // or use the bean manager to retrieve the instance @Inject @Any InMemoryConnector connector ; @Test void test () { // 4. Retrieves the in-memory source to send message InMemorySource < Integer > prices = connector . source ( \"prices\" ); // 5. Retrieves the in-memory sink to check what is received InMemorySink < Integer > results = connector . sink ( \"processed-prices\" ); // 6. Send fake messages: prices . send ( 1 ); prices . send ( 2 ); prices . send ( 3 ); // 7. Check you have received the expected messages Assertions . assertEquals ( 3 , results . received (). size ()); } } When switching a channel to the in-memory connector, all the configuration properties are ignored. Important This connector has been designed for testing purpose only. The switch methods return Map instances containing the set properties. While these system properties are already set, you can retrieve them and pass them around, for example if you need to start an external process with these properties: 1 2 3 4 5 6 7 8 9 10 public Map < String , String > start () { Map < String , String > env = new HashMap <> (); env . putAll ( InMemoryConnector . switchIncomingChannelsToInMemory ( \"prices\" )); env . putAll ( InMemoryConnector . switchOutgoingChannelsToInMemory ( \"my-data-stream\" )); return env ; } public void stop () { InMemoryConnector . clear (); } Note The in-memory connector support the broadcast and merge attributes. So, if your connector is configured with broadcast: true , the connector broadcasts the messages to all the channel consumers. If your connector is configured with merge:true , the connector receives all the messages sent to the mapped channel even when coming from multiple producers.","title":"Testing"},{"location":"concepts/testing/#testing-your-application","text":"It\u2019s not rare to have to test your application but deploying the infrastructure can be cumbersome. While Docker or Test Containers have improved the testing experience, you may want to mock this infrastructure. SmallRye Reactive Messaging proposes an in-memory connector for this exact purpose. It allows switching the connector used for a channel with an in-memory connector. This in-memory connector provides a way to send messages to incoming channels, or check the received messages for outgoing channels. To use the in-memory connector, you need to add the following dependency to your project: 1 2 3 4 5 6 io.smallrye.reactive smallrye-reactive-messaging-in-memory 3.25.0 test Then, in a test, you can do something like: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 package testing ; import javax.enterprise.inject.Any ; import javax.inject.Inject ; import org.junit.jupiter.api.AfterAll ; import org.junit.jupiter.api.Assertions ; import org.junit.jupiter.api.BeforeAll ; import org.junit.jupiter.api.Test ; import io.smallrye.reactive.messaging.providers.connectors.InMemoryConnector ; import io.smallrye.reactive.messaging.providers.connectors.InMemorySink ; import io.smallrye.reactive.messaging.providers.connectors.InMemorySource ; public class MyTest { // 1. Switch the channels to the in-memory connector: @BeforeAll public static void switchMyChannels () { InMemoryConnector . switchIncomingChannelsToInMemory ( \"prices\" ); InMemoryConnector . switchOutgoingChannelsToInMemory ( \"processed-prices\" ); } // 2. Don't forget to reset the channel after the tests: @AfterAll public static void revertMyChannels () { InMemoryConnector . clear (); } // 3. Inject the in-memory connector in your test, // or use the bean manager to retrieve the instance @Inject @Any InMemoryConnector connector ; @Test void test () { // 4. Retrieves the in-memory source to send message InMemorySource < Integer > prices = connector . source ( \"prices\" ); // 5. Retrieves the in-memory sink to check what is received InMemorySink < Integer > results = connector . sink ( \"processed-prices\" ); // 6. Send fake messages: prices . send ( 1 ); prices . send ( 2 ); prices . send ( 3 ); // 7. Check you have received the expected messages Assertions . assertEquals ( 3 , results . received (). size ()); } } When switching a channel to the in-memory connector, all the configuration properties are ignored. Important This connector has been designed for testing purpose only. The switch methods return Map instances containing the set properties. While these system properties are already set, you can retrieve them and pass them around, for example if you need to start an external process with these properties: 1 2 3 4 5 6 7 8 9 10 public Map < String , String > start () { Map < String , String > env = new HashMap <> (); env . putAll ( InMemoryConnector . switchIncomingChannelsToInMemory ( \"prices\" )); env . putAll ( InMemoryConnector . switchOutgoingChannelsToInMemory ( \"my-data-stream\" )); return env ; } public void stop () { InMemoryConnector . clear (); } Note The in-memory connector support the broadcast and merge attributes. So, if your connector is configured with broadcast: true , the connector broadcasts the messages to all the channel consumers. If your connector is configured with merge:true , the connector receives all the messages sent to the mapped channel even when coming from multiple producers.","title":"Testing your application"},{"location":"jms/advanced-jms/","text":"Advanced configuration Underlying thread pool Lots of JMS operations are blocking and so not cannot be done on the caller thread. For this reason, these blocking operations are executed on a worker thread. You can configure the thread pool providing these worker threads using the following MicroProfile Config properties: smallrye.jms.threads.max-pool-size - the max number of threads (Defaults to 10) smallrye.jms.threads.ttl - the ttl of the created threads (Defaults to 60 seconds) Selecting the ConnectionFactory The JMS Connector requires a javax.jms.ConnectionFactory to be exposed as a CDI bean. The connector looks for a javax.jms.ConnectionFactory and delegate the interaction with the JMS server to this factory. In case you have several connection factories, you can use the @Identifier qualifier on your factory to specify the name. Then, in the channel configuration, configure the name as follows: 1 2 3 4 5 6 # Configure the connector globally mp.messaging.connector.smallrye-jms.connection-factory-name = my-factory-name # Configure a specific incoming channel mp.messaging.incoming.my-channel.connection-factory-name = my-factory-name # Configure a specific outgoing channel mp.messaging.outgoing.my-channel.connection-factory-name = my-factory-name","title":"Advanced configuration"},{"location":"jms/advanced-jms/#advanced-configuration","text":"","title":"Advanced configuration"},{"location":"jms/advanced-jms/#underlying-thread-pool","text":"Lots of JMS operations are blocking and so not cannot be done on the caller thread. For this reason, these blocking operations are executed on a worker thread. You can configure the thread pool providing these worker threads using the following MicroProfile Config properties: smallrye.jms.threads.max-pool-size - the max number of threads (Defaults to 10) smallrye.jms.threads.ttl - the ttl of the created threads (Defaults to 60 seconds)","title":"Underlying thread pool"},{"location":"jms/advanced-jms/#selecting-the-connectionfactory","text":"The JMS Connector requires a javax.jms.ConnectionFactory to be exposed as a CDI bean. The connector looks for a javax.jms.ConnectionFactory and delegate the interaction with the JMS server to this factory. In case you have several connection factories, you can use the @Identifier qualifier on your factory to specify the name. Then, in the channel configuration, configure the name as follows: 1 2 3 4 5 6 # Configure the connector globally mp.messaging.connector.smallrye-jms.connection-factory-name = my-factory-name # Configure a specific incoming channel mp.messaging.incoming.my-channel.connection-factory-name = my-factory-name # Configure a specific outgoing channel mp.messaging.outgoing.my-channel.connection-factory-name = my-factory-name","title":"Selecting the ConnectionFactory"},{"location":"jms/jms/","text":"The JMS connector The JMS connector adds support for Jakarta Messaging to Reactive Messaging. It is designed to integrate with JakartaEE applications that are sending or receiving Jakarta Messaging Messages. Jakarta Messaging is a Java Message Oriented Middleware API for sending messages between two or more clients. It is a programming model to handle the producer-consumer messaging problem. It is a messaging standard that allows application components based on Jakarta EE to create, send, receive, and read messages. It allows the communication between different components of a distributed application to be loosely coupled, reliable, and asynchronous. Using the JMS connector To you the JMS Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-jms 3.25.0 The connector name is: smallrye-jms . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-jms # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-jms The JMS Connector requires a javax.jms.ConnectionFactory to be exposed (as CDI bean). The connector looks for a javax.jms.ConnectionFactory and delegate the interaction with the JMS server to this factory. In other words, it creates the JMS connection and context using this factory. So, in order to use this connector you would need to expose a javax.jms.ConnectionFactory : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 import javax.enterprise.context.ApplicationScoped ; import javax.enterprise.inject.Produces ; import javax.jms.ConnectionFactory ; import org.apache.activemq.artemis.jms.client.ActiveMQJMSConnectionFactory ; @ApplicationScoped public class ConnectionFactoryBean { @Produces ConnectionFactory factory () { return new ActiveMQJMSConnectionFactory ( \"tcp://localhost:61616\" , null , null ); } } The factory class may depend on your JMS connector/server.","title":"The JMS connector"},{"location":"jms/jms/#the-jms-connector","text":"The JMS connector adds support for Jakarta Messaging to Reactive Messaging. It is designed to integrate with JakartaEE applications that are sending or receiving Jakarta Messaging Messages. Jakarta Messaging is a Java Message Oriented Middleware API for sending messages between two or more clients. It is a programming model to handle the producer-consumer messaging problem. It is a messaging standard that allows application components based on Jakarta EE to create, send, receive, and read messages. It allows the communication between different components of a distributed application to be loosely coupled, reliable, and asynchronous.","title":"The JMS connector"},{"location":"jms/jms/#using-the-jms-connector","text":"To you the JMS Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-jms 3.25.0 The connector name is: smallrye-jms . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-jms # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-jms The JMS Connector requires a javax.jms.ConnectionFactory to be exposed (as CDI bean). The connector looks for a javax.jms.ConnectionFactory and delegate the interaction with the JMS server to this factory. In other words, it creates the JMS connection and context using this factory. So, in order to use this connector you would need to expose a javax.jms.ConnectionFactory : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 import javax.enterprise.context.ApplicationScoped ; import javax.enterprise.inject.Produces ; import javax.jms.ConnectionFactory ; import org.apache.activemq.artemis.jms.client.ActiveMQJMSConnectionFactory ; @ApplicationScoped public class ConnectionFactoryBean { @Produces ConnectionFactory factory () { return new ActiveMQJMSConnectionFactory ( \"tcp://localhost:61616\" , null , null ); } } The factory class may depend on your JMS connector/server.","title":"Using the JMS connector"},{"location":"jms/receiving-jms-messages/","text":"Receiving messages from JMS The JMS Connector retrieves JMS Message and maps each of them into Reactive Messaging Messages . Example Let\u2019s imagine you have a javax.jms.ConnectionFactory bean exposed and connected to your JMS server. Don\u2019t forget that it\u2019s required to use the JMS connector. Configure your application to receive JMS messages on the prices channel as follows: 1 mp.messaging.incoming.prices.connector = smallrye-jms Note You don\u2019t need to set the destination. By default, it uses the channel name ( prices ). You can configure the destination attribute to override it. Note By default the connector uses a queue . You can configure it to use a topic by setting destination-type=topic . Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package jms.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class JmsPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package jms.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class JmsPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message return price . ack (); } } Deserialization The content of the incoming JMS message is mapped to a Java object. By default it extracts the JMS Message body as a java.lang.Object . This can be changed by setting, in the incoming JMS Message: The _classname property the JMSType The value must be a fully qualified class name. The connector then load the associated class. Note The connector loads the associated Class using the TCCL and if not found, the classloader used to load the connector. If the target type is a primitive type ort String , the resulting message contains the mapped payload. If the target type is a class, the object is built using included JSON deserializer (JSON-B and Jackson provided OOB, for more details see Serde ), from the JMSType . If not, the default behavior is used (Java deserialization). Inbound Metadata Messages coming from JMS contains an instance of io.smallrye.reactive.messaging.jms.IncomingJmsMessageMetadata in the metadata. 1 2 3 4 5 6 Optional < IncomingJmsMessageMetadata > metadata = incoming . getMetadata ( IncomingJmsMessageMetadata . class ); metadata . ifPresent ( meta -> { long expiration = meta . getExpiration (); Destination destination = meta . getDestination (); String value = meta . getStringProperty ( \"my-property\" ); }); Acknowledgement When the Reactive Messaging Message gets acknowledged, the associated JMS Message is acknowledged. As JMS acknowledgement is blocking, this acknowledgement is delegated to a worker thread. Configuration Reference Attribute ( alias ) Description Type Mandatory Default broadcast Whether or not the JMS message should be dispatched to multiple consumers boolean false false client-id The client id String false connection-factory-name The name of the JMS connection factory ( javax.jms.ConnectionFactory ) to be used. If not set, it uses any exposed JMS connection factory String false destination The name of the JMS destination. If not set the name of the channel is used String false destination-type The type of destination. It can be either queue or topic string false queue durable Set to true to use a durable subscription boolean false false no-local Enable or disable local delivery boolean false false password The password to connect to to the JMS server String false selector The JMS selector String false session-mode The session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE String false AUTO_ACKNOWLEDGE username The username to connect to to the JMS server String false","title":"Receiving JMS messages"},{"location":"jms/receiving-jms-messages/#receiving-messages-from-jms","text":"The JMS Connector retrieves JMS Message and maps each of them into Reactive Messaging Messages .","title":"Receiving messages from JMS"},{"location":"jms/receiving-jms-messages/#example","text":"Let\u2019s imagine you have a javax.jms.ConnectionFactory bean exposed and connected to your JMS server. Don\u2019t forget that it\u2019s required to use the JMS connector. Configure your application to receive JMS messages on the prices channel as follows: 1 mp.messaging.incoming.prices.connector = smallrye-jms Note You don\u2019t need to set the destination. By default, it uses the channel name ( prices ). You can configure the destination attribute to override it. Note By default the connector uses a queue . You can configure it to use a topic by setting destination-type=topic . Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package jms.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class JmsPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package jms.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class JmsPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message return price . ack (); } }","title":"Example"},{"location":"jms/receiving-jms-messages/#deserialization","text":"The content of the incoming JMS message is mapped to a Java object. By default it extracts the JMS Message body as a java.lang.Object . This can be changed by setting, in the incoming JMS Message: The _classname property the JMSType The value must be a fully qualified class name. The connector then load the associated class. Note The connector loads the associated Class using the TCCL and if not found, the classloader used to load the connector. If the target type is a primitive type ort String , the resulting message contains the mapped payload. If the target type is a class, the object is built using included JSON deserializer (JSON-B and Jackson provided OOB, for more details see Serde ), from the JMSType . If not, the default behavior is used (Java deserialization).","title":"Deserialization"},{"location":"jms/receiving-jms-messages/#inbound-metadata","text":"Messages coming from JMS contains an instance of io.smallrye.reactive.messaging.jms.IncomingJmsMessageMetadata in the metadata. 1 2 3 4 5 6 Optional < IncomingJmsMessageMetadata > metadata = incoming . getMetadata ( IncomingJmsMessageMetadata . class ); metadata . ifPresent ( meta -> { long expiration = meta . getExpiration (); Destination destination = meta . getDestination (); String value = meta . getStringProperty ( \"my-property\" ); });","title":"Inbound Metadata"},{"location":"jms/receiving-jms-messages/#acknowledgement","text":"When the Reactive Messaging Message gets acknowledged, the associated JMS Message is acknowledged. As JMS acknowledgement is blocking, this acknowledgement is delegated to a worker thread.","title":"Acknowledgement"},{"location":"jms/receiving-jms-messages/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default broadcast Whether or not the JMS message should be dispatched to multiple consumers boolean false false client-id The client id String false connection-factory-name The name of the JMS connection factory ( javax.jms.ConnectionFactory ) to be used. If not set, it uses any exposed JMS connection factory String false destination The name of the JMS destination. If not set the name of the channel is used String false destination-type The type of destination. It can be either queue or topic string false queue durable Set to true to use a durable subscription boolean false false no-local Enable or disable local delivery boolean false false password The password to connect to to the JMS server String false selector The JMS selector String false session-mode The session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE String false AUTO_ACKNOWLEDGE username The username to connect to to the JMS server String false","title":"Configuration Reference"},{"location":"jms/sending-jms-messages/","text":"Sending messages to JMS The JMS Connector can send Reactive Messaging Messages as JMS Message. Example Let\u2019s imagine you have a javax.jms.ConnectionFactory bean exposed and connected to your JMS server. Don\u2019t forget that it\u2019s required to use the JMS connector. Configure your application to write the messages from the prices channel into a JMS Message as follows: 1 mp.messaging.outgoing.prices.connector = smallrye-jms Note You don\u2019t need to set the destination. By default, it uses the channel name ( prices ). You can configure the destination attribute to override it. Note By default the connector uses a queue . You can configure it to use a topic by setting destination-type=topic . Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package jms.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class JmsPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package jms.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class JmsPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } } Serialization The connector serializes the incoming message payload into the body of the outgoing JMS Message. If the payload is a String or a primitive type, the payload is encoded as String and the JMSType is set to the target class. The _classname property is also set. The JMS Message is a TextMessage . If the payload is a byte[] , it\u2019s passed as byte[] in a JMS BytesMessage . Otherwise, the payload is encoded using included JSON serializer (JSON-B and Jackson provided OOB, for more details see Serde ). The JMSType is set to the target class. The _classname property is also set. The JMS Message is a TextMessage . For example, the following code serialize the produced Person using JSON-B. 1 2 3 4 5 6 @Incoming ( \"...\" ) @Outgoing ( \"my-channel\" ) public Person sendToJms (...) { // ... return new Person ( \"bob\" , 42 ); } It requires that the Person class can be serialized to JSON. The classname is passed in the JMSType property and _classname property. Outbound Metadata When sending Messages , you can add an instance of OutgoingJmsMessageMetadata to influence how the message is going to be written to JMS. 1 2 3 4 5 6 7 OutgoingJmsMessageMetadata metadata = OutgoingJmsMessageMetadata . builder () . withProperties ( JmsProperties . builder (). with ( \"some-property\" , \"some-value\" ). build ()) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); The metadata allow adding properties but also override the destination. Acknowledgement Once the JMS message is sent to the JMS server, the message is acknowledged. Sending a JMS message is a blocking operation. So, sending is done on a worker thread. Configuration Reference Attribute ( alias ) Description Type Mandatory Default client-id The client id String false connection-factory-name The name of the JMS connection factory ( javax.jms.ConnectionFactory ) to be used. If not set, it uses any exposed JMS connection factory String false correlation-id The JMS Message correlation id string false delivery-delay The delivery delay long false delivery-mode The delivery mode. Either persistent or non_persistent string false destination The name of the JMS destination. If not set the name of the channel is used String false destination-type The type of destination. It can be either queue or topic string false queue disable-message-id Omit the message id in the outbound JMS message boolean false disable-message-timestamp Omit the message timestamp in the outbound JMS message boolean false merge Whether the connector should allow multiple upstreams boolean false false password The password to connect to to the JMS server String false priority The JMS Message priority int false reply-to The reply to destination if any string false reply-to-destination-type The type of destination for the response. It can be either queue or topic string false queue session-mode The session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE String false AUTO_ACKNOWLEDGE ttl The JMS Message time-to-live long false username The username to connect to to the JMS server String false","title":"Sending JMS messages"},{"location":"jms/sending-jms-messages/#sending-messages-to-jms","text":"The JMS Connector can send Reactive Messaging Messages as JMS Message.","title":"Sending messages to JMS"},{"location":"jms/sending-jms-messages/#example","text":"Let\u2019s imagine you have a javax.jms.ConnectionFactory bean exposed and connected to your JMS server. Don\u2019t forget that it\u2019s required to use the JMS connector. Configure your application to write the messages from the prices channel into a JMS Message as follows: 1 mp.messaging.outgoing.prices.connector = smallrye-jms Note You don\u2019t need to set the destination. By default, it uses the channel name ( prices ). You can configure the destination attribute to override it. Note By default the connector uses a queue . You can configure it to use a topic by setting destination-type=topic . Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package jms.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class JmsPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package jms.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class JmsPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } }","title":"Example"},{"location":"jms/sending-jms-messages/#serialization","text":"The connector serializes the incoming message payload into the body of the outgoing JMS Message. If the payload is a String or a primitive type, the payload is encoded as String and the JMSType is set to the target class. The _classname property is also set. The JMS Message is a TextMessage . If the payload is a byte[] , it\u2019s passed as byte[] in a JMS BytesMessage . Otherwise, the payload is encoded using included JSON serializer (JSON-B and Jackson provided OOB, for more details see Serde ). The JMSType is set to the target class. The _classname property is also set. The JMS Message is a TextMessage . For example, the following code serialize the produced Person using JSON-B. 1 2 3 4 5 6 @Incoming ( \"...\" ) @Outgoing ( \"my-channel\" ) public Person sendToJms (...) { // ... return new Person ( \"bob\" , 42 ); } It requires that the Person class can be serialized to JSON. The classname is passed in the JMSType property and _classname property.","title":"Serialization"},{"location":"jms/sending-jms-messages/#outbound-metadata","text":"When sending Messages , you can add an instance of OutgoingJmsMessageMetadata to influence how the message is going to be written to JMS. 1 2 3 4 5 6 7 OutgoingJmsMessageMetadata metadata = OutgoingJmsMessageMetadata . builder () . withProperties ( JmsProperties . builder (). with ( \"some-property\" , \"some-value\" ). build ()) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); The metadata allow adding properties but also override the destination.","title":"Outbound Metadata"},{"location":"jms/sending-jms-messages/#acknowledgement","text":"Once the JMS message is sent to the JMS server, the message is acknowledged. Sending a JMS message is a blocking operation. So, sending is done on a worker thread.","title":"Acknowledgement"},{"location":"jms/sending-jms-messages/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default client-id The client id String false connection-factory-name The name of the JMS connection factory ( javax.jms.ConnectionFactory ) to be used. If not set, it uses any exposed JMS connection factory String false correlation-id The JMS Message correlation id string false delivery-delay The delivery delay long false delivery-mode The delivery mode. Either persistent or non_persistent string false destination The name of the JMS destination. If not set the name of the channel is used String false destination-type The type of destination. It can be either queue or topic string false queue disable-message-id Omit the message id in the outbound JMS message boolean false disable-message-timestamp Omit the message timestamp in the outbound JMS message boolean false merge Whether the connector should allow multiple upstreams boolean false false password The password to connect to to the JMS server String false priority The JMS Message priority int false reply-to The reply to destination if any string false reply-to-destination-type The type of destination for the response. It can be either queue or topic string false queue session-mode The session mode. Accepted values are AUTO_ACKNOWLEDGE, SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE String false AUTO_ACKNOWLEDGE ttl The JMS Message time-to-live long false username The username to connect to to the JMS server String false","title":"Configuration Reference"},{"location":"kafka/avro-configuration/","text":"Using Apache Avro serializer/deserializer If you are using Apache Avro serializer/deserializer, please note the following configuration properties. For Confluent Schema Registry Confluent Avro library is io.confluent:kafka-avro-serializer . Note that this library is not available in Maven Central, you need to use the Confluent Maven repository . Consumer Property Recommended value value.deserializer io.confluent.kafka.serializers.KafkaAvroDeserializer schema.registry.url http://{your_host}:{your_port}/ specific.avro.reader true Example: 1 2 3 mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.KafkaAvroDeserializer mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.avro.reader=true Producer Property Recommended value value.serializer io.confluent.kafka.serializers.KafkaAvroSerializer schema.registry.url http://{your_host}:{your_port}/ Example: 1 2 mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.KafkaAvroSerializer mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/ For Apicurio Registry 1.x Apicurio Registry 1.x Avro library is io.apicurio:apicurio-registry-utils-serde . The configuration properties listed here are meant to be used with the Apicurio Registry 1.x client library and Apicurio Registry 1.x server. Consumer Property Recommended value value.deserializer io.apicurio.registry.utils.serde.AvroKafkaDeserializer apicurio.registry.url http://{your_host}:{your_port}/api apicurio.registry.avro-datum-provider io.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider apicurio.registry.use-specific-avro-reader true Example: 1 2 3 4 mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.utils.serde.AvroKafkaDeserializer mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api mp.messaging.incoming.[channel].apicurio.registry.avro-datum-provider=io.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true Producer Property Recommended value value.serializer io.apicurio.registry.utils.serde.AvroKafkaSerializer apicurio.registry.url http://{your_host}:{your_port}/api To automatically register schemas with the registry, add: Property Value apicurio.registry.global-id io.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy Example: 1 2 3 mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.utils.serde.AvroKafkaSerializer mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api mp.messaging.outgoing.[channel].apicurio.registry.global-id=io.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy For Apicurio Registry 2.x Apicurio Registry 2.x Avro library is io.apicurio:apicurio-registry-serdes-avro-serde . The configuration properties listed here are meant to be used with the Apicurio Registry 2.x client library and Apicurio Registry 2.x server. Consumer Property Recommended value value.deserializer io.apicurio.registry.serde.avro.AvroKafkaDeserializer apicurio.registry.url http://{your_host}:{your_port}/apis/registry/v2 apicurio.registry.use-specific-avro-reader true Example: 1 2 3 mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.serde.avro.AvroKafkaDeserializer mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2 mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true Producer Property Recommended value value.serializer io.apicurio.registry.serde.avro.AvroKafkaSerializer apicurio.registry.url http://{your_host}:{your_port}/apis/registry/v2 To automatically register schemas with the registry, add: Property Value apicurio.registry.auto-register true Example: 1 2 3 mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.serde.avro.AvroKafkaSerializer mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2 mp.messaging.outgoing.[channel].apicurio.registry.auto-register=true","title":"Using Avro"},{"location":"kafka/avro-configuration/#using-apache-avro-serializerdeserializer","text":"If you are using Apache Avro serializer/deserializer, please note the following configuration properties.","title":"Using Apache Avro serializer/deserializer"},{"location":"kafka/avro-configuration/#for-confluent-schema-registry","text":"Confluent Avro library is io.confluent:kafka-avro-serializer . Note that this library is not available in Maven Central, you need to use the Confluent Maven repository .","title":"For Confluent Schema Registry"},{"location":"kafka/avro-configuration/#consumer","text":"Property Recommended value value.deserializer io.confluent.kafka.serializers.KafkaAvroDeserializer schema.registry.url http://{your_host}:{your_port}/ specific.avro.reader true Example: 1 2 3 mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.KafkaAvroDeserializer mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.avro.reader=true","title":"Consumer"},{"location":"kafka/avro-configuration/#producer","text":"Property Recommended value value.serializer io.confluent.kafka.serializers.KafkaAvroSerializer schema.registry.url http://{your_host}:{your_port}/ Example: 1 2 mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.KafkaAvroSerializer mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/","title":"Producer"},{"location":"kafka/avro-configuration/#for-apicurio-registry-1x","text":"Apicurio Registry 1.x Avro library is io.apicurio:apicurio-registry-utils-serde . The configuration properties listed here are meant to be used with the Apicurio Registry 1.x client library and Apicurio Registry 1.x server.","title":"For Apicurio Registry 1.x"},{"location":"kafka/avro-configuration/#consumer_1","text":"Property Recommended value value.deserializer io.apicurio.registry.utils.serde.AvroKafkaDeserializer apicurio.registry.url http://{your_host}:{your_port}/api apicurio.registry.avro-datum-provider io.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider apicurio.registry.use-specific-avro-reader true Example: 1 2 3 4 mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.utils.serde.AvroKafkaDeserializer mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api mp.messaging.incoming.[channel].apicurio.registry.avro-datum-provider=io.apicurio.registry.utils.serde.avro.DefaultAvroDatumProvider mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true","title":"Consumer"},{"location":"kafka/avro-configuration/#producer_1","text":"Property Recommended value value.serializer io.apicurio.registry.utils.serde.AvroKafkaSerializer apicurio.registry.url http://{your_host}:{your_port}/api To automatically register schemas with the registry, add: Property Value apicurio.registry.global-id io.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy Example: 1 2 3 mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.utils.serde.AvroKafkaSerializer mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/api mp.messaging.outgoing.[channel].apicurio.registry.global-id=io.apicurio.registry.utils.serde.strategy.GetOrCreateIdStrategy","title":"Producer"},{"location":"kafka/avro-configuration/#for-apicurio-registry-2x","text":"Apicurio Registry 2.x Avro library is io.apicurio:apicurio-registry-serdes-avro-serde . The configuration properties listed here are meant to be used with the Apicurio Registry 2.x client library and Apicurio Registry 2.x server.","title":"For Apicurio Registry 2.x"},{"location":"kafka/avro-configuration/#consumer_2","text":"Property Recommended value value.deserializer io.apicurio.registry.serde.avro.AvroKafkaDeserializer apicurio.registry.url http://{your_host}:{your_port}/apis/registry/v2 apicurio.registry.use-specific-avro-reader true Example: 1 2 3 mp.messaging.incoming.[channel].value.deserializer=io.apicurio.registry.serde.avro.AvroKafkaDeserializer mp.messaging.incoming.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2 mp.messaging.incoming.[channel].apicurio.registry.use-specific-avro-reader=true","title":"Consumer"},{"location":"kafka/avro-configuration/#producer_2","text":"Property Recommended value value.serializer io.apicurio.registry.serde.avro.AvroKafkaSerializer apicurio.registry.url http://{your_host}:{your_port}/apis/registry/v2 To automatically register schemas with the registry, add: Property Value apicurio.registry.auto-register true Example: 1 2 3 mp.messaging.outgoing.[channel].value.serializer=io.apicurio.registry.serde.avro.AvroKafkaSerializer mp.messaging.outgoing.[channel].apicurio.registry.url=http://{your_host}:{your_port}/apis/registry/v2 mp.messaging.outgoing.[channel].apicurio.registry.auto-register=true","title":"Producer"},{"location":"kafka/client-service/","text":"KafkaClientService For advanced use cases, SmallRye Reactive Messaging provides a bean of type KafkaClientService that you can inject: 1 2 @Inject KafkaClientService kafka ; From there, you can obtain an io.smallrye.reactive.messaging.kafka.KafkaProducer and an io.smallrye.reactive.messaging.kafka.KafkaConsumer . KafkaProducer and KafkaConsumer expose a non-blocking API on top of the Kafka client API. They also mediate access to the threads that SmallRye Reactive Messaging uses to run all Kafka operations: the polling thread , used for consuming records from Kafka topics, and the sending thread , used for producing records to Kafka topics. (Just to be clear: each channel has its own polling thread and sending thread.) The reason why SmallRye Reactive Messaging uses a special thread to run the poll loop should be obvious: the Consumer API is blocking. The Producer API, on the other hand, is documented to be non-blocking. However, in present versions, Kafka doesn\u2019t guarantee that in all cases; see KAFKA-3539 for more details. That is why SmallRye Reactive Messaging uses a dedicated thread to run the send operations as well. Sometimes, SmallRye Reactive Messaging provides direct access to the Kafka Producer or Consumer . For example, a KafkaConsumerRebalanceListener methods are always invoked on the polling thread, so they give you direct access to Consumer . In such case, you should use the Producer / Consumer API directly, instead of the KafkaProducer / KafkaConsumer API.","title":"Accessing the client"},{"location":"kafka/client-service/#kafkaclientservice","text":"For advanced use cases, SmallRye Reactive Messaging provides a bean of type KafkaClientService that you can inject: 1 2 @Inject KafkaClientService kafka ; From there, you can obtain an io.smallrye.reactive.messaging.kafka.KafkaProducer and an io.smallrye.reactive.messaging.kafka.KafkaConsumer . KafkaProducer and KafkaConsumer expose a non-blocking API on top of the Kafka client API. They also mediate access to the threads that SmallRye Reactive Messaging uses to run all Kafka operations: the polling thread , used for consuming records from Kafka topics, and the sending thread , used for producing records to Kafka topics. (Just to be clear: each channel has its own polling thread and sending thread.) The reason why SmallRye Reactive Messaging uses a special thread to run the poll loop should be obvious: the Consumer API is blocking. The Producer API, on the other hand, is documented to be non-blocking. However, in present versions, Kafka doesn\u2019t guarantee that in all cases; see KAFKA-3539 for more details. That is why SmallRye Reactive Messaging uses a dedicated thread to run the send operations as well. Sometimes, SmallRye Reactive Messaging provides direct access to the Kafka Producer or Consumer . For example, a KafkaConsumerRebalanceListener methods are always invoked on the polling thread, so they give you direct access to Consumer . In such case, you should use the Producer / Consumer API directly, instead of the KafkaProducer / KafkaConsumer API.","title":"KafkaClientService"},{"location":"kafka/consumer-rebalance-listener/","text":"Consumer Rebalance Listener To handle offset commit and assigned partitions yourself, you can provide a consumer rebalance listener. To achieve this, implement the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface, make the implementing class a bean, and add the @Identifier qualifier. A usual use case is to store offset in a separate data store to implement exactly-once semantic, or starting the processing at a specific offset. The listener is invoked every time the consumer topic/partition assignment changes. For example, when the application starts, it invokes the partitionsAssigned callback with the initial set of topics/partitions associated with the consumer. If, later, this set changes, it calls the partitionsRevoked and partitionsAssigned callbacks again, so you can implement custom logic. Note that the rebalance listener methods are called from the Kafka polling thread and must block the caller thread until completion. That\u2019s because the rebalance protocol has synchronization barriers, and using asynchronous code in a rebalance listener may be executed after the synchronization barrier. When topics/partitions are assigned or revoked from a consumer, it pauses the message delivery and restarts once the rebalance completes. If the rebalance listener handles offset commit on behalf of the user (using the ignore commit strategy), the rebalance listener must commit the offset synchronously in the partitionsRevoked callback. We also recommend applying the same logic when the application stops. Unlike the ConsumerRebalanceListener from Apache Kafka, the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener methods pass the Kafka Consumer and the set of topics/partitions. Example In this example we set-up a consumer that always starts on messages from at most 10 minutes ago (or offset 0). First we need to provide a bean that implements the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface and is annotated with @Identifier . We then must configure our inbound connector to use this named bean. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 package kafka.inbound ; import java.util.Collection ; import java.util.HashMap ; import java.util.Map ; import java.util.logging.Logger ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.Consumer ; import org.apache.kafka.clients.consumer.OffsetAndTimestamp ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener ; @ApplicationScoped @Identifier ( \"rebalanced-example.rebalancer\" ) public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener { private static final Logger LOGGER = Logger . getLogger ( KafkaRebalancedConsumerRebalanceListener . class . getName ()); /** * When receiving a list of partitions will search for the earliest offset within 10 minutes * and seek the consumer to it. * * @param consumer underlying consumer * @param partitions set of assigned topic partitions */ @Override public void onPartitionsAssigned ( Consumer consumer , Collection < org . apache . kafka . common . TopicPartition > partitions ) { long now = System . currentTimeMillis (); long shouldStartAt = now - 600_000L ; //10 minute ago Map < org . apache . kafka . common . TopicPartition , Long > request = new HashMap <> (); for ( org . apache . kafka . common . TopicPartition partition : partitions ) { LOGGER . info ( \"Assigned \" + partition ); request . put ( partition , shouldStartAt ); } Map < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > offsets = consumer . offsetsForTimes ( request ); for ( Map . Entry < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > position : offsets . entrySet ()) { long target = position . getValue () == null ? 0 L : position . getValue (). offset (); LOGGER . info ( \"Seeking position \" + target + \" for \" + position . getKey ()); consumer . seek ( position . getKey (), target ); } } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package kafka.inbound ; import java.util.concurrent.CompletableFuture ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Acknowledgment ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; @ApplicationScoped public class KafkaRebalancedConsumer { @Incoming ( \"rebalanced-example\" ) @Acknowledgment ( Acknowledgment . Strategy . NONE ) public CompletionStage < Void > consume ( IncomingKafkaRecord < Integer , String > message ) { // We don't need to ACK messages because in this example we set offset during consumer re-balance return CompletableFuture . completedFuture ( null ); } } To configure the inbound connector to use the provided listener we either set the consumer rebalance listener\u2019s name: mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer Or have the listener\u2019s name be the same as the group id: mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer Setting the consumer rebalance listener\u2019s name takes precedence over using the group id.","title":"Rebalance Listeners"},{"location":"kafka/consumer-rebalance-listener/#consumer-rebalance-listener","text":"To handle offset commit and assigned partitions yourself, you can provide a consumer rebalance listener. To achieve this, implement the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface, make the implementing class a bean, and add the @Identifier qualifier. A usual use case is to store offset in a separate data store to implement exactly-once semantic, or starting the processing at a specific offset. The listener is invoked every time the consumer topic/partition assignment changes. For example, when the application starts, it invokes the partitionsAssigned callback with the initial set of topics/partitions associated with the consumer. If, later, this set changes, it calls the partitionsRevoked and partitionsAssigned callbacks again, so you can implement custom logic. Note that the rebalance listener methods are called from the Kafka polling thread and must block the caller thread until completion. That\u2019s because the rebalance protocol has synchronization barriers, and using asynchronous code in a rebalance listener may be executed after the synchronization barrier. When topics/partitions are assigned or revoked from a consumer, it pauses the message delivery and restarts once the rebalance completes. If the rebalance listener handles offset commit on behalf of the user (using the ignore commit strategy), the rebalance listener must commit the offset synchronously in the partitionsRevoked callback. We also recommend applying the same logic when the application stops. Unlike the ConsumerRebalanceListener from Apache Kafka, the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener methods pass the Kafka Consumer and the set of topics/partitions.","title":"Consumer Rebalance Listener"},{"location":"kafka/consumer-rebalance-listener/#example","text":"In this example we set-up a consumer that always starts on messages from at most 10 minutes ago (or offset 0). First we need to provide a bean that implements the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface and is annotated with @Identifier . We then must configure our inbound connector to use this named bean. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 package kafka.inbound ; import java.util.Collection ; import java.util.HashMap ; import java.util.Map ; import java.util.logging.Logger ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.Consumer ; import org.apache.kafka.clients.consumer.OffsetAndTimestamp ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener ; @ApplicationScoped @Identifier ( \"rebalanced-example.rebalancer\" ) public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener { private static final Logger LOGGER = Logger . getLogger ( KafkaRebalancedConsumerRebalanceListener . class . getName ()); /** * When receiving a list of partitions will search for the earliest offset within 10 minutes * and seek the consumer to it. * * @param consumer underlying consumer * @param partitions set of assigned topic partitions */ @Override public void onPartitionsAssigned ( Consumer consumer , Collection < org . apache . kafka . common . TopicPartition > partitions ) { long now = System . currentTimeMillis (); long shouldStartAt = now - 600_000L ; //10 minute ago Map < org . apache . kafka . common . TopicPartition , Long > request = new HashMap <> (); for ( org . apache . kafka . common . TopicPartition partition : partitions ) { LOGGER . info ( \"Assigned \" + partition ); request . put ( partition , shouldStartAt ); } Map < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > offsets = consumer . offsetsForTimes ( request ); for ( Map . Entry < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > position : offsets . entrySet ()) { long target = position . getValue () == null ? 0 L : position . getValue (). offset (); LOGGER . info ( \"Seeking position \" + target + \" for \" + position . getKey ()); consumer . seek ( position . getKey (), target ); } } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package kafka.inbound ; import java.util.concurrent.CompletableFuture ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Acknowledgment ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; @ApplicationScoped public class KafkaRebalancedConsumer { @Incoming ( \"rebalanced-example\" ) @Acknowledgment ( Acknowledgment . Strategy . NONE ) public CompletionStage < Void > consume ( IncomingKafkaRecord < Integer , String > message ) { // We don't need to ACK messages because in this example we set offset during consumer re-balance return CompletableFuture . completedFuture ( null ); } } To configure the inbound connector to use the provided listener we either set the consumer rebalance listener\u2019s name: mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer Or have the listener\u2019s name be the same as the group id: mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer Setting the consumer rebalance listener\u2019s name takes precedence over using the group id.","title":"Example"},{"location":"kafka/default-configuration/","text":"Retrieving Kafka default configuration If your application/runtime exposes as a CDI bean of type Map createKafkaRuntimeConfig () { Map < String , Object > properties = new HashMap <> (); StreamSupport . stream ( config . getPropertyNames (). spliterator (), false ) . map ( String :: toLowerCase ) . filter ( name -> name . startsWith ( \"kafka\" )) . distinct () . sorted () . forEach ( name -> { final String key = name . substring ( \"kafka\" . length () + 1 ). toLowerCase (). replaceAll ( \"[^a-z0-9.]\" , \".\" ); final String value = config . getOptionalValue ( name , String . class ). orElse ( \"\" ); properties . put ( key , value ); }); return properties ; } This previous example would extract all the configuration keys from MicroProfile Config starting with kafka . Quarkus Starting with Quarkus 1.5, a map corresponding to the previous example is automatically provided. In addition to this default configuration, you can configure the name of the Map producer using the kafka-configuration attribute: 1 2 mp.messaging.incoming.my-channel.connector = smallrye-kafka mp.messaging.incoming.my-channel.kafka-configuration = my-configuration In this case, the connector looks for the Map associated with the my-configuration name. If kafka-configuration is not set, an optional lookup for a Map exposed with the channel name ( my-channel in the previous example) is done. Important If kafka-configuration is set and no Map can be found, the deployment fails. Attribute values are resolved as follows: if the attribute is set directly on the channel configuration ( mp.messaging.incoming.my-channel.attribute=value ), this value is used if the attribute is not set on the channel, the connector looks for a Map with the channel name or the configured kafka-configuration (if set) and the value is retrieved from that Map If the resolved Map does not contain the value the default Map is used (exposed with the default-kafka-broker name)","title":"Customizing Default Kafka Configuration"},{"location":"kafka/default-configuration/#retrieving-kafka-default-configuration","text":"If your application/runtime exposes as a CDI bean of type Map createKafkaRuntimeConfig () { Map < String , Object > properties = new HashMap <> (); StreamSupport . stream ( config . getPropertyNames (). spliterator (), false ) . map ( String :: toLowerCase ) . filter ( name -> name . startsWith ( \"kafka\" )) . distinct () . sorted () . forEach ( name -> { final String key = name . substring ( \"kafka\" . length () + 1 ). toLowerCase (). replaceAll ( \"[^a-z0-9.]\" , \".\" ); final String value = config . getOptionalValue ( name , String . class ). orElse ( \"\" ); properties . put ( key , value ); }); return properties ; } This previous example would extract all the configuration keys from MicroProfile Config starting with kafka . Quarkus Starting with Quarkus 1.5, a map corresponding to the previous example is automatically provided. In addition to this default configuration, you can configure the name of the Map producer using the kafka-configuration attribute: 1 2 mp.messaging.incoming.my-channel.connector = smallrye-kafka mp.messaging.incoming.my-channel.kafka-configuration = my-configuration In this case, the connector looks for the Map associated with the my-configuration name. If kafka-configuration is not set, an optional lookup for a Map exposed with the channel name ( my-channel in the previous example) is done. Important If kafka-configuration is set and no Map can be found, the deployment fails. Attribute values are resolved as follows: if the attribute is set directly on the channel configuration ( mp.messaging.incoming.my-channel.attribute=value ), this value is used if the attribute is not set on the channel, the connector looks for a Map with the channel name or the configured kafka-configuration (if set) and the value is retrieved from that Map If the resolved Map does not contain the value the default Map is used (exposed with the default-kafka-broker name)","title":"Retrieving Kafka default configuration"},{"location":"kafka/health/","text":"Health reporting The Kafka connector reports the readiness and liveness of each channel managed by the connector. Note To disable health reporting, set the health-enabled attribute for the channel to false . Readiness On the inbound side, two strategies are available to check the readiness of the application. The default strategy verifies that we have at least one active connection with the broker. This strategy is lightweight. You can also enable another strategy by setting the health-readiness-topic-verification attribute to true . In this case, the check verifies that: the broker is available the Kafka topic is created (available in the broker). no failures have been caught With this second strategy, if you consume multiple topics using the topics attribute, the readiness check verifies that all the consumed topics are available. If you use a pattern (using the pattern attribute), the readiness check verifies that at least one existing topic matches the pattern. On the outbound side (writing records to Kafka), two strategies are also offered. The default strategy just verifies that the producer has at least one active connection with the broker. You can also enable another strategy by setting the health-readiness-topic-verification attribute to true . In this case, teh check verifies that the broker is available the Kafka topic is created (available in the broker). With this second strategy, the readiness check uses a Kafka Admin Client to retrieve the existing topics. Retrieving the topics can be a lengthy operation. You can configure a timeout using the health-readiness-timeout attribute. The default timeout is set to 2 seconds. Also, you can disable the readiness checks altogether by setting health-readiness-enabled to false . Liveness On the inbound side (receiving records from Kafka), the liveness check verifies that: no failures have been caught the client is connected to the broker On the outbound side (writing records to Kafka), the liveness check verifies that: no failures have been caught Note that a message processing failures nacks the message which is then handled by the failure-strategy. It the responsibility of the failure-strategy to report the failure and influence the outcome of the liveness checks. The fail failure strategy reports the failure and so the liveness check will report the failure.","title":"Health Checks"},{"location":"kafka/health/#health-reporting","text":"The Kafka connector reports the readiness and liveness of each channel managed by the connector. Note To disable health reporting, set the health-enabled attribute for the channel to false .","title":"Health reporting"},{"location":"kafka/health/#readiness","text":"On the inbound side, two strategies are available to check the readiness of the application. The default strategy verifies that we have at least one active connection with the broker. This strategy is lightweight. You can also enable another strategy by setting the health-readiness-topic-verification attribute to true . In this case, the check verifies that: the broker is available the Kafka topic is created (available in the broker). no failures have been caught With this second strategy, if you consume multiple topics using the topics attribute, the readiness check verifies that all the consumed topics are available. If you use a pattern (using the pattern attribute), the readiness check verifies that at least one existing topic matches the pattern. On the outbound side (writing records to Kafka), two strategies are also offered. The default strategy just verifies that the producer has at least one active connection with the broker. You can also enable another strategy by setting the health-readiness-topic-verification attribute to true . In this case, teh check verifies that the broker is available the Kafka topic is created (available in the broker). With this second strategy, the readiness check uses a Kafka Admin Client to retrieve the existing topics. Retrieving the topics can be a lengthy operation. You can configure a timeout using the health-readiness-timeout attribute. The default timeout is set to 2 seconds. Also, you can disable the readiness checks altogether by setting health-readiness-enabled to false .","title":"Readiness"},{"location":"kafka/health/#liveness","text":"On the inbound side (receiving records from Kafka), the liveness check verifies that: no failures have been caught the client is connected to the broker On the outbound side (writing records to Kafka), the liveness check verifies that: no failures have been caught Note that a message processing failures nacks the message which is then handled by the failure-strategy. It the responsibility of the failure-strategy to report the failure and influence the outcome of the liveness checks. The fail failure strategy reports the failure and so the liveness check will report the failure.","title":"Liveness"},{"location":"kafka/kafka/","text":"Apache Kafka Connector The Kafka connector adds support for Kafka to Reactive Messaging. With it you can receive Kafka Records as well as write message into Kafka. Apache Kafka is a popular distributed streaming platform. It lets you: Publish and subscribe to streams of records, similar to a message queue or enterprise messaging system. Store streams of records in a fault-tolerant durable way. Process streams of records as they occur. The Kafka cluster stores streams of records in categories called topics . Each record consists of a key , a value , and a timestamp . For more details about Kafka, check the documentation . Using the Kafka Connector To use the Kafka Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-kafka 3.25.0 The connector name is: smallrye-kafka . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-kafka # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-kafka","title":"Apache Kafka Connector"},{"location":"kafka/kafka/#apache-kafka-connector","text":"The Kafka connector adds support for Kafka to Reactive Messaging. With it you can receive Kafka Records as well as write message into Kafka. Apache Kafka is a popular distributed streaming platform. It lets you: Publish and subscribe to streams of records, similar to a message queue or enterprise messaging system. Store streams of records in a fault-tolerant durable way. Process streams of records as they occur. The Kafka cluster stores streams of records in categories called topics . Each record consists of a key , a value , and a timestamp . For more details about Kafka, check the documentation .","title":"Apache Kafka Connector"},{"location":"kafka/kafka/#using-the-kafka-connector","text":"To use the Kafka Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-kafka 3.25.0 The connector name is: smallrye-kafka . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-kafka # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-kafka","title":"Using the Kafka Connector"},{"location":"kafka/kerberos/","text":"Kerberos authentication When using Kerberos authentication, you need to configure the connector with: the security protocol set to SASL_PLAINTEXT the SASL mechanism set to GSSAPI the Jaas config configured with Krb5LoginModule the Kerberos service name The following snippet provides an example: 1 2 3 4 5 kafka.bootstrap.servers = ip-192-168-0-207.us-east-2.compute.internal:9094 kafka.sasl.mechanism = GSSAPI kafka.security.protocol = SASL_PLAINTEXT kafka.sasl.jaas.config = com.sun.security.auth.module.Krb5LoginModule required doNotPrompt=true refreshKrb5Config=true useKeyTab=true storeKey=true keyTab=\"file:/opt/kafka/krb5/kafka-producer.keytab\" principal=\"kafka-producer/ip-192-168-0-207.us-east-2.compute.internal@INTERNAL\"; kafka.sasl.kerberos.service.name = kafka","title":"Kerberos authentication"},{"location":"kafka/kerberos/#kerberos-authentication","text":"When using Kerberos authentication, you need to configure the connector with: the security protocol set to SASL_PLAINTEXT the SASL mechanism set to GSSAPI the Jaas config configured with Krb5LoginModule the Kerberos service name The following snippet provides an example: 1 2 3 4 5 kafka.bootstrap.servers = ip-192-168-0-207.us-east-2.compute.internal:9094 kafka.sasl.mechanism = GSSAPI kafka.security.protocol = SASL_PLAINTEXT kafka.sasl.jaas.config = com.sun.security.auth.module.Krb5LoginModule required doNotPrompt=true refreshKrb5Config=true useKeyTab=true storeKey=true keyTab=\"file:/opt/kafka/krb5/kafka-producer.keytab\" principal=\"kafka-producer/ip-192-168-0-207.us-east-2.compute.internal@INTERNAL\"; kafka.sasl.kerberos.service.name = kafka","title":"Kerberos authentication"},{"location":"kafka/protobuf-configuration/","text":"Using Google Protobuf serializer/deserializer If you are using Protocol Buffers serializer/deserializer, please note the following configuration properties. For Confluent Schema Registry Confluent protobuf library is io.confluent:kafka-protobuf-serializer . Note that this library is not available in Maven Central, you need to use the Confluent Maven repository . Consumer Property Recommended value value.deserializer io.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer schema.registry.url http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.protobuf.value.type your.package.DomainObjectKey$Key mp.messaging.incoming.[channel].specific.protobuf.key.type your.package.DomainObjectValue$Value Example: 1 2 3 4 mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.protobuf.value.type=your.package.DomainObjectKey$Key mp.messaging.incoming.[channel].specific.protobuf.key.type=your.package.DomainObjectValue$Value Producer Property Recommended value value.serializer io.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer schema.registry.url http://{your_host}:{your_port}/ Example: 1 2 mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/","title":"Using Protobuf"},{"location":"kafka/protobuf-configuration/#using-google-protobuf-serializerdeserializer","text":"If you are using Protocol Buffers serializer/deserializer, please note the following configuration properties.","title":"Using Google Protobuf serializer/deserializer"},{"location":"kafka/protobuf-configuration/#for-confluent-schema-registry","text":"Confluent protobuf library is io.confluent:kafka-protobuf-serializer . Note that this library is not available in Maven Central, you need to use the Confluent Maven repository .","title":"For Confluent Schema Registry"},{"location":"kafka/protobuf-configuration/#consumer","text":"Property Recommended value value.deserializer io.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer schema.registry.url http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.protobuf.value.type your.package.DomainObjectKey$Key mp.messaging.incoming.[channel].specific.protobuf.key.type your.package.DomainObjectValue$Value Example: 1 2 3 4 mp.messaging.incoming.[channel].value.deserializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufDeserializer mp.messaging.incoming.[channel].schema.registry.url=http://{your_host}:{your_port}/ mp.messaging.incoming.[channel].specific.protobuf.value.type=your.package.DomainObjectKey$Key mp.messaging.incoming.[channel].specific.protobuf.key.type=your.package.DomainObjectValue$Value","title":"Consumer"},{"location":"kafka/protobuf-configuration/#producer","text":"Property Recommended value value.serializer io.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer schema.registry.url http://{your_host}:{your_port}/ Example: 1 2 mp.messaging.outgoing.[channel].value.serializer=io.confluent.kafka.serializers.protobuf.KafkaProtobufSerializer mp.messaging.outgoing.[channel].schema.registry.url=http://{your_host}:{your_port}/","title":"Producer"},{"location":"kafka/receiving-kafka-records/","text":"Receiving Kafka Records The Kafka Connector retrieves Kafka Records from Kafka Brokers and maps each of them to Reactive Messaging Messages . Example Let\u2019s imagine you have a Kafka broker running, and accessible using the kafka:9092 address (by default it would use localhost:9092 ). Configure your application to receive Kafka records from a Kafka topic on the prices channel as follows: 1 2 3 4 5 kafka.bootstrap.servers = kafka:9092 # <1> mp.messaging.incoming.prices.connector = smallrye-kafka # <2> mp.messaging.incoming.prices.value.deserializer = org.apache.kafka.common.serialization.DoubleDeserializer # <3> mp.messaging.incoming.prices.broadcast = true # <4> Configure the broker location. You can configure it globally or per channel Configure the connector to manage the prices channel Sets the (Kafka) deserializer to read the record\u2019s value Make sure that we can receive from more than one consumer (see KafkaPriceConsumer and KafkaPriceMessageConsumer below) Note You don\u2019t need to set the Kafka topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package kafka.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class KafkaPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package kafka.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class KafkaPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message (commit the offset) return price . ack (); } } Deserialization The deserialization is handled by the underlying Kafka Client. You need to configure the: mp.messaging.incoming.[channel-name].value.deserializer to configure the value deserializer (mandatory) mp.messaging.incoming.[channel-name].key.deserializer to configure the key deserializer (optional, default to String ) If you want to use a custom deserializer, add it to your CLASSPATH and configure the associate attribute. In addition, the Kafka Connector also provides a set of message converters . So you can receive payloads representing records from Kafka using: Record - a pair key/value ConsumerRecord - a structure representing the record with all its metadata 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @Incoming ( \"topic-a\" ) public void consume ( Record < String , String > record ) { String key = record . key (); // Can be `null` if the incoming record has no key String value = record . value (); // Can be `null` if the incoming record has no value } @Incoming ( \"topic-b\" ) public void consume ( ConsumerRecord < String , String > record ) { String key = record . key (); // Can be `null` if the incoming record has no key String value = record . value (); // Can be `null` if the incoming record has no value String topic = record . topic (); int partition = record . partition (); // ... } Inbound Metadata Messages coming from Kafka contains an instance of IncomingKafkaRecordMetadata in the metadata. It provides the key, topic, partitions, headers and so on: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 IncomingKafkaRecordMetadata < String , Double > metadata = incoming . getMetadata ( IncomingKafkaRecordMetadata . class ) . orElse ( null ); if ( metadata != null ) { // The topic String topic = metadata . getTopic (); // The key String key = metadata . getKey (); // The timestamp Instant timestamp = metadata . getTimestamp (); // The underlying record ConsumerRecord < String , Double > record = metadata . getRecord (); // ... } Acknowledgement When a message produced from a Kafka record is acknowledged, the connector invokes a commit strategy . These strategies decide when the consumer offset for a specific topic/partition is committed. Committing an offset indicates that all previous records have been processed. It is also the position where the application would restart the processing after a crash recovery or a restart. Committing every offset has performance penalties as Kafka offset management can be slow. However, not committing the offset often enough may lead to message duplication if the application crashes between two commits. The Kafka connector supports three strategies: throttled keeps track of received messages and commit to the next offset after the latest acked message in sequence. This strategy guarantees at-least-once delivery even if the channel performs asynchronous processing. The connector tracks the received records and periodically (period specified by auto.commit.interval.ms (default: 5000)) commits the highest consecutive offset. The connector will be marked as unhealthy if a message associated with a record is not acknowledged in throttled.unprocessed-record-max-age.ms (default: 60000). Indeed, this strategy cannot commit the offset as soon as a single record processing fails (see failure-strategy to configure what happens on failing processing). If throttled.unprocessed-record-max-age.ms is set to less than or equal to 0, it does not perform any health check verification. Such a setting might lead to running out of memory if there are poison pill messages. This strategy is the default if enable.auto.commit is not explicitly set to true . checkpoint allows persisting consumer offsets on a \"state store\", instead of committing them back to the Kafka broker. Using the CheckpointMetadata API, consumer code can persist a processing state with the offset to mark the progress of a consumer. When the processing continues from a previously persisted offset, it seeks the Kafka consumer to that offset and also restores the persisted state, continuing the stateful processing from where it left off. The checkpoint strategy holds locally the processing state associated with the latest offset, and persists it periodically to the state store (period specified by auto.commit.interval.ms (default: 5000)). The connector will be marked as unhealthy if no processing state is persisted to the state store in checkpoint.unsynced-state-max-age.ms (default: 10000). Using the CheckpointMetadata API the user code can force to persist the state on message ack. If checkpoint.unsynced-state-max-age.ms is set to less than or equal to 0, it does not perform any health check verification. For more information, see Stateful processing with Checkpointing latest commits the record offset received by the Kafka consumer as soon as the associated message is acknowledged (if the offset is higher than the previously committed offset). This strategy provides at-least-once delivery if the channel processes the message without performing any asynchronous processing. This strategy should not be used on high-load as offset commit is expensive. However, it reduces the risk of duplicates. ignore performs no commit. This strategy is the default strategy when the consumer is explicitly configured with enable.auto.commit to true . It delegates the offset commit to the Kafka client. When enable.auto.commit is true this strategy DOES NOT guarantee at-least-once delivery. However, if the processing failed between two commits, messages received after the commit and before the failure will be re-processed. Important The Kafka connector disables the Kafka auto commit if not explicitly enabled. This behavior differs from the traditional Kafka consumer. If high-throughout is important for you, and not limited by the downstream, we recommend to either: Use the throttled policy or set enable.auto.commit to true and annotate the consuming method with @Acknowledgment(Acknowledgment.Strategy.NONE) Failure Management If a message produced from a Kafka record is nacked , a failure strategy is applied. The Kafka connector supports 3 strategies: fail - fail the application, no more records will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue. The offset of the record that has not been processed correctly is committed. dead-letter-queue - the offset of the record that has not been processed correctly is committed, but the record is written to a (Kafka) dead letter queue topic. The strategy is selected using the failure-strategy attribute. In the case of dead-letter-queue , you can configure the following attributes: dead-letter-queue.topic : the topic to use to write the records not processed correctly, default is dead-letter-topic-$channel , with $channel being the name of the channel. dead-letter-queue.producer-client-id : the client id used by the kafka producer when sending records to dead letter queue topic. If not specified it will default to kafka-dead-letter-topic-producer-$client-id , with $client-id being the value obtained from consumer client id. dead-letter-queue.key.serializer : the serializer used to write the record key on the dead letter queue. By default, it deduces the serializer from the key deserializer. dead-letter-queue.value.serializer : the serializer used to write the record value on the dead letter queue. By default, it deduces the serializer from the value deserializer. The record written on the dead letter topic contains the original record\u2019s headers, as well as a set of additional headers about the original record: dead-letter-reason - the reason of the failure (the Throwable passed to nack() ) dead-letter-cause - the cause of the failure (the getCause() of the Throwable passed to nack() ), if any dead-letter-topic - the original topic of the record dead-letter-partition - the original partition of the record (integer mapped to String) dead-letter-offset - the original offset of the record (long mapped to String) When using dead-letter-queue , it is also possible to change some metadata of the record that is sent to the dead letter topic. To do that, use the Message.nack(Throwable, Metadata) method: 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) public CompletionStage < Void > consume ( KafkaRecord < String , String > message ) { return message . nack ( new Exception ( \"Failed!\" ), Metadata . of ( OutgoingKafkaRecordMetadata . builder () . withKey ( \"failed-record\" ) . withHeaders ( new RecordHeaders () . add ( \"my-header\" , \"my-header-value\" . getBytes ( StandardCharsets . UTF_8 ))) . build ())); } The Metadata may contain an instance of OutgoingKafkaRecordMetadata . If the instance is present, the following properties will be used: key; if not present, the original record\u2019s key will be used topic; if not present, the configured dead letter topic will be used partition; if not present, partition will be assigned automatically headers; combined with the original record\u2019s headers, as well as the dead-letter-* headers described above Custom commit and failure strategies In addition to provided strategies, it is possible to implement custom commit and failure strategies and configure Kafka channels with them. For example, for a custom commit strategy, implement the KafkaCommitHandler interface, and provide a managed bean implementing the KafkaCommitHandler.Factory interface, identified using @Identifier qualifier. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 package kafka.inbound ; import java.util.Collection ; import java.util.function.BiConsumer ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.common.TopicPartition ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration ; import io.smallrye.reactive.messaging.kafka.KafkaConsumer ; import io.smallrye.reactive.messaging.kafka.commit.KafkaCommitHandler ; import io.vertx.mutiny.core.Vertx ; public class KafkaCustomCommit implements KafkaCommitHandler { @Override public < K , V > Uni < Void > handle ( IncomingKafkaRecord < K , V > record ) { // called on message ack return Uni . createFrom (). voidItem (); } @Override public < K , V > Uni < IncomingKafkaRecord < K , V >> received ( IncomingKafkaRecord < K , V > record ) { // called before message processing return Uni . createFrom (). item ( record ); } @Override public void terminate ( boolean graceful ) { // called on channel shutdown } @Override public void partitionsAssigned ( Collection < TopicPartition > partitions ) { // called on partitions assignment } @Override public void partitionsRevoked ( Collection < TopicPartition > partitions ) { // called on partitions revoked } @ApplicationScoped @Identifier ( \"custom\" ) public static class Factory implements KafkaCommitHandler . Factory { @Override public KafkaCommitHandler create ( KafkaConnectorIncomingConfiguration config , Vertx vertx , KafkaConsumer consumer , BiConsumer < Throwable , Boolean > reportFailure ) { return new KafkaCustomCommit ( /* ... */ ); } } } Finally, to use the custom commit strategy, set the commit-strategy attribute to the identifier of the commit handler factory: mp.messaging.incoming.$channel.commit-strategy=custom . Similarly, custom failure strategies can be configured using failure-strategy attribute. Note If the custom strategy implementation inherits ContextHolder class it can access the Vert.x event-loop context created for the Kafka consumer Retrying processing You can combine Reactive Messaging with SmallRye Fault Tolerance , and retry processing when it fails: 1 2 3 4 5 6 @Incoming ( \"kafka\" ) @Outgoing ( \"processed\" ) @Retry ( delay = 10 , maxRetries = 5 ) public String process ( String v ) { // ... retry if this method throws an exception } You can configure the delay, the number of retries, the jitter... If your method returns a Uni , you need to add the @NonBlocking annotation: 1 2 3 4 5 6 7 @Incoming ( \"kafka\" ) @Outgoing ( \"processed\" ) @Retry ( delay = 10 , maxRetries = 5 ) @NonBlocking public Uni < String > process ( String v ) { // ... retry if this method throws an exception or the returned Uni produce a failure } The incoming messages are acknowledged only once the processing completes successfully. So, it commits the offset after the successful processing. If after the retries the processing still failed, the message is nacked and the failure strategy is applied. You can also use @Retry on methods only consuming incoming messages: 1 2 3 4 5 @Incoming ( \"kafka\" ) @Retry ( delay = 10 , maxRetries = 5 ) public void consume ( String v ) { // ... retry if this method throws an exception } Handling deserialization failures Because deserialization happens before creating a Message , the failure strategy presented above cannot be applied. However, when a deserialization failure occurs, you can intercept it and provide a fallback value. To achieve this, create a CDI bean implementing the DeserializationFailureHandler interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @ApplicationScoped @Identifier ( \"failure-retry\" ) // Set the name of the failure handler public class MyDeserializationFailureHandler implements DeserializationFailureHandler < JsonObject > { // Specify the expected type @Override public JsonObject decorateDeserialization ( Uni < JsonObject > deserialization , String topic , boolean isKey , String deserializer , byte [] data , Headers headers ) { return deserialization . onFailure (). retry (). atMost ( 3 ) . await (). atMost ( Duration . ofMillis ( 200 )); } } The bean must be exposed with the @Identifier qualifier specifying the name of the bean. Then, in the connector configuration, specify the following attribute: mp.messaging.incoming.$channel.key-deserialization-failure-handler : name of the bean handling deserialization failures happening for the record\u2019s key mp.messaging.incoming.$channel.value-deserialization-failure-handler : name of the bean handling deserialization failures happening for the record\u2019s value, The handler is called with the deserialization action as a Uni , the record\u2019s topic, a boolean indicating whether the failure happened on a key, the class name of the deserializer that throws the exception, the corrupted data, the exception, and the records headers augmented with headers describing the failure (which ease the write to a dead letter). On the deserialization Uni failure strategies like retry, providing a fallback value or applying timeout can be implemented. Note that the method must await on the result and return the deserialized object. Alternatively, the handler can only implement handleDeserializationFailure method and provide a fallback value, which may be null . If you don\u2019t configure a deserialization failure handlers and a deserialization failure happens, the application is marked unhealthy. You can also ignore the failure, which will log the exception and produce a null value. To enable this behavior, set the mp.messaging.incoming.$channel.fail-on-deserialization-failure attribute to false . Receiving Cloud Events The Kafka connector supports Cloud Events . When the connector detects a structured or binary Cloud Events, it adds a IncomingKafkaCloudEventMetadata in the metadata of the Message. IncomingKafkaCloudEventMetadata contains the various (mandatory and optional) Cloud Event attributes. If the connector cannot extract the Cloud Event metadata, it sends the Message without the metadata. Binary Cloud Events For binary Cloud Events, all mandatory Cloud Event attributes must be set in the record header, prefixed by ce_ (as mandated by the protocol binding ). The connector considers headers starting with the ce_ prefix but not listed in the specification as extensions. You can access them using the getExtension method from IncomingKafkaCloudEventMetadata . You can retrieve them as String . The datacontenttype attribute is mapped to the content-type header of the record. The partitionkey attribute is mapped to the record\u2019s key, if any. Note that all headers are read as UTF-8. With binary Cloud Events, the record\u2019s key and value can use any deserializer. Structured Cloud Events For structured Cloud Events, the event is encoded in the record\u2019s value. Only JSON is supported, so your event must be encoded as JSON in the record\u2019s value. Structured Cloud Event must set the content-type header of the record to application/cloudevents or prefix the value with application/cloudevents such as: application/cloudevents+json; charset=UTF-8 . To receive structured Cloud Events, your value deserializer must be: org.apache.kafka.common.serialization.StringDeserializer org.apache.kafka.common.serialization.ByteArrayDeserializer io.vertx.kafka.client.serialization.JsonObjectDeserializer As mentioned previously, the value must be a valid JSON object containing at least all the mandatory Cloud Events attributes. If the record is a structured Cloud Event, the created Message\u2019s payload is the Cloud Event data . The partitionkey attribute is mapped to the record\u2019s key if any. Consumer Rebalance Listener To handle offset commit and assigned partitions yourself, you can provide a consumer rebalance listener. To achieve this, implement the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface, make the implementing class a bean, and add the @Identifier qualifier. A usual use case is to store offset in a separate data store to implement exactly-once semantic, or starting the processing at a specific offset. The listener is invoked every time the consumer topic/partition assignment changes. For example, when the application starts, it invokes the partitionsAssigned callback with the initial set of topics/partitions associated with the consumer. If, later, this set changes, it calls the partitionsRevoked and partitionsAssigned callbacks again, so you can implement custom logic. Note that the rebalance listener methods are called from the Kafka polling thread and must block the caller thread until completion. That\u2019s because the rebalance protocol has synchronization barriers, and using asynchronous code in a rebalance listener may be executed after the synchronization barrier. When topics/partitions are assigned or revoked from a consumer, it pauses the message delivery and restarts once the rebalance completes. If the rebalance listener handles offset commit on behalf of the user (using the ignore commit strategy), the rebalance listener must commit the offset synchronously in the partitionsRevoked callback. We also recommend applying the same logic when the application stops. Unlike the ConsumerRebalanceListener from Apache Kafka, the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener methods pass the Kafka Consumer and the set of topics/partitions. Example In this example we set-up a consumer that always starts on messages from at most 10 minutes ago (or offset 0). First we need to provide a bean that implements the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface and is annotated with @Identifier . We then must configure our inbound connector to use this named bean. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 package kafka.inbound ; import java.util.Collection ; import java.util.HashMap ; import java.util.Map ; import java.util.logging.Logger ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.Consumer ; import org.apache.kafka.clients.consumer.OffsetAndTimestamp ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener ; @ApplicationScoped @Identifier ( \"rebalanced-example.rebalancer\" ) public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener { private static final Logger LOGGER = Logger . getLogger ( KafkaRebalancedConsumerRebalanceListener . class . getName ()); /** * When receiving a list of partitions will search for the earliest offset within 10 minutes * and seek the consumer to it. * * @param consumer underlying consumer * @param partitions set of assigned topic partitions */ @Override public void onPartitionsAssigned ( Consumer consumer , Collection < org . apache . kafka . common . TopicPartition > partitions ) { long now = System . currentTimeMillis (); long shouldStartAt = now - 600_000L ; //10 minute ago Map < org . apache . kafka . common . TopicPartition , Long > request = new HashMap <> (); for ( org . apache . kafka . common . TopicPartition partition : partitions ) { LOGGER . info ( \"Assigned \" + partition ); request . put ( partition , shouldStartAt ); } Map < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > offsets = consumer . offsetsForTimes ( request ); for ( Map . Entry < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > position : offsets . entrySet ()) { long target = position . getValue () == null ? 0 L : position . getValue (). offset (); LOGGER . info ( \"Seeking position \" + target + \" for \" + position . getKey ()); consumer . seek ( position . getKey (), target ); } } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package kafka.inbound ; import java.util.concurrent.CompletableFuture ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Acknowledgment ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; @ApplicationScoped public class KafkaRebalancedConsumer { @Incoming ( \"rebalanced-example\" ) @Acknowledgment ( Acknowledgment . Strategy . NONE ) public CompletionStage < Void > consume ( IncomingKafkaRecord < Integer , String > message ) { // We don't need to ACK messages because in this example we set offset during consumer re-balance return CompletableFuture . completedFuture ( null ); } } To configure the inbound connector to use the provided listener we either set the consumer rebalance listener\u2019s name: mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer Or have the listener\u2019s name be the same as the group id: mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer Setting the consumer rebalance listener\u2019s name takes precedence over using the group id. Receiving Kafka Records in Batches By default, incoming methods receive each Kafka record individually. Under the hood, Kafka consumer clients poll the broker constantly and receive records in batches, presented inside the ConsumerRecords container. In batch mode, your application can receive all the records returned by the consumer poll in one go. To achieve this you need to set mp.messaging.incoming.$channel.batch=true and specify a compatible container type to receive all the data: 1 2 3 4 5 6 @Incoming ( \"prices\" ) public void consume ( List < Double > prices ) { for ( double price : prices ) { // process price } } The incoming method can also receive Message , KafkaBatchRecords ConsumerRecords types, They give access to record details such as offset or timestamp : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 @Incoming ( \"prices\" ) public CompletionStage < Void > consumeMessage ( KafkaRecordBatch < String , Double > records ) { for ( KafkaRecord < String , Double > record : records ) { record . getMetadata ( IncomingKafkaRecordMetadata . class ). ifPresent ( metadata -> { int partition = metadata . getPartition (); long offset = metadata . getOffset (); Instant timestamp = metadata . getTimestamp (); //... process messages }); } // ack will commit the latest offsets (per partition) of the batch. return records . ack (); } @Incoming ( \"prices\" ) public void consumeRecords ( ConsumerRecords < String , Double > records ) { for ( TopicPartition partition : records . partitions ()) { for ( ConsumerRecord < String , Double > record : records . records ( partition )) { //... process messages } } } Note that the successful processing of the incoming record batch will commit the latest offsets for each partition received inside the batch. The configured commit strategy will be applied for these records only. Conversely, if the processing throws an exception, all messages are nacked , applying the failure strategy for all the records inside the batch. Stateful processing with Checkpointing Experimental Checkpointing is experimental, and APIs and features are subject to change in the future. The checkpoint commit strategy allows for a Kafka incoming channel to manage topic-partition offsets, not by committing on the Kafka broker, but by persisting consumers' advancement on a state store . In addition to that, if the consumer builds an internal state as a result of consumed records, the topic-partition offset persisted to the state store can be associated with a processing state , saving the local state to the persistent store. When a consumer restarts or consumer group instances scale, i.e. when new partitions get assigned to the consumer, the checkpointing works by resuming the processing from the latest offset and its saved state. The @Incoming channel consumer code can manipulate the processing state through the CheckpointMetadata API: 1 2 3 4 5 6 7 8 9 10 11 12 13 @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( KafkaRecord < String , Double > record ) { // Get the `CheckpointMetadata` from the incoming message CheckpointMetadata < Double > checkpoint = CheckpointMetadata . fromMessage ( record ); // `CheckpointMetadata` allows transforming the processing state // Applies the given function, starting from the value `0.0` when no previous state exists checkpoint . transform ( 0.0 , current -> current + record . getPayload (), /* persistOnAck */ true ); // `persistOnAck` flag set to true, ack will persist the processing state // associated with the latest offset (per partition). return record . ack (); } The transform method allows applying a transformation function to the current state, producing a changed state and registering it locally for checkpointing. By default, the local state is synced (persisted) to the state store periodically, period specified by auto.commit.interval.ms , (default: 5000). If persistOnAck flag is given, the latest state is persisted to the state store eagerly on message acknowledgment. The setNext method works similarly directly setting the latest state. The checkpoint commit strategy tracks when a processing state is last persisted for each topic-partition. If an outstanding state change can not be persisted for checkpoint.unsynced-state-max-age.ms (default: 10000), the channel is marked unhealthy. Where and how processing states are persisted is decided by the state store implementation. This can be configured on the incoming channel using checkpoint.state-store configuration property, using the state store factory identifier name. The serialization of state objects depends on the state store implementation. In order to instruct state stores for serialization can require configuring the type name of state objects using checkpoint.state-type property. In order to keep Smallrye Reactive Messaging free of persistence-related dependencies, this library includes only a default state store named file . It is based on Vert.x Filesystem API and stores the processing state in Json formatted files, in a local directory configured by the checkpoint.file.state-dir property. State files follow the naming scheme [consumer-group-id]:[topic]:[partition] . Implementing State Stores State store implementations are required to implement CheckpointStateStore interface, and provide a managed bean implementing CheckpointStateStore.Factory , identified with @Identifier bean qualifier indicating the name of the state-store. The factory bean identifier indicates the name to configure on checkpoint.state-store config property. The factory is discovered as a CDI managed bean and state store is created once per channel: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 package kafka.inbound ; import java.util.Collection ; import java.util.Map ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.ConsumerConfig ; import org.apache.kafka.common.TopicPartition ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration ; import io.smallrye.reactive.messaging.kafka.KafkaConsumer ; import io.smallrye.reactive.messaging.kafka.commit.CheckpointStateStore ; import io.smallrye.reactive.messaging.kafka.commit.ProcessingState ; import io.vertx.mutiny.core.Vertx ; public class MyCheckpointStateStore implements CheckpointStateStore { private final String consumerGroupId ; private final Class stateType ; public MyCheckpointStateStore ( String consumerGroupId , Class stateType ) { this . consumerGroupId = consumerGroupId ; this . stateType = stateType ; } /** * Can be used with * {@code mp.reactive.messaging.incoming.my-channel.commit-strategy=checkpoint} * {@code mp.reactive.messaging.incoming.my-channel.checkpoint.state-store=my-store} */ @ApplicationScoped @Identifier ( \"my-store\" ) public static class Factory implements CheckpointStateStore . Factory { @Override public CheckpointStateStore create ( KafkaConnectorIncomingConfiguration config , Vertx vertx , KafkaConsumer consumer , Class stateType /* if configured, otherwise null */ ) { String consumerGroupId = ( String ) consumer . configuration (). get ( ConsumerConfig . GROUP_ID_CONFIG ); return new MyCheckpointStateStore ( consumerGroupId , stateType ); } } @Override public Uni < Map < TopicPartition , ProcessingState >> fetchProcessingState ( Collection < TopicPartition > partitions ) { // Called on Vert.x event loop // Return a Uni completing with the map of topic-partition to processing state // The Uni will be subscribed also on Vert.x event loop return Uni . createFrom (). nullItem (); } @Override public Uni < Void > persistProcessingState ( Map < TopicPartition , ProcessingState > state ) { // Called on Vert.x event loop // Return a Uni completing with void when the given states are persisted // The Uni will be subscribed also on Vert.x event loop return Uni . createFrom (). voidItem (); } @Override public void close () { /* Called when channel is closing, no-op by default */ } } The checkpoint commit strategy calls the state store in following events: fetchProcessingState : on partitions assigned, to seek the consumer to the latest offset. persistProcessingState on partitions revoked, to persist the state of last processed record. persistProcessingState on message acknowledgement, if a new state is set during the processing and persistOnAck flag is set. persistProcessingState on auto.commit.interval.ms intervals, if a new state is set during processing. persistProcessingState on channel shutdown. close on channel shutdown. Configuration Reference Attribute ( alias ) Description Type Mandatory Default auto.offset.reset What to do when there is no initial offset in Kafka.Accepted values are earliest, latest and none string false latest batch Whether the Kafka records are consumed in batch. The channel injection point must consume a compatible type, such as List or KafkaRecordBatch . boolean false false bootstrap.servers (kafka.bootstrap.servers) A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster. string false localhost:9092 broadcast Whether the Kafka records should be dispatched to multiple consumer boolean false false checkpoint.state-store While using the checkpoint commit-strategy, the name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.StateStore.Factory to specify the state store implementation. string false checkpoint.state-type While using the checkpoint commit-strategy, the fully qualified type name of the state object to persist in the state store. When provided, it can be used by the state store implementation to help persisting the processing state object. string false checkpoint.unsynced-state-max-age.ms While using the checkpoint commit-strategy, specify the max age in milliseconds that the processing state must be persisted before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring. int false 10000 client-id-prefix Prefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value. string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true commit-strategy Specify the commit strategy to apply when a message produced from a record is acknowledged. Values can be latest , ignore or throttled . If enable.auto.commit is true then the default is ignore otherwise it is throttled string false consumer-rebalance-listener.name The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener . If set, this rebalance listener is applied to the consumer. string false dead-letter-queue.key.serializer When the failure-strategy is set to dead-letter-queue indicates the key serializer to use. If not set the serializer associated to the key deserializer is used string false dead-letter-queue.producer-client-id When the failure-strategy is set to dead-letter-queue indicates what client id the generated producer should use. Defaults is kafka-dead-letter-topic-producer-$client-id string false dead-letter-queue.topic When the failure-strategy is set to dead-letter-queue indicates on which topic the record is sent. Defaults is dead-letter-topic-$channel string false dead-letter-queue.value.serializer When the failure-strategy is set to dead-letter-queue indicates the value serializer to use. If not set the serializer associated to the value deserializer is used string false enable.auto.commit If enabled, consumer's offset will be periodically committed in the background by the underlying Kafka client, ignoring the actual processing outcome of the records. It is recommended to NOT enable this setting and let Reactive Messaging handles the commit. boolean false false fail-on-deserialization-failure When no deserialization failure handler is set and a deserialization failure happens, report the failure and mark the application as unhealthy. If set to false and a deserialization failure happens, a null value is forwarded. boolean false true failure-strategy Specify the failure strategy to apply when a message produced from a record is acknowledged negatively (nack). Values can be fail (default), ignore , or dead-letter-queue string false fail fetch.min.bytes The minimum amount of data the server should return for a fetch request. The default setting of 1 byte means that fetch requests are answered as soon as a single byte of data is available or the fetch request times out waiting for data to arrive. int false 1 graceful-shutdown Whether or not a graceful shutdown should be attempted when the application terminates. boolean false true group.id A unique string that identifies the consumer group the application belongs to. If not set, a unique, generated id is used string false health-enabled Whether health reporting is enabled (default) or disabled boolean false true health-readiness-enabled Whether readiness health reporting is enabled (default) or disabled boolean false true health-readiness-timeout deprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead. long false health-readiness-topic-verification deprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead. boolean false health-topic-verification-enabled Whether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection. boolean false false health-topic-verification-timeout During the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. long false 2000 kafka-configuration Identifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier. string false key-deserialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler . If set, deserialization failure happening when deserializing keys are delegated to this handler which may retry or provide a fallback value. string false key.deserializer The deserializer classname used to deserialize the record's key string false org.apache.kafka.common.serialization.StringDeserializer lazy-client Whether Kafka client is created lazily or eagerly. boolean false false max-queue-size-factor Multiplier factor to determine maximum number of records queued for processing, using max.poll.records * max-queue-size-factor . Defaults to 2. In batch mode max.poll.records is considered 1 . int false 2 partitions The number of partitions to be consumed concurrently. The connector creates the specified amount of Kafka consumers. It should match the number of partition of the targeted topic int false 1 pattern Indicate that the topic property is a regular expression. Must be used with the topic property. Cannot be used with the topics property boolean false false pause-if-no-requests Whether the polling must be paused when the application does not request items and resume when it does. This allows implementing back-pressure based on the application capacity. Note that polling is not stopped, but will not retrieve any records when paused. boolean false true poll-timeout The polling timeout in milliseconds. When polling records, the poll will wait at most that duration before returning records. Default is 1000ms int false 1000 requests When partitions is greater than 1, this attribute allows configuring how many records are requested by each consumers every time. int false 128 retry Whether or not the connection to the broker is re-attempted in case of failure boolean false true retry-attempts The maximum number of reconnection before failing. -1 means infinite retry int false -1 retry-max-wait The max delay (in seconds) between 2 reconnects int false 30 throttled.unprocessed-record-max-age.ms While using the throttled commit-strategy, specify the max age in milliseconds that an unprocessed message can be before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring. int false 60000 topic The consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is used string false topics A comma-separating list of topics to be consumed. Cannot be used with the topic or pattern properties string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true value-deserialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler . If set, deserialization failure happening when deserializing values are delegated to this handler which may retry or provide a fallback value. string false value.deserializer The deserializer classname used to deserialize the record's value string true You can also pass any property supported by the underlying Kafka consumer . For example, to configure the max.poll.records property, use: 1 mp.messaging.incoming.[channel].max.poll.records = 1000 Some consumer client properties are configured to sensible default values: If not set, reconnect.backoff.max.ms is set to 10000 to avoid high load on disconnection. If not set, key.deserializer is set to org.apache.kafka.common.serialization.StringDeserializer . The consumer client.id is configured according to the number of clients to create using mp.messaging.incoming.[channel].partitions property. If a client.id is provided, it is used as-is or suffixed with client index if partitions property is set. If a client.id is not provided, it is generated as kafka-consumer-[channel][-index] .","title":"Receiving records"},{"location":"kafka/receiving-kafka-records/#receiving-kafka-records","text":"The Kafka Connector retrieves Kafka Records from Kafka Brokers and maps each of them to Reactive Messaging Messages .","title":"Receiving Kafka Records"},{"location":"kafka/receiving-kafka-records/#example","text":"Let\u2019s imagine you have a Kafka broker running, and accessible using the kafka:9092 address (by default it would use localhost:9092 ). Configure your application to receive Kafka records from a Kafka topic on the prices channel as follows: 1 2 3 4 5 kafka.bootstrap.servers = kafka:9092 # <1> mp.messaging.incoming.prices.connector = smallrye-kafka # <2> mp.messaging.incoming.prices.value.deserializer = org.apache.kafka.common.serialization.DoubleDeserializer # <3> mp.messaging.incoming.prices.broadcast = true # <4> Configure the broker location. You can configure it globally or per channel Configure the connector to manage the prices channel Sets the (Kafka) deserializer to read the record\u2019s value Make sure that we can receive from more than one consumer (see KafkaPriceConsumer and KafkaPriceMessageConsumer below) Note You don\u2019t need to set the Kafka topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package kafka.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class KafkaPriceConsumer { @Incoming ( \"prices\" ) public void consume ( double price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package kafka.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class KafkaPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < Double > price ) { // process your price. // Acknowledge the incoming message (commit the offset) return price . ack (); } }","title":"Example"},{"location":"kafka/receiving-kafka-records/#deserialization","text":"The deserialization is handled by the underlying Kafka Client. You need to configure the: mp.messaging.incoming.[channel-name].value.deserializer to configure the value deserializer (mandatory) mp.messaging.incoming.[channel-name].key.deserializer to configure the key deserializer (optional, default to String ) If you want to use a custom deserializer, add it to your CLASSPATH and configure the associate attribute. In addition, the Kafka Connector also provides a set of message converters . So you can receive payloads representing records from Kafka using: Record - a pair key/value ConsumerRecord - a structure representing the record with all its metadata 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @Incoming ( \"topic-a\" ) public void consume ( Record < String , String > record ) { String key = record . key (); // Can be `null` if the incoming record has no key String value = record . value (); // Can be `null` if the incoming record has no value } @Incoming ( \"topic-b\" ) public void consume ( ConsumerRecord < String , String > record ) { String key = record . key (); // Can be `null` if the incoming record has no key String value = record . value (); // Can be `null` if the incoming record has no value String topic = record . topic (); int partition = record . partition (); // ... }","title":"Deserialization"},{"location":"kafka/receiving-kafka-records/#inbound-metadata","text":"Messages coming from Kafka contains an instance of IncomingKafkaRecordMetadata in the metadata. It provides the key, topic, partitions, headers and so on: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 IncomingKafkaRecordMetadata < String , Double > metadata = incoming . getMetadata ( IncomingKafkaRecordMetadata . class ) . orElse ( null ); if ( metadata != null ) { // The topic String topic = metadata . getTopic (); // The key String key = metadata . getKey (); // The timestamp Instant timestamp = metadata . getTimestamp (); // The underlying record ConsumerRecord < String , Double > record = metadata . getRecord (); // ... }","title":"Inbound Metadata"},{"location":"kafka/receiving-kafka-records/#acknowledgement","text":"When a message produced from a Kafka record is acknowledged, the connector invokes a commit strategy . These strategies decide when the consumer offset for a specific topic/partition is committed. Committing an offset indicates that all previous records have been processed. It is also the position where the application would restart the processing after a crash recovery or a restart. Committing every offset has performance penalties as Kafka offset management can be slow. However, not committing the offset often enough may lead to message duplication if the application crashes between two commits. The Kafka connector supports three strategies: throttled keeps track of received messages and commit to the next offset after the latest acked message in sequence. This strategy guarantees at-least-once delivery even if the channel performs asynchronous processing. The connector tracks the received records and periodically (period specified by auto.commit.interval.ms (default: 5000)) commits the highest consecutive offset. The connector will be marked as unhealthy if a message associated with a record is not acknowledged in throttled.unprocessed-record-max-age.ms (default: 60000). Indeed, this strategy cannot commit the offset as soon as a single record processing fails (see failure-strategy to configure what happens on failing processing). If throttled.unprocessed-record-max-age.ms is set to less than or equal to 0, it does not perform any health check verification. Such a setting might lead to running out of memory if there are poison pill messages. This strategy is the default if enable.auto.commit is not explicitly set to true . checkpoint allows persisting consumer offsets on a \"state store\", instead of committing them back to the Kafka broker. Using the CheckpointMetadata API, consumer code can persist a processing state with the offset to mark the progress of a consumer. When the processing continues from a previously persisted offset, it seeks the Kafka consumer to that offset and also restores the persisted state, continuing the stateful processing from where it left off. The checkpoint strategy holds locally the processing state associated with the latest offset, and persists it periodically to the state store (period specified by auto.commit.interval.ms (default: 5000)). The connector will be marked as unhealthy if no processing state is persisted to the state store in checkpoint.unsynced-state-max-age.ms (default: 10000). Using the CheckpointMetadata API the user code can force to persist the state on message ack. If checkpoint.unsynced-state-max-age.ms is set to less than or equal to 0, it does not perform any health check verification. For more information, see Stateful processing with Checkpointing latest commits the record offset received by the Kafka consumer as soon as the associated message is acknowledged (if the offset is higher than the previously committed offset). This strategy provides at-least-once delivery if the channel processes the message without performing any asynchronous processing. This strategy should not be used on high-load as offset commit is expensive. However, it reduces the risk of duplicates. ignore performs no commit. This strategy is the default strategy when the consumer is explicitly configured with enable.auto.commit to true . It delegates the offset commit to the Kafka client. When enable.auto.commit is true this strategy DOES NOT guarantee at-least-once delivery. However, if the processing failed between two commits, messages received after the commit and before the failure will be re-processed. Important The Kafka connector disables the Kafka auto commit if not explicitly enabled. This behavior differs from the traditional Kafka consumer. If high-throughout is important for you, and not limited by the downstream, we recommend to either: Use the throttled policy or set enable.auto.commit to true and annotate the consuming method with @Acknowledgment(Acknowledgment.Strategy.NONE)","title":"Acknowledgement"},{"location":"kafka/receiving-kafka-records/#failure-management","text":"If a message produced from a Kafka record is nacked , a failure strategy is applied. The Kafka connector supports 3 strategies: fail - fail the application, no more records will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue. The offset of the record that has not been processed correctly is committed. dead-letter-queue - the offset of the record that has not been processed correctly is committed, but the record is written to a (Kafka) dead letter queue topic. The strategy is selected using the failure-strategy attribute. In the case of dead-letter-queue , you can configure the following attributes: dead-letter-queue.topic : the topic to use to write the records not processed correctly, default is dead-letter-topic-$channel , with $channel being the name of the channel. dead-letter-queue.producer-client-id : the client id used by the kafka producer when sending records to dead letter queue topic. If not specified it will default to kafka-dead-letter-topic-producer-$client-id , with $client-id being the value obtained from consumer client id. dead-letter-queue.key.serializer : the serializer used to write the record key on the dead letter queue. By default, it deduces the serializer from the key deserializer. dead-letter-queue.value.serializer : the serializer used to write the record value on the dead letter queue. By default, it deduces the serializer from the value deserializer. The record written on the dead letter topic contains the original record\u2019s headers, as well as a set of additional headers about the original record: dead-letter-reason - the reason of the failure (the Throwable passed to nack() ) dead-letter-cause - the cause of the failure (the getCause() of the Throwable passed to nack() ), if any dead-letter-topic - the original topic of the record dead-letter-partition - the original partition of the record (integer mapped to String) dead-letter-offset - the original offset of the record (long mapped to String) When using dead-letter-queue , it is also possible to change some metadata of the record that is sent to the dead letter topic. To do that, use the Message.nack(Throwable, Metadata) method: 1 2 3 4 5 6 7 8 9 @Incoming ( \"in\" ) public CompletionStage < Void > consume ( KafkaRecord < String , String > message ) { return message . nack ( new Exception ( \"Failed!\" ), Metadata . of ( OutgoingKafkaRecordMetadata . builder () . withKey ( \"failed-record\" ) . withHeaders ( new RecordHeaders () . add ( \"my-header\" , \"my-header-value\" . getBytes ( StandardCharsets . UTF_8 ))) . build ())); } The Metadata may contain an instance of OutgoingKafkaRecordMetadata . If the instance is present, the following properties will be used: key; if not present, the original record\u2019s key will be used topic; if not present, the configured dead letter topic will be used partition; if not present, partition will be assigned automatically headers; combined with the original record\u2019s headers, as well as the dead-letter-* headers described above","title":"Failure Management"},{"location":"kafka/receiving-kafka-records/#custom-commit-and-failure-strategies","text":"In addition to provided strategies, it is possible to implement custom commit and failure strategies and configure Kafka channels with them. For example, for a custom commit strategy, implement the KafkaCommitHandler interface, and provide a managed bean implementing the KafkaCommitHandler.Factory interface, identified using @Identifier qualifier. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 package kafka.inbound ; import java.util.Collection ; import java.util.function.BiConsumer ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.common.TopicPartition ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration ; import io.smallrye.reactive.messaging.kafka.KafkaConsumer ; import io.smallrye.reactive.messaging.kafka.commit.KafkaCommitHandler ; import io.vertx.mutiny.core.Vertx ; public class KafkaCustomCommit implements KafkaCommitHandler { @Override public < K , V > Uni < Void > handle ( IncomingKafkaRecord < K , V > record ) { // called on message ack return Uni . createFrom (). voidItem (); } @Override public < K , V > Uni < IncomingKafkaRecord < K , V >> received ( IncomingKafkaRecord < K , V > record ) { // called before message processing return Uni . createFrom (). item ( record ); } @Override public void terminate ( boolean graceful ) { // called on channel shutdown } @Override public void partitionsAssigned ( Collection < TopicPartition > partitions ) { // called on partitions assignment } @Override public void partitionsRevoked ( Collection < TopicPartition > partitions ) { // called on partitions revoked } @ApplicationScoped @Identifier ( \"custom\" ) public static class Factory implements KafkaCommitHandler . Factory { @Override public KafkaCommitHandler create ( KafkaConnectorIncomingConfiguration config , Vertx vertx , KafkaConsumer consumer , BiConsumer < Throwable , Boolean > reportFailure ) { return new KafkaCustomCommit ( /* ... */ ); } } } Finally, to use the custom commit strategy, set the commit-strategy attribute to the identifier of the commit handler factory: mp.messaging.incoming.$channel.commit-strategy=custom . Similarly, custom failure strategies can be configured using failure-strategy attribute. Note If the custom strategy implementation inherits ContextHolder class it can access the Vert.x event-loop context created for the Kafka consumer","title":"Custom commit and failure strategies"},{"location":"kafka/receiving-kafka-records/#retrying-processing","text":"You can combine Reactive Messaging with SmallRye Fault Tolerance , and retry processing when it fails: 1 2 3 4 5 6 @Incoming ( \"kafka\" ) @Outgoing ( \"processed\" ) @Retry ( delay = 10 , maxRetries = 5 ) public String process ( String v ) { // ... retry if this method throws an exception } You can configure the delay, the number of retries, the jitter... If your method returns a Uni , you need to add the @NonBlocking annotation: 1 2 3 4 5 6 7 @Incoming ( \"kafka\" ) @Outgoing ( \"processed\" ) @Retry ( delay = 10 , maxRetries = 5 ) @NonBlocking public Uni < String > process ( String v ) { // ... retry if this method throws an exception or the returned Uni produce a failure } The incoming messages are acknowledged only once the processing completes successfully. So, it commits the offset after the successful processing. If after the retries the processing still failed, the message is nacked and the failure strategy is applied. You can also use @Retry on methods only consuming incoming messages: 1 2 3 4 5 @Incoming ( \"kafka\" ) @Retry ( delay = 10 , maxRetries = 5 ) public void consume ( String v ) { // ... retry if this method throws an exception }","title":"Retrying processing"},{"location":"kafka/receiving-kafka-records/#handling-deserialization-failures","text":"Because deserialization happens before creating a Message , the failure strategy presented above cannot be applied. However, when a deserialization failure occurs, you can intercept it and provide a fallback value. To achieve this, create a CDI bean implementing the DeserializationFailureHandler interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @ApplicationScoped @Identifier ( \"failure-retry\" ) // Set the name of the failure handler public class MyDeserializationFailureHandler implements DeserializationFailureHandler < JsonObject > { // Specify the expected type @Override public JsonObject decorateDeserialization ( Uni < JsonObject > deserialization , String topic , boolean isKey , String deserializer , byte [] data , Headers headers ) { return deserialization . onFailure (). retry (). atMost ( 3 ) . await (). atMost ( Duration . ofMillis ( 200 )); } } The bean must be exposed with the @Identifier qualifier specifying the name of the bean. Then, in the connector configuration, specify the following attribute: mp.messaging.incoming.$channel.key-deserialization-failure-handler : name of the bean handling deserialization failures happening for the record\u2019s key mp.messaging.incoming.$channel.value-deserialization-failure-handler : name of the bean handling deserialization failures happening for the record\u2019s value, The handler is called with the deserialization action as a Uni , the record\u2019s topic, a boolean indicating whether the failure happened on a key, the class name of the deserializer that throws the exception, the corrupted data, the exception, and the records headers augmented with headers describing the failure (which ease the write to a dead letter). On the deserialization Uni failure strategies like retry, providing a fallback value or applying timeout can be implemented. Note that the method must await on the result and return the deserialized object. Alternatively, the handler can only implement handleDeserializationFailure method and provide a fallback value, which may be null . If you don\u2019t configure a deserialization failure handlers and a deserialization failure happens, the application is marked unhealthy. You can also ignore the failure, which will log the exception and produce a null value. To enable this behavior, set the mp.messaging.incoming.$channel.fail-on-deserialization-failure attribute to false .","title":"Handling deserialization failures"},{"location":"kafka/receiving-kafka-records/#receiving-cloud-events","text":"The Kafka connector supports Cloud Events . When the connector detects a structured or binary Cloud Events, it adds a IncomingKafkaCloudEventMetadata in the metadata of the Message. IncomingKafkaCloudEventMetadata contains the various (mandatory and optional) Cloud Event attributes. If the connector cannot extract the Cloud Event metadata, it sends the Message without the metadata.","title":"Receiving Cloud Events"},{"location":"kafka/receiving-kafka-records/#binary-cloud-events","text":"For binary Cloud Events, all mandatory Cloud Event attributes must be set in the record header, prefixed by ce_ (as mandated by the protocol binding ). The connector considers headers starting with the ce_ prefix but not listed in the specification as extensions. You can access them using the getExtension method from IncomingKafkaCloudEventMetadata . You can retrieve them as String . The datacontenttype attribute is mapped to the content-type header of the record. The partitionkey attribute is mapped to the record\u2019s key, if any. Note that all headers are read as UTF-8. With binary Cloud Events, the record\u2019s key and value can use any deserializer.","title":"Binary Cloud Events"},{"location":"kafka/receiving-kafka-records/#structured-cloud-events","text":"For structured Cloud Events, the event is encoded in the record\u2019s value. Only JSON is supported, so your event must be encoded as JSON in the record\u2019s value. Structured Cloud Event must set the content-type header of the record to application/cloudevents or prefix the value with application/cloudevents such as: application/cloudevents+json; charset=UTF-8 . To receive structured Cloud Events, your value deserializer must be: org.apache.kafka.common.serialization.StringDeserializer org.apache.kafka.common.serialization.ByteArrayDeserializer io.vertx.kafka.client.serialization.JsonObjectDeserializer As mentioned previously, the value must be a valid JSON object containing at least all the mandatory Cloud Events attributes. If the record is a structured Cloud Event, the created Message\u2019s payload is the Cloud Event data . The partitionkey attribute is mapped to the record\u2019s key if any.","title":"Structured Cloud Events"},{"location":"kafka/receiving-kafka-records/#consumer-rebalance-listener","text":"To handle offset commit and assigned partitions yourself, you can provide a consumer rebalance listener. To achieve this, implement the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface, make the implementing class a bean, and add the @Identifier qualifier. A usual use case is to store offset in a separate data store to implement exactly-once semantic, or starting the processing at a specific offset. The listener is invoked every time the consumer topic/partition assignment changes. For example, when the application starts, it invokes the partitionsAssigned callback with the initial set of topics/partitions associated with the consumer. If, later, this set changes, it calls the partitionsRevoked and partitionsAssigned callbacks again, so you can implement custom logic. Note that the rebalance listener methods are called from the Kafka polling thread and must block the caller thread until completion. That\u2019s because the rebalance protocol has synchronization barriers, and using asynchronous code in a rebalance listener may be executed after the synchronization barrier. When topics/partitions are assigned or revoked from a consumer, it pauses the message delivery and restarts once the rebalance completes. If the rebalance listener handles offset commit on behalf of the user (using the ignore commit strategy), the rebalance listener must commit the offset synchronously in the partitionsRevoked callback. We also recommend applying the same logic when the application stops. Unlike the ConsumerRebalanceListener from Apache Kafka, the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener methods pass the Kafka Consumer and the set of topics/partitions.","title":"Consumer Rebalance Listener"},{"location":"kafka/receiving-kafka-records/#example_1","text":"In this example we set-up a consumer that always starts on messages from at most 10 minutes ago (or offset 0). First we need to provide a bean that implements the io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener interface and is annotated with @Identifier . We then must configure our inbound connector to use this named bean. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 package kafka.inbound ; import java.util.Collection ; import java.util.HashMap ; import java.util.Map ; import java.util.logging.Logger ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.Consumer ; import org.apache.kafka.clients.consumer.OffsetAndTimestamp ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener ; @ApplicationScoped @Identifier ( \"rebalanced-example.rebalancer\" ) public class KafkaRebalancedConsumerRebalanceListener implements KafkaConsumerRebalanceListener { private static final Logger LOGGER = Logger . getLogger ( KafkaRebalancedConsumerRebalanceListener . class . getName ()); /** * When receiving a list of partitions will search for the earliest offset within 10 minutes * and seek the consumer to it. * * @param consumer underlying consumer * @param partitions set of assigned topic partitions */ @Override public void onPartitionsAssigned ( Consumer consumer , Collection < org . apache . kafka . common . TopicPartition > partitions ) { long now = System . currentTimeMillis (); long shouldStartAt = now - 600_000L ; //10 minute ago Map < org . apache . kafka . common . TopicPartition , Long > request = new HashMap <> (); for ( org . apache . kafka . common . TopicPartition partition : partitions ) { LOGGER . info ( \"Assigned \" + partition ); request . put ( partition , shouldStartAt ); } Map < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > offsets = consumer . offsetsForTimes ( request ); for ( Map . Entry < org . apache . kafka . common . TopicPartition , OffsetAndTimestamp > position : offsets . entrySet ()) { long target = position . getValue () == null ? 0 L : position . getValue (). offset (); LOGGER . info ( \"Seeking position \" + target + \" for \" + position . getKey ()); consumer . seek ( position . getKey (), target ); } } } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 package kafka.inbound ; import java.util.concurrent.CompletableFuture ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Acknowledgment ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.reactive.messaging.kafka.IncomingKafkaRecord ; @ApplicationScoped public class KafkaRebalancedConsumer { @Incoming ( \"rebalanced-example\" ) @Acknowledgment ( Acknowledgment . Strategy . NONE ) public CompletionStage < Void > consume ( IncomingKafkaRecord < Integer , String > message ) { // We don't need to ACK messages because in this example we set offset during consumer re-balance return CompletableFuture . completedFuture ( null ); } } To configure the inbound connector to use the provided listener we either set the consumer rebalance listener\u2019s name: mp.messaging.incoming.rebalanced-example.consumer-rebalance-listener.name=rebalanced-example.rebalancer Or have the listener\u2019s name be the same as the group id: mp.messaging.incoming.rebalanced-example.group.id=rebalanced-example.rebalancer Setting the consumer rebalance listener\u2019s name takes precedence over using the group id.","title":"Example"},{"location":"kafka/receiving-kafka-records/#receiving-kafka-records-in-batches","text":"By default, incoming methods receive each Kafka record individually. Under the hood, Kafka consumer clients poll the broker constantly and receive records in batches, presented inside the ConsumerRecords container. In batch mode, your application can receive all the records returned by the consumer poll in one go. To achieve this you need to set mp.messaging.incoming.$channel.batch=true and specify a compatible container type to receive all the data: 1 2 3 4 5 6 @Incoming ( \"prices\" ) public void consume ( List < Double > prices ) { for ( double price : prices ) { // process price } } The incoming method can also receive Message , KafkaBatchRecords ConsumerRecords types, They give access to record details such as offset or timestamp : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 @Incoming ( \"prices\" ) public CompletionStage < Void > consumeMessage ( KafkaRecordBatch < String , Double > records ) { for ( KafkaRecord < String , Double > record : records ) { record . getMetadata ( IncomingKafkaRecordMetadata . class ). ifPresent ( metadata -> { int partition = metadata . getPartition (); long offset = metadata . getOffset (); Instant timestamp = metadata . getTimestamp (); //... process messages }); } // ack will commit the latest offsets (per partition) of the batch. return records . ack (); } @Incoming ( \"prices\" ) public void consumeRecords ( ConsumerRecords < String , Double > records ) { for ( TopicPartition partition : records . partitions ()) { for ( ConsumerRecord < String , Double > record : records . records ( partition )) { //... process messages } } } Note that the successful processing of the incoming record batch will commit the latest offsets for each partition received inside the batch. The configured commit strategy will be applied for these records only. Conversely, if the processing throws an exception, all messages are nacked , applying the failure strategy for all the records inside the batch.","title":"Receiving Kafka Records in Batches"},{"location":"kafka/receiving-kafka-records/#stateful-processing-with-checkpointing","text":"Experimental Checkpointing is experimental, and APIs and features are subject to change in the future. The checkpoint commit strategy allows for a Kafka incoming channel to manage topic-partition offsets, not by committing on the Kafka broker, but by persisting consumers' advancement on a state store . In addition to that, if the consumer builds an internal state as a result of consumed records, the topic-partition offset persisted to the state store can be associated with a processing state , saving the local state to the persistent store. When a consumer restarts or consumer group instances scale, i.e. when new partitions get assigned to the consumer, the checkpointing works by resuming the processing from the latest offset and its saved state. The @Incoming channel consumer code can manipulate the processing state through the CheckpointMetadata API: 1 2 3 4 5 6 7 8 9 10 11 12 13 @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( KafkaRecord < String , Double > record ) { // Get the `CheckpointMetadata` from the incoming message CheckpointMetadata < Double > checkpoint = CheckpointMetadata . fromMessage ( record ); // `CheckpointMetadata` allows transforming the processing state // Applies the given function, starting from the value `0.0` when no previous state exists checkpoint . transform ( 0.0 , current -> current + record . getPayload (), /* persistOnAck */ true ); // `persistOnAck` flag set to true, ack will persist the processing state // associated with the latest offset (per partition). return record . ack (); } The transform method allows applying a transformation function to the current state, producing a changed state and registering it locally for checkpointing. By default, the local state is synced (persisted) to the state store periodically, period specified by auto.commit.interval.ms , (default: 5000). If persistOnAck flag is given, the latest state is persisted to the state store eagerly on message acknowledgment. The setNext method works similarly directly setting the latest state. The checkpoint commit strategy tracks when a processing state is last persisted for each topic-partition. If an outstanding state change can not be persisted for checkpoint.unsynced-state-max-age.ms (default: 10000), the channel is marked unhealthy. Where and how processing states are persisted is decided by the state store implementation. This can be configured on the incoming channel using checkpoint.state-store configuration property, using the state store factory identifier name. The serialization of state objects depends on the state store implementation. In order to instruct state stores for serialization can require configuring the type name of state objects using checkpoint.state-type property. In order to keep Smallrye Reactive Messaging free of persistence-related dependencies, this library includes only a default state store named file . It is based on Vert.x Filesystem API and stores the processing state in Json formatted files, in a local directory configured by the checkpoint.file.state-dir property. State files follow the naming scheme [consumer-group-id]:[topic]:[partition] .","title":"Stateful processing with Checkpointing"},{"location":"kafka/receiving-kafka-records/#implementing-state-stores","text":"State store implementations are required to implement CheckpointStateStore interface, and provide a managed bean implementing CheckpointStateStore.Factory , identified with @Identifier bean qualifier indicating the name of the state-store. The factory bean identifier indicates the name to configure on checkpoint.state-store config property. The factory is discovered as a CDI managed bean and state store is created once per channel: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 package kafka.inbound ; import java.util.Collection ; import java.util.Map ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.consumer.ConsumerConfig ; import org.apache.kafka.common.TopicPartition ; import io.smallrye.common.annotation.Identifier ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaConnectorIncomingConfiguration ; import io.smallrye.reactive.messaging.kafka.KafkaConsumer ; import io.smallrye.reactive.messaging.kafka.commit.CheckpointStateStore ; import io.smallrye.reactive.messaging.kafka.commit.ProcessingState ; import io.vertx.mutiny.core.Vertx ; public class MyCheckpointStateStore implements CheckpointStateStore { private final String consumerGroupId ; private final Class stateType ; public MyCheckpointStateStore ( String consumerGroupId , Class stateType ) { this . consumerGroupId = consumerGroupId ; this . stateType = stateType ; } /** * Can be used with * {@code mp.reactive.messaging.incoming.my-channel.commit-strategy=checkpoint} * {@code mp.reactive.messaging.incoming.my-channel.checkpoint.state-store=my-store} */ @ApplicationScoped @Identifier ( \"my-store\" ) public static class Factory implements CheckpointStateStore . Factory { @Override public CheckpointStateStore create ( KafkaConnectorIncomingConfiguration config , Vertx vertx , KafkaConsumer consumer , Class stateType /* if configured, otherwise null */ ) { String consumerGroupId = ( String ) consumer . configuration (). get ( ConsumerConfig . GROUP_ID_CONFIG ); return new MyCheckpointStateStore ( consumerGroupId , stateType ); } } @Override public Uni < Map < TopicPartition , ProcessingState >> fetchProcessingState ( Collection < TopicPartition > partitions ) { // Called on Vert.x event loop // Return a Uni completing with the map of topic-partition to processing state // The Uni will be subscribed also on Vert.x event loop return Uni . createFrom (). nullItem (); } @Override public Uni < Void > persistProcessingState ( Map < TopicPartition , ProcessingState > state ) { // Called on Vert.x event loop // Return a Uni completing with void when the given states are persisted // The Uni will be subscribed also on Vert.x event loop return Uni . createFrom (). voidItem (); } @Override public void close () { /* Called when channel is closing, no-op by default */ } } The checkpoint commit strategy calls the state store in following events: fetchProcessingState : on partitions assigned, to seek the consumer to the latest offset. persistProcessingState on partitions revoked, to persist the state of last processed record. persistProcessingState on message acknowledgement, if a new state is set during the processing and persistOnAck flag is set. persistProcessingState on auto.commit.interval.ms intervals, if a new state is set during processing. persistProcessingState on channel shutdown. close on channel shutdown.","title":"Implementing State Stores"},{"location":"kafka/receiving-kafka-records/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default auto.offset.reset What to do when there is no initial offset in Kafka.Accepted values are earliest, latest and none string false latest batch Whether the Kafka records are consumed in batch. The channel injection point must consume a compatible type, such as List or KafkaRecordBatch . boolean false false bootstrap.servers (kafka.bootstrap.servers) A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster. string false localhost:9092 broadcast Whether the Kafka records should be dispatched to multiple consumer boolean false false checkpoint.state-store While using the checkpoint commit-strategy, the name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.StateStore.Factory to specify the state store implementation. string false checkpoint.state-type While using the checkpoint commit-strategy, the fully qualified type name of the state object to persist in the state store. When provided, it can be used by the state store implementation to help persisting the processing state object. string false checkpoint.unsynced-state-max-age.ms While using the checkpoint commit-strategy, specify the max age in milliseconds that the processing state must be persisted before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring. int false 10000 client-id-prefix Prefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value. string false cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true commit-strategy Specify the commit strategy to apply when a message produced from a record is acknowledged. Values can be latest , ignore or throttled . If enable.auto.commit is true then the default is ignore otherwise it is throttled string false consumer-rebalance-listener.name The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.KafkaConsumerRebalanceListener . If set, this rebalance listener is applied to the consumer. string false dead-letter-queue.key.serializer When the failure-strategy is set to dead-letter-queue indicates the key serializer to use. If not set the serializer associated to the key deserializer is used string false dead-letter-queue.producer-client-id When the failure-strategy is set to dead-letter-queue indicates what client id the generated producer should use. Defaults is kafka-dead-letter-topic-producer-$client-id string false dead-letter-queue.topic When the failure-strategy is set to dead-letter-queue indicates on which topic the record is sent. Defaults is dead-letter-topic-$channel string false dead-letter-queue.value.serializer When the failure-strategy is set to dead-letter-queue indicates the value serializer to use. If not set the serializer associated to the value deserializer is used string false enable.auto.commit If enabled, consumer's offset will be periodically committed in the background by the underlying Kafka client, ignoring the actual processing outcome of the records. It is recommended to NOT enable this setting and let Reactive Messaging handles the commit. boolean false false fail-on-deserialization-failure When no deserialization failure handler is set and a deserialization failure happens, report the failure and mark the application as unhealthy. If set to false and a deserialization failure happens, a null value is forwarded. boolean false true failure-strategy Specify the failure strategy to apply when a message produced from a record is acknowledged negatively (nack). Values can be fail (default), ignore , or dead-letter-queue string false fail fetch.min.bytes The minimum amount of data the server should return for a fetch request. The default setting of 1 byte means that fetch requests are answered as soon as a single byte of data is available or the fetch request times out waiting for data to arrive. int false 1 graceful-shutdown Whether or not a graceful shutdown should be attempted when the application terminates. boolean false true group.id A unique string that identifies the consumer group the application belongs to. If not set, a unique, generated id is used string false health-enabled Whether health reporting is enabled (default) or disabled boolean false true health-readiness-enabled Whether readiness health reporting is enabled (default) or disabled boolean false true health-readiness-timeout deprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead. long false health-readiness-topic-verification deprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead. boolean false health-topic-verification-enabled Whether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection. boolean false false health-topic-verification-timeout During the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. long false 2000 kafka-configuration Identifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier. string false key-deserialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler . If set, deserialization failure happening when deserializing keys are delegated to this handler which may retry or provide a fallback value. string false key.deserializer The deserializer classname used to deserialize the record's key string false org.apache.kafka.common.serialization.StringDeserializer lazy-client Whether Kafka client is created lazily or eagerly. boolean false false max-queue-size-factor Multiplier factor to determine maximum number of records queued for processing, using max.poll.records * max-queue-size-factor . Defaults to 2. In batch mode max.poll.records is considered 1 . int false 2 partitions The number of partitions to be consumed concurrently. The connector creates the specified amount of Kafka consumers. It should match the number of partition of the targeted topic int false 1 pattern Indicate that the topic property is a regular expression. Must be used with the topic property. Cannot be used with the topics property boolean false false pause-if-no-requests Whether the polling must be paused when the application does not request items and resume when it does. This allows implementing back-pressure based on the application capacity. Note that polling is not stopped, but will not retrieve any records when paused. boolean false true poll-timeout The polling timeout in milliseconds. When polling records, the poll will wait at most that duration before returning records. Default is 1000ms int false 1000 requests When partitions is greater than 1, this attribute allows configuring how many records are requested by each consumers every time. int false 128 retry Whether or not the connection to the broker is re-attempted in case of failure boolean false true retry-attempts The maximum number of reconnection before failing. -1 means infinite retry int false -1 retry-max-wait The max delay (in seconds) between 2 reconnects int false 30 throttled.unprocessed-record-max-age.ms While using the throttled commit-strategy, specify the max age in milliseconds that an unprocessed message can be before the connector is marked as unhealthy. Setting this attribute to 0 disables this monitoring. int false 60000 topic The consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is used string false topics A comma-separating list of topics to be consumed. Cannot be used with the topic or pattern properties string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true value-deserialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.DeserializationFailureHandler . If set, deserialization failure happening when deserializing values are delegated to this handler which may retry or provide a fallback value. string false value.deserializer The deserializer classname used to deserialize the record's value string true You can also pass any property supported by the underlying Kafka consumer . For example, to configure the max.poll.records property, use: 1 mp.messaging.incoming.[channel].max.poll.records = 1000 Some consumer client properties are configured to sensible default values: If not set, reconnect.backoff.max.ms is set to 10000 to avoid high load on disconnection. If not set, key.deserializer is set to org.apache.kafka.common.serialization.StringDeserializer . The consumer client.id is configured according to the number of clients to create using mp.messaging.incoming.[channel].partitions property. If a client.id is provided, it is used as-is or suffixed with client index if partitions property is set. If a client.id is not provided, it is generated as kafka-consumer-[channel][-index] .","title":"Configuration Reference"},{"location":"kafka/test-companion/","text":"Kafka Companion Experimental Kafka Companion is experimental and APIs are subject to change in the future. The Kafka Companion is a separate Java library for helping to test Kafka applications. It is not intended to mock Kafka, but to the contrary, connect to a Kafka broker and provide high-level features. It is not limited to the SmallRye Reactive Messaging testing, but intends to improve the testability of applications using Kafka. Some of its features: Running In-container Kafka broker for tests via strimzi-test-container . Running the Kafka broker behind a toxiproxy for simulating network issues. Running embedded Kafka Kraft broker for tests. Base classes for tests to bootstrap tests. Companion classes for easily creating tasks to produce and consume Kafka records. Writing assertions for produce and consume tasks, state of consumers, topics, offsets etc. Getting started writing tests Easiest way of starting to write Kafka tests is to extend KafkaCompanionTestBase . It starts a single-node Kafka broker for the test suite using testcontainers and creates the KafkaCompanion to connect to this broker: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 public class KafkaWithBaseTest extends KafkaCompanionTestBase { @Test public void testWithBase () { // companion is created by the base class // produce 100 records to messages topic ProducerTask producerTask = companion . produceIntegers () . usingGenerator ( i -> new ProducerRecord <> ( \"messages\" , i ), 100 ); long msgCount = producerTask . awaitCompletion (). count (); Assertions . assertEquals ( msgCount , 100 ); // consume 100 records from messages topic ConsumerTask < String , Integer > consumerTask = companion . consumeIntegers () . fromTopics ( \"messages\" , 100 ); ConsumerRecord < String , Integer > lastRecord = consumerTask . awaitCompletion (). getLastRecord (); Assertions . assertEquals ( lastRecord . value (), 99 ); } } KafkaCompanion can be used on its own to connect to a broker: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 // Create companion with bootstrap servers and API timeout (default is 10 seconds) KafkaCompanion companion = new KafkaCompanion ( \"localhost:9092\" , Duration . ofSeconds ( 5 )); // Create producer and start producer task ProducerBuilder < String , Integer > producer = companion . produceIntegers () . withClientId ( \"my-producer\" ) . withProp ( \"max.block.ms\" , \"5000\" ); producer . usingGenerator ( i -> new ProducerRecord <> ( \"topic\" , i ), 100 ); // Create consumer and start consumer task ConsumerBuilder < String , Integer > consumer = companion . consumeIntegers () . withGroupId ( \"my-group\" ) . withCommitAsyncWhen ( record -> true ); ConsumerTask < String , Integer > records = consumer . fromTopics ( \"topic\" , Duration . ofSeconds ( 10 )); // Await completion and assert consumed record count Assertions . assertEquals ( records . awaitCompletion (). count (), 100 ); There are a couple of things to note on how Kafka companion handles producers , consumers and tasks : ProducerBuilder and ConsumerBuilder lazy descriptions of with which configuration to create a producer or a consumer. ProducerTask and ConsumerTask run asynchronously on dedicated threads and are started as soon as they are created. A task terminates when it is explicitly stopped, when it's predefined duration or number of records has been produced/consumed, or when it encounters an error. An exterior thread can await on records processed, or simply on termination of the task. At a given time produced or consumed records are accessible through the task. The actual creation of the producer or consumer happens when a task is started. When the task terminates the producer or the consumer is automatically closed. For example, in the previous example: We described a producer with a client id my-producer and max.block.ms of 5 seconds. Then we created a task to produce 100 records using the generator function, without waiting for its completion. We then described a consumer with group id my-group and which commits offset synchronously on every received record. Finally, we created a task to consume records for 10 seconds and await its completion. Producing records Produce from records Produce given records: 1 2 3 4 companion . produce ( byte [] . class ). fromRecords ( new ProducerRecord <> ( \"topic1\" , \"k1\" , \"1\" . getBytes ()), new ProducerRecord <> ( \"topic1\" , \"k2\" , \"2\" . getBytes ()), new ProducerRecord <> ( \"topic1\" , \"k3\" , \"3\" . getBytes ())); Produce from generator function Produce 10 records using the generator function: 1 companion . produceIntegers (). usingGenerator ( i -> new ProducerRecord <> ( \"topic\" , i ), 10 ); Produce from CSV file Given a comma-separated file records.csv with the following content 1 2 3 messages,0,a,asdf messages,1,b,asdf messages,3,c,asdf Produce records from the file: 1 companion . produceStrings (). fromCsv ( \"records.csv\" ); Consuming records Consume from topics 1 companion . consumeIntegers (). fromTopics ( \"topic1\" , \"topic2\" ); Consume from offsets 1 2 3 4 Map < TopicPartition , Long > offsets = new HashMap <> (); offsets . put ( new TopicPartition ( \"topic1\" , 0 ), 100L ); offsets . put ( new TopicPartition ( \"topic2\" , 0 ), 100L ); companion . consumeIntegers (). fromOffsets ( offsets , Duration . ofSeconds ( 10 )); Consumer assignment and offsets During execution of the consumer task, information about the underlying consumer's topic partition assignment, position or committed offsets can be accessed. 1 2 3 4 5 6 ConsumerBuilder < String , Integer > consumer = companion . consumeIntegers () . withAutoCommit (); consumer . fromTopics ( \"topic\" ); // ... await (). untilAsserted ( consumer :: waitForAssignment ); consumer . committed ( new TopicPartition ( \"topic\" , 1 )); Registering Custom Serdes KafkaCompanion handles Serializers and Deserializers for default types such as primitives, String, ByteBuffer, UUID. Serdes for custom types can be registered to the companion object, and will be used for producer and consumer tasks: 1 2 3 4 5 6 7 8 9 10 11 12 KafkaCompanion companion = new KafkaCompanion ( \"localhost:9092\" ); // Register serde to the companion companion . registerSerde ( Orders . class , new OrdersSerializer (), new OrdersDeserializer ()); // Companion will configure consumer accordingly ConsumerTask < Integer , Orders > orders = companion . consume ( Integer . class , Orders . class ) . fromTopics ( \"orders\" , 1000 ). awaitCompletion (); for ( ConsumerRecord < Integer , Orders > order : orders ) { // ... check consumed records } Topics Create, list, describe and delete topics: 1 2 3 4 5 companion . topics (). create ( \"topic1\" , 1 ); companion . topics (). createAndWait ( \"topic2\" , 3 ); Assertions . assertEquals ( companion . topics (). list (). size (), 2 ); companion . topics (). delete ( \"topic1\" ); Consumer Groups and Offsets List topic partition offsets: 1 2 TopicPartition topicPartition = KafkaCompanion . tp ( \"topic\" , 1 ); long latestOffset = companion . offsets (). get ( topicPartition , OffsetSpec . latest ()). offset (); List, describe, alter consumer groups and their offsets: 1 2 3 4 5 6 7 Collection < ConsumerGroupListing > consumerGroups = companion . consumerGroups (). list (); for ( ConsumerGroupListing consumerGroup : consumerGroups ) { // check consumer groups } TopicPartition topicPartition = KafkaCompanion . tp ( \"topic\" , 1 ); companion . consumerGroups (). resetOffsets ( \"consumer-group\" , topicPartition );","title":"Test Companion for Kafka"},{"location":"kafka/test-companion/#kafka-companion","text":"Experimental Kafka Companion is experimental and APIs are subject to change in the future. The Kafka Companion is a separate Java library for helping to test Kafka applications. It is not intended to mock Kafka, but to the contrary, connect to a Kafka broker and provide high-level features. It is not limited to the SmallRye Reactive Messaging testing, but intends to improve the testability of applications using Kafka. Some of its features: Running In-container Kafka broker for tests via strimzi-test-container . Running the Kafka broker behind a toxiproxy for simulating network issues. Running embedded Kafka Kraft broker for tests. Base classes for tests to bootstrap tests. Companion classes for easily creating tasks to produce and consume Kafka records. Writing assertions for produce and consume tasks, state of consumers, topics, offsets etc.","title":"Kafka Companion"},{"location":"kafka/test-companion/#getting-started-writing-tests","text":"Easiest way of starting to write Kafka tests is to extend KafkaCompanionTestBase . It starts a single-node Kafka broker for the test suite using testcontainers and creates the KafkaCompanion to connect to this broker: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 public class KafkaWithBaseTest extends KafkaCompanionTestBase { @Test public void testWithBase () { // companion is created by the base class // produce 100 records to messages topic ProducerTask producerTask = companion . produceIntegers () . usingGenerator ( i -> new ProducerRecord <> ( \"messages\" , i ), 100 ); long msgCount = producerTask . awaitCompletion (). count (); Assertions . assertEquals ( msgCount , 100 ); // consume 100 records from messages topic ConsumerTask < String , Integer > consumerTask = companion . consumeIntegers () . fromTopics ( \"messages\" , 100 ); ConsumerRecord < String , Integer > lastRecord = consumerTask . awaitCompletion (). getLastRecord (); Assertions . assertEquals ( lastRecord . value (), 99 ); } } KafkaCompanion can be used on its own to connect to a broker: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 // Create companion with bootstrap servers and API timeout (default is 10 seconds) KafkaCompanion companion = new KafkaCompanion ( \"localhost:9092\" , Duration . ofSeconds ( 5 )); // Create producer and start producer task ProducerBuilder < String , Integer > producer = companion . produceIntegers () . withClientId ( \"my-producer\" ) . withProp ( \"max.block.ms\" , \"5000\" ); producer . usingGenerator ( i -> new ProducerRecord <> ( \"topic\" , i ), 100 ); // Create consumer and start consumer task ConsumerBuilder < String , Integer > consumer = companion . consumeIntegers () . withGroupId ( \"my-group\" ) . withCommitAsyncWhen ( record -> true ); ConsumerTask < String , Integer > records = consumer . fromTopics ( \"topic\" , Duration . ofSeconds ( 10 )); // Await completion and assert consumed record count Assertions . assertEquals ( records . awaitCompletion (). count (), 100 ); There are a couple of things to note on how Kafka companion handles producers , consumers and tasks : ProducerBuilder and ConsumerBuilder lazy descriptions of with which configuration to create a producer or a consumer. ProducerTask and ConsumerTask run asynchronously on dedicated threads and are started as soon as they are created. A task terminates when it is explicitly stopped, when it's predefined duration or number of records has been produced/consumed, or when it encounters an error. An exterior thread can await on records processed, or simply on termination of the task. At a given time produced or consumed records are accessible through the task. The actual creation of the producer or consumer happens when a task is started. When the task terminates the producer or the consumer is automatically closed. For example, in the previous example: We described a producer with a client id my-producer and max.block.ms of 5 seconds. Then we created a task to produce 100 records using the generator function, without waiting for its completion. We then described a consumer with group id my-group and which commits offset synchronously on every received record. Finally, we created a task to consume records for 10 seconds and await its completion.","title":"Getting started writing tests"},{"location":"kafka/test-companion/#producing-records","text":"","title":"Producing records"},{"location":"kafka/test-companion/#produce-from-records","text":"Produce given records: 1 2 3 4 companion . produce ( byte [] . class ). fromRecords ( new ProducerRecord <> ( \"topic1\" , \"k1\" , \"1\" . getBytes ()), new ProducerRecord <> ( \"topic1\" , \"k2\" , \"2\" . getBytes ()), new ProducerRecord <> ( \"topic1\" , \"k3\" , \"3\" . getBytes ()));","title":"Produce from records"},{"location":"kafka/test-companion/#produce-from-generator-function","text":"Produce 10 records using the generator function: 1 companion . produceIntegers (). usingGenerator ( i -> new ProducerRecord <> ( \"topic\" , i ), 10 );","title":"Produce from generator function"},{"location":"kafka/test-companion/#produce-from-csv-file","text":"Given a comma-separated file records.csv with the following content 1 2 3 messages,0,a,asdf messages,1,b,asdf messages,3,c,asdf Produce records from the file: 1 companion . produceStrings (). fromCsv ( \"records.csv\" );","title":"Produce from CSV file"},{"location":"kafka/test-companion/#consuming-records","text":"","title":"Consuming records"},{"location":"kafka/test-companion/#consume-from-topics","text":"1 companion . consumeIntegers (). fromTopics ( \"topic1\" , \"topic2\" );","title":"Consume from topics"},{"location":"kafka/test-companion/#consume-from-offsets","text":"1 2 3 4 Map < TopicPartition , Long > offsets = new HashMap <> (); offsets . put ( new TopicPartition ( \"topic1\" , 0 ), 100L ); offsets . put ( new TopicPartition ( \"topic2\" , 0 ), 100L ); companion . consumeIntegers (). fromOffsets ( offsets , Duration . ofSeconds ( 10 ));","title":"Consume from offsets"},{"location":"kafka/test-companion/#consumer-assignment-and-offsets","text":"During execution of the consumer task, information about the underlying consumer's topic partition assignment, position or committed offsets can be accessed. 1 2 3 4 5 6 ConsumerBuilder < String , Integer > consumer = companion . consumeIntegers () . withAutoCommit (); consumer . fromTopics ( \"topic\" ); // ... await (). untilAsserted ( consumer :: waitForAssignment ); consumer . committed ( new TopicPartition ( \"topic\" , 1 ));","title":"Consumer assignment and offsets"},{"location":"kafka/test-companion/#registering-custom-serdes","text":"KafkaCompanion handles Serializers and Deserializers for default types such as primitives, String, ByteBuffer, UUID. Serdes for custom types can be registered to the companion object, and will be used for producer and consumer tasks: 1 2 3 4 5 6 7 8 9 10 11 12 KafkaCompanion companion = new KafkaCompanion ( \"localhost:9092\" ); // Register serde to the companion companion . registerSerde ( Orders . class , new OrdersSerializer (), new OrdersDeserializer ()); // Companion will configure consumer accordingly ConsumerTask < Integer , Orders > orders = companion . consume ( Integer . class , Orders . class ) . fromTopics ( \"orders\" , 1000 ). awaitCompletion (); for ( ConsumerRecord < Integer , Orders > order : orders ) { // ... check consumed records }","title":"Registering Custom Serdes"},{"location":"kafka/test-companion/#topics","text":"Create, list, describe and delete topics: 1 2 3 4 5 companion . topics (). create ( \"topic1\" , 1 ); companion . topics (). createAndWait ( \"topic2\" , 3 ); Assertions . assertEquals ( companion . topics (). list (). size (), 2 ); companion . topics (). delete ( \"topic1\" );","title":"Topics"},{"location":"kafka/test-companion/#consumer-groups-and-offsets","text":"List topic partition offsets: 1 2 TopicPartition topicPartition = KafkaCompanion . tp ( \"topic\" , 1 ); long latestOffset = companion . offsets (). get ( topicPartition , OffsetSpec . latest ()). offset (); List, describe, alter consumer groups and their offsets: 1 2 3 4 5 6 7 Collection < ConsumerGroupListing > consumerGroups = companion . consumerGroups (). list (); for ( ConsumerGroupListing consumerGroup : consumerGroups ) { // check consumer groups } TopicPartition topicPartition = KafkaCompanion . tp ( \"topic\" , 1 ); companion . consumerGroups (). resetOffsets ( \"consumer-group\" , topicPartition );","title":"Consumer Groups and Offsets"},{"location":"kafka/transactions/","text":"Kafka Transactions and Exactly-Once Processing Experimental Kafka Transactions is an experimental feature. Kafka transactions enable atomic writes to multiple Kafka topics and partitions. Inside a transaction, a producer writes records to the Kafka topic partitions as it would normally do. If the transaction completes successfully, all the records previously written to the broker inside that transaction will be committed , and will be readable for consumers. If an error during the transaction causes it to be aborted , none will be readable for consumers. There are a couple of fundamental things to consider before using transactions: Each transactional producer is configured with a unique identifier called the transactional.id . This is used to identify the same producer instance across application restarts. By default, it is not configured, and transactions cannot be used. When it is configured, the producer is limited to idempotent delivery, therefore enable.idempotence=true is implied. For only reading transactional messages, a consumer needs to explicitly configure its isolation.level property to read_committed . This will make sure that the consumer will deliver only records committed inside a transaction, and filter out messages from aborted transactions. It should also be noted that this does not mean all records atomically written inside a transaction will be read atomically by the consumer. Transactional producers can write to multiple topics and partitions inside a transaction, but consumers do not know where the transaction starts or ends. Not only multiple consumers inside a consumer group can share those partitions, all records which were part of a single transaction can be consumed in different batch of records by a consumer. Kafka connector provides KafkaTransactions custom emitter for writing records inside a transaction. Before using a transaction we need to make sure that transactional.id is configured on the channel properties. 1 mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer It can be used as a regular emitter @Channel : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 package kafka.outbound ; import javax.enterprise.context.ApplicationScoped ; import javax.inject.Inject ; import org.eclipse.microprofile.reactive.messaging.Channel ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaRecord ; import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions ; @ApplicationScoped public class KafkaTransactionalProducer { @Inject @Channel ( \"tx-out-example\" ) KafkaTransactions < String > txProducer ; public Uni < Void > emitInTransaction () { return txProducer . withTransaction ( emitter -> { emitter . send ( KafkaRecord . of ( 1 , \"a\" )); emitter . send ( KafkaRecord . of ( 2 , \"b\" )); emitter . send ( KafkaRecord . of ( 3 , \"c\" )); return Uni . createFrom (). voidItem (); }); } } Note When transactional.id is provided KafkaProducer#initTransactions is called when the underlying Kafka producer is created. The function given to the withTransaction method receives a TransactionalEmitter for producing records, and returns a Uni that provides the result of the transaction. If the processing completes successfully, the producer is flushed and the transaction is committed. If the processing throws an exception, returns a failing Uni , or marks the TransactionalEmitter for abort, the transaction is aborted. If this method is called on a Vert.x context, the processing function is also called on that context. Otherwise, it is called on the sending thread of the producer. Important A transaction is considered in progress from the call to the withTransaction until the returned Uni results in success or failure. While a transaction is in progress, subsequent calls to the withTransaction , including nested ones inside the given function, will throw IllegalStateException . Note that in Reactive Messaging, the execution of processing methods is already serialized, unless @Blocking(ordered = false) is used. If withTransaction can be called concurrently, for example from a REST endpoint, it is recommended to limit the concurrency of the execution. This can be done using the @Bulkhead annotation from Microprofile Fault Tolerance. Exactly-Once Processing Kafka Transactions API also allows managing consumer offsets inside a transaction, together with produced messages. This in turn enables coupling a consumer with a transactional producer in a consume-transform-produce pattern, also known as exactly-once processing. It means that an application consumes messages from a topic-partition, processes them, publishes the results to a topic-partition, and commits offsets of the consumed messages in a transaction. The KafkaTransactions emitter also provides a way to apply exactly-once processing to an incoming Kafka message inside a transaction. The following example includes a batch of Kafka records inside a transaction. 1 2 3 4 mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer mp.messaging.outgoing.in-channel.batch=true mp.messaging.outgoing.in-channel.commit-strategy=ignore mp.messaging.outgoing.in-channel.failure-strategy=ignore 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 package kafka.outbound ; import javax.enterprise.context.ApplicationScoped ; import javax.inject.Inject ; import org.eclipse.microprofile.reactive.messaging.Channel ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaRecord ; import io.smallrye.reactive.messaging.kafka.KafkaRecordBatch ; import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions ; @ApplicationScoped public class KafkaExactlyOnceProcessor { @Inject @Channel ( \"tx-out-example\" ) KafkaTransactions < Integer > txProducer ; @Incoming ( \"in-channel\" ) public Uni < Void > emitInTransaction ( KafkaRecordBatch < String , Integer > batch ) { return txProducer . withTransaction ( batch , emitter -> { for ( KafkaRecord < String , Integer > record : batch ) { emitter . send ( KafkaRecord . of ( record . getKey (), record . getPayload () + 1 )); } return Uni . createFrom (). voidItem (); }); } } If the processing completes successfully, before committing the transaction, the topic partition offsets of the given batch message will be committed to the transaction. If the processing needs to abort, after aborting the transaction, the consumer's position is reset to the last committed offset, effectively resuming the consumption from that offset. If no consumer offset has been committed, the consumer's position is reset to the beginning of the topic, even if the offset reset policy is latest . Important When using exactly-once processing, consumed message offset commits are handled by the transaction and therefore commit-strategy needs to be ignore . Any strategy can be employed for the failure-strategy . Note that the Uni returned from the #withTransaction will yield a failure if the transaction fails and is aborted. The application can choose to handle the error case, but for the message consumption to continue, Uni returned from the @Incoming method must not result in failure. KafkaTransactions#withTransactionAndAck method will ack and nack the message but will not stop the reactive stream. Ignoring the failure simply resets the consumer to the last committed offsets and resumes the processing from there. Note It is recommended to use exactly-once processing along with the batch consumption mode. While it is possible to use it with a single Kafka message, it'll have a significant performance impact.","title":"Kafka Transactions and Exactly-Once Processing"},{"location":"kafka/transactions/#kafka-transactions-and-exactly-once-processing","text":"Experimental Kafka Transactions is an experimental feature. Kafka transactions enable atomic writes to multiple Kafka topics and partitions. Inside a transaction, a producer writes records to the Kafka topic partitions as it would normally do. If the transaction completes successfully, all the records previously written to the broker inside that transaction will be committed , and will be readable for consumers. If an error during the transaction causes it to be aborted , none will be readable for consumers. There are a couple of fundamental things to consider before using transactions: Each transactional producer is configured with a unique identifier called the transactional.id . This is used to identify the same producer instance across application restarts. By default, it is not configured, and transactions cannot be used. When it is configured, the producer is limited to idempotent delivery, therefore enable.idempotence=true is implied. For only reading transactional messages, a consumer needs to explicitly configure its isolation.level property to read_committed . This will make sure that the consumer will deliver only records committed inside a transaction, and filter out messages from aborted transactions. It should also be noted that this does not mean all records atomically written inside a transaction will be read atomically by the consumer. Transactional producers can write to multiple topics and partitions inside a transaction, but consumers do not know where the transaction starts or ends. Not only multiple consumers inside a consumer group can share those partitions, all records which were part of a single transaction can be consumed in different batch of records by a consumer. Kafka connector provides KafkaTransactions custom emitter for writing records inside a transaction. Before using a transaction we need to make sure that transactional.id is configured on the channel properties. 1 mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer It can be used as a regular emitter @Channel : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 package kafka.outbound ; import javax.enterprise.context.ApplicationScoped ; import javax.inject.Inject ; import org.eclipse.microprofile.reactive.messaging.Channel ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaRecord ; import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions ; @ApplicationScoped public class KafkaTransactionalProducer { @Inject @Channel ( \"tx-out-example\" ) KafkaTransactions < String > txProducer ; public Uni < Void > emitInTransaction () { return txProducer . withTransaction ( emitter -> { emitter . send ( KafkaRecord . of ( 1 , \"a\" )); emitter . send ( KafkaRecord . of ( 2 , \"b\" )); emitter . send ( KafkaRecord . of ( 3 , \"c\" )); return Uni . createFrom (). voidItem (); }); } } Note When transactional.id is provided KafkaProducer#initTransactions is called when the underlying Kafka producer is created. The function given to the withTransaction method receives a TransactionalEmitter for producing records, and returns a Uni that provides the result of the transaction. If the processing completes successfully, the producer is flushed and the transaction is committed. If the processing throws an exception, returns a failing Uni , or marks the TransactionalEmitter for abort, the transaction is aborted. If this method is called on a Vert.x context, the processing function is also called on that context. Otherwise, it is called on the sending thread of the producer. Important A transaction is considered in progress from the call to the withTransaction until the returned Uni results in success or failure. While a transaction is in progress, subsequent calls to the withTransaction , including nested ones inside the given function, will throw IllegalStateException . Note that in Reactive Messaging, the execution of processing methods is already serialized, unless @Blocking(ordered = false) is used. If withTransaction can be called concurrently, for example from a REST endpoint, it is recommended to limit the concurrency of the execution. This can be done using the @Bulkhead annotation from Microprofile Fault Tolerance.","title":"Kafka Transactions and Exactly-Once Processing"},{"location":"kafka/transactions/#exactly-once-processing","text":"Kafka Transactions API also allows managing consumer offsets inside a transaction, together with produced messages. This in turn enables coupling a consumer with a transactional producer in a consume-transform-produce pattern, also known as exactly-once processing. It means that an application consumes messages from a topic-partition, processes them, publishes the results to a topic-partition, and commits offsets of the consumed messages in a transaction. The KafkaTransactions emitter also provides a way to apply exactly-once processing to an incoming Kafka message inside a transaction. The following example includes a batch of Kafka records inside a transaction. 1 2 3 4 mp.messaging.outgoing.tx-out-example.transactional.id=example-tx-producer mp.messaging.outgoing.in-channel.batch=true mp.messaging.outgoing.in-channel.commit-strategy=ignore mp.messaging.outgoing.in-channel.failure-strategy=ignore 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 package kafka.outbound ; import javax.enterprise.context.ApplicationScoped ; import javax.inject.Inject ; import org.eclipse.microprofile.reactive.messaging.Channel ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import io.smallrye.mutiny.Uni ; import io.smallrye.reactive.messaging.kafka.KafkaRecord ; import io.smallrye.reactive.messaging.kafka.KafkaRecordBatch ; import io.smallrye.reactive.messaging.kafka.transactions.KafkaTransactions ; @ApplicationScoped public class KafkaExactlyOnceProcessor { @Inject @Channel ( \"tx-out-example\" ) KafkaTransactions < Integer > txProducer ; @Incoming ( \"in-channel\" ) public Uni < Void > emitInTransaction ( KafkaRecordBatch < String , Integer > batch ) { return txProducer . withTransaction ( batch , emitter -> { for ( KafkaRecord < String , Integer > record : batch ) { emitter . send ( KafkaRecord . of ( record . getKey (), record . getPayload () + 1 )); } return Uni . createFrom (). voidItem (); }); } } If the processing completes successfully, before committing the transaction, the topic partition offsets of the given batch message will be committed to the transaction. If the processing needs to abort, after aborting the transaction, the consumer's position is reset to the last committed offset, effectively resuming the consumption from that offset. If no consumer offset has been committed, the consumer's position is reset to the beginning of the topic, even if the offset reset policy is latest . Important When using exactly-once processing, consumed message offset commits are handled by the transaction and therefore commit-strategy needs to be ignore . Any strategy can be employed for the failure-strategy . Note that the Uni returned from the #withTransaction will yield a failure if the transaction fails and is aborted. The application can choose to handle the error case, but for the message consumption to continue, Uni returned from the @Incoming method must not result in failure. KafkaTransactions#withTransactionAndAck method will ack and nack the message but will not stop the reactive stream. Ignoring the failure simply resets the consumer to the last committed offsets and resumes the processing from there. Note It is recommended to use exactly-once processing along with the batch consumption mode. While it is possible to use it with a single Kafka message, it'll have a significant performance impact.","title":"Exactly-Once Processing"},{"location":"kafka/writing-kafka-records/","text":"Writing Kafka Records The Kafka Connector can write Reactive Messaging Messages as Kafka Records. Example Let\u2019s imagine you have a Kafka broker running, and accessible using the kafka:9092 address (by default it would use localhost:9092 ). Configure your application to write the messages from the prices channel into a Kafka topic as follows: 1 2 3 4 5 kafka.bootstrap.servers = kafka:9092 # <1> mp.messaging.outgoing.prices-out.connector = smallrye-kafka # <2> mp.messaging.outgoing.prices-out.value.serializer = org.apache.kafka.common.serialization.DoubleSerializer # <3> mp.messaging.outgoing.prices-out.topic = prices # <4> 1. Configure the broker location. You can configure it globally or per channel 2. Configure the connector to manage the prices channel 3. Sets the (Kafka) serializer to encode the message payload into the record\u2019s value 4. Make sure the topic name is prices (and not the default prices-out ) Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package kafka.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class KafkaPriceProducer { private final Random random = new Random (); @Outgoing ( \"prices-out\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package kafka.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class KafkaPriceMessageProducer { private final Random random = new Random (); @Outgoing ( \"prices-out\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } } Serialization The serialization is handled by the underlying Kafka Client. You need to configure the: mp.messaging.outgoing.[channel-name].value.serializer to configure the value serializer (mandatory) mp.messaging.outgoing.[channel-name].key.serializer to configure the key serializer (optional, default to String ) If you want to use a custom serializer, add it to your CLASSPATH and configure the associate attribute. By default, the written record contains: the Message payload as value no key, or the key configured using the key attribute or the key passed in the metadata attached to the Message the timestamp computed for the system clock ( now ) or the timestamp passed in the metadata attached to the Message Sending key/value pairs In the Kafka world, it\u2019s often necessary to send records , i.e. a key/value pair. The connector provides the io.smallrye.reactive.messaging.kafka.Record class that you can use to send a pair: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Record < String , String > process ( String in ) { return Record . of ( \"my-key\" , in ); } When the connector receives a message with a Record payload, it extracts the key and value from it. The configured serializers for the key and the value must be compatible with the record\u2019s key and value. Note that the key and the value can be null . It is also possible to create a record with a null key AND a null value. If you need more control on the written records, use OutgoingKafkaRecordMetadata . Outbound Metadata When sending Messages , you can add an instance of OutgoingKafkaRecordMetadata to influence how the message is going to be written to Kafka. For example, you can add Kafka headers, configure the record key\u2026 1 2 3 4 5 6 7 8 9 10 // Creates an OutgoingKafkaRecordMetadata // The type parameter is the type of the record's key OutgoingKafkaRecordMetadata < String > metadata = OutgoingKafkaRecordMetadata . < String > builder () . withKey ( \"my-key\" ) . withHeaders ( new RecordHeaders (). add ( \"my-header\" , \"value\" . getBytes ())) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); Propagating Record Key When processing messages, you can propagate incoming record key to the outgoing record. Consider the following example method, which consumes messages from the channel in , transforms the payload, and writes the result to the channel out . 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public double process ( int in ) { return in * 0.88 ; } Enabled with mp.messaging.outgoing.[channel-name].propagate-record-key=true configuration, record key propagation produces the outgoing record with the same key as the incoming record. If the outgoing record already contains a key , it won\u2019t be overridden by the incoming record key. If the incoming record does have a null key, the mp.messaging.outgoing.[channel-name].key property is used. Propagating Record headers You can also propagate incoming record headers to the outgoing record, by specifying the list of headers to be considered. mp.messaging.outgoing.[channel-name].propagate-headers=Authorization,Proxy-Authorization If the ougoing record already defines a header with the same key, it won't be overriden by the incoming header. Dynamic topic names Sometimes it is desirable to select the destination of a message dynamically. In this case, you should not configure the topic inside your application configuration file, but instead, use the outbound metadata to set the name of the topic. For example, you can route to a dynamic topic based on the incoming message: 1 2 3 4 5 6 7 8 String topicName = selectTopicFromIncommingMessage ( incoming ); OutgoingKafkaRecordMetadata < String > metadata = OutgoingKafkaRecordMetadata . < String > builder () . withTopic ( topicName ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata ); Acknowledgement Kafka acknowledgement can take times depending on the configuration. Also, it stores in-memory the records that cannot be written. By default, the connector does wait for Kafka to acknowledge the record to continue the processing (acknowledging the received Message ). You can disable this by setting the waitForWriteCompletion attribute to false . Note that the acks attribute has a huge impact on the record acknowledgement. If a record cannot be written, the message is nacked . Back-pressure and inflight records The Kafka outbound connector handles back-pressure monitoring the number of in-flight messages waiting to be written to the Kafka broker. The number of in-flight messages is configured using the max-inflight-messages attribute and defaults to 1024. The connector only sends that amount of messages concurrently. No other messages will be sent until at least one in-flight message gets acknowledged by the broker. Then, the connector writes a new message to Kafka when one of the broker\u2019s in-flight messages get acknowledged. Be sure to configure Kafka\u2019s batch.size and linger.ms accordingly. You can also remove the limit of inflight messages by setting max-inflight-messages to 0 . However, note that the Kafka Producer may block if the number of requests reaches max.in.flight.requests.per.connection . Handling serialization failures For Kafka producer client serialization failures are not recoverable, thus the message dispatch is not retried. However, using schema registries, serialization may intermittently fail to contact the registry. In these cases you may need to apply a failure strategy for the serializer. To achieve this, create a CDI bean implementing the SerializationFailureHandler interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @ApplicationScoped @Identifier ( \"failure-fallback\" ) // Set the name of the failure handler public class MySerializationFailureHandler implements SerializationFailureHandler < JsonObject > { // Specify the expected type @Override public byte [] decorateSerialization ( Uni < byte []> serialization , String topic , boolean isKey , String serializer , Object data , Headers headers ) { return serialization . onFailure (). retry (). atMost ( 3 ) . await (). atMost ( Duration . ofMillis ( 200 )); } } The bean must be exposed with the @Identifier qualifier specifying the name of the bean. Then, in the connector configuration, specify the following attribute: mp.messaging.incoming.$channel.key-serialization-failure-handler : name of the bean handling serialization failures happening for the record\u2019s key mp.messaging.incoming.$channel.value-serialization-failure-handler : name of the bean handling serialization failures happening for the record\u2019s value, The handler is called with the serialization action as a Uni , the record\u2019s topic, a boolean indicating whether the failure happened on a key, the class name of the deserializer that throws the exception, the corrupted data, the exception, and the records headers. Failure strategies like retry, providing a fallback value or applying timeout can be implemented. Note that the method must await on the result and return the serialized byte array. Alternatively, the handler can implement decorateSerialization method which can return a fallback value. Sending Cloud Events The Kafka connector supports Cloud Events . The connector sends the outbound record as Cloud Events if: the message metadata contains an io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instance, the channel configuration defines the cloud-events-type and cloud-events-source attributes. You can create io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances using: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package kafka.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class KafkaCloudEventProcessor { @Outgoing ( \"cloud-events\" ) public Message < String > toCloudEvents ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greetings\" ) . withSource ( URI . create ( \"http://example.com\" )) . withSubject ( \"greeting-message\" ) . build ()); } } If the metadata does not contain an id, the connector generates one (random UUID). The type and source can be configured per message or at the channel level using the cloud-events-type and cloud-events-source attributes. Other attributes are also configurable. The metadata can be contributed by multiple methods, however, you must always retrieve the already existing metadata to avoid overriding the values: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 package kafka.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class KafkaCloudEventMultipleProcessors { @Incoming ( \"source\" ) @Outgoing ( \"processed\" ) public Message < String > process ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greeting\" ) . build ()); } @SuppressWarnings ( \"unchecked\" ) @Incoming ( \"processed\" ) @Outgoing ( \"cloud-events\" ) public Message < String > process2 ( Message < String > in ) { OutgoingCloudEventMetadata < String > metadata = in . getMetadata ( OutgoingCloudEventMetadata . class ) . orElseGet (() -> OutgoingCloudEventMetadata . builder (). build ()); return in . addMetadata ( OutgoingCloudEventMetadata . from ( metadata ) . withSource ( URI . create ( \"source://me\" )) . withSubject ( \"test\" ) . build ()); } } By default, the connector sends the Cloud Events using the binary format. You can write structured Cloud Events by setting the cloud-events-mode to structured . Only JSON is supported, so the created records had its content-type header set to application/cloudevents+json; charset=UTF-8 When using the structured mode, the value serializer must be set to org.apache.kafka.common.serialization.StringSerializer , otherwise the connector reports the error. In addition, in structured , the connector maps the message\u2019s payload to JSON, except for String passed directly. The record\u2019s key can be set in the channel configuration ( key attribute), in the OutgoingKafkaRecordMetadata or using the partitionkey Cloud Event attribute. Note you can disable the Cloud Event support by setting the cloud-events attribute to false Using ProducerRecord Kafka built-in type ProducerRecord\\ can also be used for producing messages: 1 2 3 4 @Outgoing ( \"out\" ) public ProducerRecord < String , String > generate () { return new ProducerRecord <> ( \"my-topic\" , \"key\" , \"value\" ); } Warning This is an advanced feature. The ProducerRecord is sent to Kafka as is. Any possible metadata attached through Message> are ignored and lost. Producer Interceptors Producer interceptors can be configured for Kafka producer clients using the standard interceptor.classes property. Configured classes will be instantiated by the Kafka producer on client creation. Alternatively, producer clients can be configured with a CDI managed-bean implementing org.apache.kafka.clients.producer.ProducerInterceptor interface: To achieve this, the bean must be exposed with the @Identifier qualifier specifying the name of the bean: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 package kafka.outbound ; import java.util.Map ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.producer.ProducerInterceptor ; import org.apache.kafka.clients.producer.ProducerRecord ; import org.apache.kafka.clients.producer.RecordMetadata ; import io.smallrye.common.annotation.Identifier ; @ApplicationScoped @Identifier ( \"my-producer-interceptor\" ) public class ProducerInterceptorBeanExample implements ProducerInterceptor < Integer , String > { @Override public ProducerRecord < Integer , String > onSend ( ProducerRecord < Integer , String > producerRecord ) { // called before send return producerRecord ; } @Override public void onAcknowledgement ( RecordMetadata recordMetadata , Exception e ) { // called on send acknowledgement callback } @Override public void close () { // called on client close } @Override public void configure ( Map < String , ?> map ) { // called on client configuration } } Then, in the channel configuration, specify the following attribute: mp.messaging.incoming.$channel.interceptor-bean=my-producer-interceptor . Warning The onSend method will be called on the producer sending thread and onAcknowledgement will be called on the Kafka producer I/O thread . In both cases if implementations are not fast, sending of messages could be delayed. Configuration Reference Attribute ( alias ) Description Type Mandatory Default acks The number of acknowledgments the producer requires the leader to have received before considering a request complete. This controls the durability of records that are sent. Accepted values are: 0, 1, all string false 1 bootstrap.servers (kafka.bootstrap.servers) A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster. string false localhost:9092 buffer.memory The total bytes of memory the producer can use to buffer records waiting to be sent to the server. long false 33554432 client-id-prefix Prefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value. string false close-timeout The amount of milliseconds waiting for a graceful shutdown of the Kafka producer int false 10000 cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true cloud-events-data-content-type (cloud-events-default-data-content-type) Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the datacontenttype attribute itself string false cloud-events-data-schema (cloud-events-default-data-schema) Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the dataschema attribute itself string false cloud-events-insert-timestamp (cloud-events-default-timestamp) Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the time attribute itself boolean false true cloud-events-mode The Cloud Event mode ( structured or binary (default)). Indicates how are written the cloud events in the outgoing record string false binary cloud-events-source (cloud-events-default-source) Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the source attribute itself string false cloud-events-subject (cloud-events-default-subject) Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the subject attribute itself string false cloud-events-type (cloud-events-default-type) Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the type attribute itself string false health-enabled Whether health reporting is enabled (default) or disabled boolean false true health-readiness-enabled Whether readiness health reporting is enabled (default) or disabled boolean false true health-readiness-timeout deprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead. long false health-readiness-topic-verification deprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead. boolean false health-topic-verification-enabled Whether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection. boolean false false health-topic-verification-timeout During the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. long false 2000 interceptor-bean The name set in @Identifier of a bean that implements org.apache.kafka.clients.producer.ProducerInterceptor . If set, the identified bean will be used as the producer interceptor. string false kafka-configuration Identifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier. string false key A key to used when writing the record string false key-serialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler . If set, serialization failure happening when serializing keys are delegated to this handler which may provide a fallback value. string false key.serializer The serializer classname used to serialize the record's key string false org.apache.kafka.common.serialization.StringSerializer lazy-client Whether Kafka client is created lazily or eagerly. boolean false false max-inflight-messages The maximum number of messages to be written to Kafka concurrently. It limits the number of messages waiting to be written and acknowledged by the broker. You can set this attribute to 0 remove the limit long false 1024 merge Whether the connector should allow multiple upstreams boolean false false partition The target partition id. -1 to let the client determine the partition int false -1 propagate-headers A comma-separating list of incoming record headers to be propagated to the outgoing record string false `` propagate-record-key Propagate incoming record key to the outgoing record boolean false false retries If set to a positive number, the connector will try to resend any record that was not delivered successfully (with a potentially transient error) until the number of retries is reached. If set to 0, retries are disabled. If not set, the connector tries to resend any record that failed to be delivered (because of a potentially transient error) during an amount of time configured by delivery.timeout.ms . long false 2147483647 topic The consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is used string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true value-serialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler . If set, serialization failure happening when serializing values are delegated to this handler which may provide a fallback value. string false value.serializer The serializer classname used to serialize the payload string true waitForWriteCompletion Whether the client waits for Kafka to acknowledge the written record before acknowledging the message boolean false true You can also pass any property supported by the underlying Kafka producer . For example, to configure the batch.size property, use: 1 mp.messaging.outgoing.[channel].batch.size = 32768 Some producer client properties are configured to sensible default values: If not set, reconnect.backoff.max.ms is set to 10000 to avoid high load on disconnection. If not set, key.serializer is set to org.apache.kafka.common.serialization.StringSerializer . If not set, producer client.id is generated as kafka-producer-[channel] .","title":"Writing records"},{"location":"kafka/writing-kafka-records/#writing-kafka-records","text":"The Kafka Connector can write Reactive Messaging Messages as Kafka Records.","title":"Writing Kafka Records"},{"location":"kafka/writing-kafka-records/#example","text":"Let\u2019s imagine you have a Kafka broker running, and accessible using the kafka:9092 address (by default it would use localhost:9092 ). Configure your application to write the messages from the prices channel into a Kafka topic as follows: 1 2 3 4 5 kafka.bootstrap.servers = kafka:9092 # <1> mp.messaging.outgoing.prices-out.connector = smallrye-kafka # <2> mp.messaging.outgoing.prices-out.value.serializer = org.apache.kafka.common.serialization.DoubleSerializer # <3> mp.messaging.outgoing.prices-out.topic = prices # <4> 1. Configure the broker location. You can configure it globally or per channel 2. Configure the connector to manage the prices channel 3. Sets the (Kafka) serializer to encode the message payload into the record\u2019s value 4. Make sure the topic name is prices (and not the default prices-out ) Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package kafka.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class KafkaPriceProducer { private final Random random = new Random (); @Outgoing ( \"prices-out\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package kafka.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class KafkaPriceMessageProducer { private final Random random = new Random (); @Outgoing ( \"prices-out\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } }","title":"Example"},{"location":"kafka/writing-kafka-records/#serialization","text":"The serialization is handled by the underlying Kafka Client. You need to configure the: mp.messaging.outgoing.[channel-name].value.serializer to configure the value serializer (mandatory) mp.messaging.outgoing.[channel-name].key.serializer to configure the key serializer (optional, default to String ) If you want to use a custom serializer, add it to your CLASSPATH and configure the associate attribute. By default, the written record contains: the Message payload as value no key, or the key configured using the key attribute or the key passed in the metadata attached to the Message the timestamp computed for the system clock ( now ) or the timestamp passed in the metadata attached to the Message","title":"Serialization"},{"location":"kafka/writing-kafka-records/#sending-keyvalue-pairs","text":"In the Kafka world, it\u2019s often necessary to send records , i.e. a key/value pair. The connector provides the io.smallrye.reactive.messaging.kafka.Record class that you can use to send a pair: 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public Record < String , String > process ( String in ) { return Record . of ( \"my-key\" , in ); } When the connector receives a message with a Record payload, it extracts the key and value from it. The configured serializers for the key and the value must be compatible with the record\u2019s key and value. Note that the key and the value can be null . It is also possible to create a record with a null key AND a null value. If you need more control on the written records, use OutgoingKafkaRecordMetadata .","title":"Sending key/value pairs"},{"location":"kafka/writing-kafka-records/#outbound-metadata","text":"When sending Messages , you can add an instance of OutgoingKafkaRecordMetadata to influence how the message is going to be written to Kafka. For example, you can add Kafka headers, configure the record key\u2026 1 2 3 4 5 6 7 8 9 10 // Creates an OutgoingKafkaRecordMetadata // The type parameter is the type of the record's key OutgoingKafkaRecordMetadata < String > metadata = OutgoingKafkaRecordMetadata . < String > builder () . withKey ( \"my-key\" ) . withHeaders ( new RecordHeaders (). add ( \"my-header\" , \"value\" . getBytes ())) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata );","title":"Outbound Metadata"},{"location":"kafka/writing-kafka-records/#propagating-record-key","text":"When processing messages, you can propagate incoming record key to the outgoing record. Consider the following example method, which consumes messages from the channel in , transforms the payload, and writes the result to the channel out . 1 2 3 4 5 @Incoming ( \"in\" ) @Outgoing ( \"out\" ) public double process ( int in ) { return in * 0.88 ; } Enabled with mp.messaging.outgoing.[channel-name].propagate-record-key=true configuration, record key propagation produces the outgoing record with the same key as the incoming record. If the outgoing record already contains a key , it won\u2019t be overridden by the incoming record key. If the incoming record does have a null key, the mp.messaging.outgoing.[channel-name].key property is used.","title":"Propagating Record Key"},{"location":"kafka/writing-kafka-records/#propagating-record-headers","text":"You can also propagate incoming record headers to the outgoing record, by specifying the list of headers to be considered. mp.messaging.outgoing.[channel-name].propagate-headers=Authorization,Proxy-Authorization If the ougoing record already defines a header with the same key, it won't be overriden by the incoming header.","title":"Propagating Record headers"},{"location":"kafka/writing-kafka-records/#dynamic-topic-names","text":"Sometimes it is desirable to select the destination of a message dynamically. In this case, you should not configure the topic inside your application configuration file, but instead, use the outbound metadata to set the name of the topic. For example, you can route to a dynamic topic based on the incoming message: 1 2 3 4 5 6 7 8 String topicName = selectTopicFromIncommingMessage ( incoming ); OutgoingKafkaRecordMetadata < String > metadata = OutgoingKafkaRecordMetadata . < String > builder () . withTopic ( topicName ) . build (); // Create a new message from the `incoming` message // Add `metadata` to the metadata from the `incoming` message. return incoming . addMetadata ( metadata );","title":"Dynamic topic names"},{"location":"kafka/writing-kafka-records/#acknowledgement","text":"Kafka acknowledgement can take times depending on the configuration. Also, it stores in-memory the records that cannot be written. By default, the connector does wait for Kafka to acknowledge the record to continue the processing (acknowledging the received Message ). You can disable this by setting the waitForWriteCompletion attribute to false . Note that the acks attribute has a huge impact on the record acknowledgement. If a record cannot be written, the message is nacked .","title":"Acknowledgement"},{"location":"kafka/writing-kafka-records/#back-pressure-and-inflight-records","text":"The Kafka outbound connector handles back-pressure monitoring the number of in-flight messages waiting to be written to the Kafka broker. The number of in-flight messages is configured using the max-inflight-messages attribute and defaults to 1024. The connector only sends that amount of messages concurrently. No other messages will be sent until at least one in-flight message gets acknowledged by the broker. Then, the connector writes a new message to Kafka when one of the broker\u2019s in-flight messages get acknowledged. Be sure to configure Kafka\u2019s batch.size and linger.ms accordingly. You can also remove the limit of inflight messages by setting max-inflight-messages to 0 . However, note that the Kafka Producer may block if the number of requests reaches max.in.flight.requests.per.connection .","title":"Back-pressure and inflight records"},{"location":"kafka/writing-kafka-records/#handling-serialization-failures","text":"For Kafka producer client serialization failures are not recoverable, thus the message dispatch is not retried. However, using schema registries, serialization may intermittently fail to contact the registry. In these cases you may need to apply a failure strategy for the serializer. To achieve this, create a CDI bean implementing the SerializationFailureHandler interface: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 @ApplicationScoped @Identifier ( \"failure-fallback\" ) // Set the name of the failure handler public class MySerializationFailureHandler implements SerializationFailureHandler < JsonObject > { // Specify the expected type @Override public byte [] decorateSerialization ( Uni < byte []> serialization , String topic , boolean isKey , String serializer , Object data , Headers headers ) { return serialization . onFailure (). retry (). atMost ( 3 ) . await (). atMost ( Duration . ofMillis ( 200 )); } } The bean must be exposed with the @Identifier qualifier specifying the name of the bean. Then, in the connector configuration, specify the following attribute: mp.messaging.incoming.$channel.key-serialization-failure-handler : name of the bean handling serialization failures happening for the record\u2019s key mp.messaging.incoming.$channel.value-serialization-failure-handler : name of the bean handling serialization failures happening for the record\u2019s value, The handler is called with the serialization action as a Uni , the record\u2019s topic, a boolean indicating whether the failure happened on a key, the class name of the deserializer that throws the exception, the corrupted data, the exception, and the records headers. Failure strategies like retry, providing a fallback value or applying timeout can be implemented. Note that the method must await on the result and return the serialized byte array. Alternatively, the handler can implement decorateSerialization method which can return a fallback value.","title":"Handling serialization failures"},{"location":"kafka/writing-kafka-records/#sending-cloud-events","text":"The Kafka connector supports Cloud Events . The connector sends the outbound record as Cloud Events if: the message metadata contains an io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instance, the channel configuration defines the cloud-events-type and cloud-events-source attributes. You can create io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata instances using: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package kafka.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class KafkaCloudEventProcessor { @Outgoing ( \"cloud-events\" ) public Message < String > toCloudEvents ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greetings\" ) . withSource ( URI . create ( \"http://example.com\" )) . withSubject ( \"greeting-message\" ) . build ()); } } If the metadata does not contain an id, the connector generates one (random UUID). The type and source can be configured per message or at the channel level using the cloud-events-type and cloud-events-source attributes. Other attributes are also configurable. The metadata can be contributed by multiple methods, however, you must always retrieve the already existing metadata to avoid overriding the values: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 package kafka.outbound ; import java.net.URI ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.reactive.messaging.ce.OutgoingCloudEventMetadata ; @ApplicationScoped public class KafkaCloudEventMultipleProcessors { @Incoming ( \"source\" ) @Outgoing ( \"processed\" ) public Message < String > process ( Message < String > in ) { return in . addMetadata ( OutgoingCloudEventMetadata . builder () . withId ( \"id-\" + in . getPayload ()) . withType ( \"greeting\" ) . build ()); } @SuppressWarnings ( \"unchecked\" ) @Incoming ( \"processed\" ) @Outgoing ( \"cloud-events\" ) public Message < String > process2 ( Message < String > in ) { OutgoingCloudEventMetadata < String > metadata = in . getMetadata ( OutgoingCloudEventMetadata . class ) . orElseGet (() -> OutgoingCloudEventMetadata . builder (). build ()); return in . addMetadata ( OutgoingCloudEventMetadata . from ( metadata ) . withSource ( URI . create ( \"source://me\" )) . withSubject ( \"test\" ) . build ()); } } By default, the connector sends the Cloud Events using the binary format. You can write structured Cloud Events by setting the cloud-events-mode to structured . Only JSON is supported, so the created records had its content-type header set to application/cloudevents+json; charset=UTF-8 When using the structured mode, the value serializer must be set to org.apache.kafka.common.serialization.StringSerializer , otherwise the connector reports the error. In addition, in structured , the connector maps the message\u2019s payload to JSON, except for String passed directly. The record\u2019s key can be set in the channel configuration ( key attribute), in the OutgoingKafkaRecordMetadata or using the partitionkey Cloud Event attribute. Note you can disable the Cloud Event support by setting the cloud-events attribute to false","title":"Sending Cloud Events"},{"location":"kafka/writing-kafka-records/#using-producerrecord","text":"Kafka built-in type ProducerRecord\\ can also be used for producing messages: 1 2 3 4 @Outgoing ( \"out\" ) public ProducerRecord < String , String > generate () { return new ProducerRecord <> ( \"my-topic\" , \"key\" , \"value\" ); } Warning This is an advanced feature. The ProducerRecord is sent to Kafka as is. Any possible metadata attached through Message> are ignored and lost.","title":"Using ProducerRecord"},{"location":"kafka/writing-kafka-records/#producer-interceptors","text":"Producer interceptors can be configured for Kafka producer clients using the standard interceptor.classes property. Configured classes will be instantiated by the Kafka producer on client creation. Alternatively, producer clients can be configured with a CDI managed-bean implementing org.apache.kafka.clients.producer.ProducerInterceptor interface: To achieve this, the bean must be exposed with the @Identifier qualifier specifying the name of the bean: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 package kafka.outbound ; import java.util.Map ; import javax.enterprise.context.ApplicationScoped ; import org.apache.kafka.clients.producer.ProducerInterceptor ; import org.apache.kafka.clients.producer.ProducerRecord ; import org.apache.kafka.clients.producer.RecordMetadata ; import io.smallrye.common.annotation.Identifier ; @ApplicationScoped @Identifier ( \"my-producer-interceptor\" ) public class ProducerInterceptorBeanExample implements ProducerInterceptor < Integer , String > { @Override public ProducerRecord < Integer , String > onSend ( ProducerRecord < Integer , String > producerRecord ) { // called before send return producerRecord ; } @Override public void onAcknowledgement ( RecordMetadata recordMetadata , Exception e ) { // called on send acknowledgement callback } @Override public void close () { // called on client close } @Override public void configure ( Map < String , ?> map ) { // called on client configuration } } Then, in the channel configuration, specify the following attribute: mp.messaging.incoming.$channel.interceptor-bean=my-producer-interceptor . Warning The onSend method will be called on the producer sending thread and onAcknowledgement will be called on the Kafka producer I/O thread . In both cases if implementations are not fast, sending of messages could be delayed.","title":"Producer Interceptors"},{"location":"kafka/writing-kafka-records/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default acks The number of acknowledgments the producer requires the leader to have received before considering a request complete. This controls the durability of records that are sent. Accepted values are: 0, 1, all string false 1 bootstrap.servers (kafka.bootstrap.servers) A comma-separated list of host:port to use for establishing the initial connection to the Kafka cluster. string false localhost:9092 buffer.memory The total bytes of memory the producer can use to buffer records waiting to be sent to the server. long false 33554432 client-id-prefix Prefix for Kafka client client.id attribute. If defined configured or generated client.id will be prefixed with the given value. string false close-timeout The amount of milliseconds waiting for a graceful shutdown of the Kafka producer int false 10000 cloud-events Enables (default) or disables the Cloud Event support. If enabled on an incoming channel, the connector analyzes the incoming records and try to create Cloud Event metadata. If enabled on an outgoing , the connector sends the outgoing messages as Cloud Event if the message includes Cloud Event Metadata. boolean false true cloud-events-data-content-type (cloud-events-default-data-content-type) Configure the default datacontenttype attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the datacontenttype attribute itself string false cloud-events-data-schema (cloud-events-default-data-schema) Configure the default dataschema attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the dataschema attribute itself string false cloud-events-insert-timestamp (cloud-events-default-timestamp) Whether or not the connector should insert automatically the time attribute into the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the time attribute itself boolean false true cloud-events-mode The Cloud Event mode ( structured or binary (default)). Indicates how are written the cloud events in the outgoing record string false binary cloud-events-source (cloud-events-default-source) Configure the default source attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the source attribute itself string false cloud-events-subject (cloud-events-default-subject) Configure the default subject attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the subject attribute itself string false cloud-events-type (cloud-events-default-type) Configure the default type attribute of the outgoing Cloud Event. Requires cloud-events to be set to true . This value is used if the message does not configure the type attribute itself string false health-enabled Whether health reporting is enabled (default) or disabled boolean false true health-readiness-enabled Whether readiness health reporting is enabled (default) or disabled boolean false true health-readiness-timeout deprecated - During the readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. Deprecated: Use 'health-topic-verification-timeout' instead. long false health-readiness-topic-verification deprecated - Whether the readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin connection. Deprecated: Use 'health-topic-verification-enabled' instead. boolean false health-topic-verification-enabled Whether the startup and readiness check should verify that topics exist on the broker. Default to false. Enabling it requires an admin client connection. boolean false false health-topic-verification-timeout During the startup and readiness health check, the connector connects to the broker and retrieves the list of topics. This attribute specifies the maximum duration (in ms) for the retrieval. If exceeded, the channel is considered not-ready. long false 2000 interceptor-bean The name set in @Identifier of a bean that implements org.apache.kafka.clients.producer.ProducerInterceptor . If set, the identified bean will be used as the producer interceptor. string false kafka-configuration Identifier of a CDI bean that provides the default Kafka consumer/producer configuration for this channel. The channel configuration can still override any attribute. The bean must have a type of Map and must use the @io.smallrye.common.annotation.Identifier qualifier to set the identifier. string false key A key to used when writing the record string false key-serialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler . If set, serialization failure happening when serializing keys are delegated to this handler which may provide a fallback value. string false key.serializer The serializer classname used to serialize the record's key string false org.apache.kafka.common.serialization.StringSerializer lazy-client Whether Kafka client is created lazily or eagerly. boolean false false max-inflight-messages The maximum number of messages to be written to Kafka concurrently. It limits the number of messages waiting to be written and acknowledged by the broker. You can set this attribute to 0 remove the limit long false 1024 merge Whether the connector should allow multiple upstreams boolean false false partition The target partition id. -1 to let the client determine the partition int false -1 propagate-headers A comma-separating list of incoming record headers to be propagated to the outgoing record string false `` propagate-record-key Propagate incoming record key to the outgoing record boolean false false retries If set to a positive number, the connector will try to resend any record that was not delivered successfully (with a potentially transient error) until the number of retries is reached. If set to 0, retries are disabled. If not set, the connector tries to resend any record that failed to be delivered (because of a potentially transient error) during an amount of time configured by delivery.timeout.ms . long false 2147483647 topic The consumed / populated Kafka topic. If neither this property nor the topics properties are set, the channel name is used string false tracing-enabled Whether tracing is enabled (default) or disabled boolean false true value-serialization-failure-handler The name set in @Identifier of a bean that implements io.smallrye.reactive.messaging.kafka.SerializationFailureHandler . If set, serialization failure happening when serializing values are delegated to this handler which may provide a fallback value. string false value.serializer The serializer classname used to serialize the payload string true waitForWriteCompletion Whether the client waits for Kafka to acknowledge the written record before acknowledging the message boolean false true You can also pass any property supported by the underlying Kafka producer . For example, to configure the batch.size property, use: 1 mp.messaging.outgoing.[channel].batch.size = 32768 Some producer client properties are configured to sensible default values: If not set, reconnect.backoff.max.ms is set to 10000 to avoid high load on disconnection. If not set, key.serializer is set to org.apache.kafka.common.serialization.StringSerializer . If not set, producer client.id is generated as kafka-producer-[channel] .","title":"Configuration Reference"},{"location":"mqtt/client-customization/","text":"Customizing the underlying MQTT client You can customize the underlying MQTT Client configuration by producing an instance of io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @Produces @Identifier ( \"my-options\" ) public MqttClientSessionOptions getOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return new MqttClientSessionOptions () . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name = my-options","title":"Customizing the MQTT client"},{"location":"mqtt/client-customization/#customizing-the-underlying-mqtt-client","text":"You can customize the underlying MQTT Client configuration by producing an instance of io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @Produces @Identifier ( \"my-options\" ) public MqttClientSessionOptions getOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return new MqttClientSessionOptions () . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name = my-options","title":"Customizing the underlying MQTT client"},{"location":"mqtt/mqtt/","text":"MQTT Connector The MQTT connector adds support for MQTT to Reactive Messaging. It lets you receive messages from an MQTT server or broker as well as send MQTT messages. The MQTT connector is based on the Vert.x MQTT Client . Introduction MQTT is a machine-to-machine (M2M)/\"Internet of Things\" connectivity protocol. It was designed as an extremely lightweight publish/subscribe messaging transport. The MQTT Connector allows consuming messages from MQTT as well as sending MQTT messages. Using the MQTT connector To you the MQTT Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-mqtt 3.25.0 The connector name is: smallrye-mqtt . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-mqtt # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-mqtt","title":"MQTT Connector"},{"location":"mqtt/mqtt/#mqtt-connector","text":"The MQTT connector adds support for MQTT to Reactive Messaging. It lets you receive messages from an MQTT server or broker as well as send MQTT messages. The MQTT connector is based on the Vert.x MQTT Client .","title":"MQTT Connector"},{"location":"mqtt/mqtt/#introduction","text":"MQTT is a machine-to-machine (M2M)/\"Internet of Things\" connectivity protocol. It was designed as an extremely lightweight publish/subscribe messaging transport. The MQTT Connector allows consuming messages from MQTT as well as sending MQTT messages.","title":"Introduction"},{"location":"mqtt/mqtt/#using-the-mqtt-connector","text":"To you the MQTT Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-mqtt 3.25.0 The connector name is: smallrye-mqtt . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-mqtt # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-mqtt","title":"Using the MQTT connector"},{"location":"mqtt/receiving-mqtt-messages/","text":"Receiving messages from MQTT The MQTT Connector connects to a MQTT broker or router, and forward the messages to the Reactive Messaging application. It maps each of them into Reactive Messaging Messages . Example Let\u2019s imagine you have a MQTT server/broker running, and accessible using the mqtt:1883 address (by default it would use localhost:1883 ). Configure your application to receive MQTT messages on the prices channel as follows: 1 2 3 mp.messaging.incoming.prices.connector = smallrye-mqtt # <1> mp.messaging.incoming.prices.host = mqtt # <2> mp.messaging.incoming.prices.port = 1883 # <3> 1. Sets the connector for the prices channel 2. Configure the broker/server host name. 3. Configure the broker/server port. 1883 is the default. Note You don\u2019t need to set the MQTT topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. Note It is generally recommended to set the client-id . By default, the connector is generating a unique client-id . Important Message coming from MQTT have a byte[] payload. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 package mqtt.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class MqttPriceConsumer { @Incoming ( \"prices\" ) public void consume ( byte [] raw ) { double price = Double . parseDouble ( new String ( raw )); // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package mqtt.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class MqttPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < byte []> price ) { // process your price. // Acknowledge the incoming message return price . ack (); } } The inbound topic can use the MQTT wildcards ( + and # ). Deserialization The MQTT Connector does not handle the deserialization and creates a Message . Inbound Metadata The MQTT connector does not provide inbound metadata. Failure Management If a message produced from a MQTT message is nacked , a failure strategy is applied. The MQTT connector supports 3 strategies: fail - fail the application, no more MQTT messages will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue. Configuration Reference Attribute ( alias ) Description Type Mandatory Default auto-clean-session Set to start with a clean session ( true by default) boolean false true auto-generated-client-id Set if the MQTT client must generate clientId automatically boolean false true auto-keep-alive Set if the MQTT client must handle PINGREQ automatically boolean false true broadcast Whether or not the messages should be dispatched to multiple consumers boolean false false buffer-size The size buffer of incoming messages waiting to be processed int false 128 client-id Set the client identifier string false client-options-name (mqtt-client-options-name) The name of the MQTT Client Option bean ( io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions ) used to customize the MQTT client configuration string false connect-timeout-seconds Set the connect timeout (in seconds) int false 60 failure-strategy Specify the failure strategy to apply when a message produced from a MQTT message is nacked. Values can be fail (default), or ignore string false fail health-enabled Whether health reporting is enabled (default) or disabled boolean false true host Set the MQTT server host name/IP string true keep-alive-seconds Set the keep alive timeout in seconds int false 30 max-inflight-queue Set max count of unacknowledged messages int false 10 max-message-size Set max MQTT message size in bytes int false 8092 password Set the password to connect to the server string false port Set the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without ssl int false qos Set the QoS level when subscribing to the topic or when sending a message int false 0 reconnect-interval-seconds Set the reconnect interval in seconds int false 1 server-name Set the SNI server name string false ssl Set whether SSL/TLS is enabled boolean false false ssl.keystore.location Set the keystore location. In case of pem type this is the server ca cert path string false ssl.keystore.password Set the keystore password. In case of pem type this is the key path string false ssl.keystore.type Set the keystore type [ pkcs12 , jks , pem ] string false pkcs12 ssl.truststore.location Set the truststore location. In case of pem type this is the client cert path string false ssl.truststore.password Set the truststore password. In case of pem type this is not necessary string false ssl.truststore.type Set the truststore type [ pkcs12 , jks , pem ] string false pkcs12 topic Set the MQTT topic. If not set, the channel name is used string false trust-all Set whether all server certificates should be trusted boolean false false unsubscribe-on-disconnection This flag restore the old behavior to unsubscribe from the broken on disconnection boolean false false username Set the username to connect to the server string false will-flag Set if will information are provided on connection boolean false false will-qos Set the QoS level for the will message int false 0 will-retain Set if the will message must be retained boolean false false The MQTT connector is based on the Vert.x MQTT client . So you can pass any attribute supported by this client. Important A single instance of MqttClient and a single connection is used for each host / port / server-name / client-id . This client is reused for both the inbound and outbound connectors. Important Using auto-clean-session=false the MQTT Connector send Subscribe requests to the broken only if a Persistent Session is not present (like on the first connection). This means that if a Session is already present (maybe for a previous run) and you add a new incoming channel, this will not be subscribed. Beware to check always the subscription present on Broker when use auto-clean-session=false .","title":"Receiving MQTT messages"},{"location":"mqtt/receiving-mqtt-messages/#receiving-messages-from-mqtt","text":"The MQTT Connector connects to a MQTT broker or router, and forward the messages to the Reactive Messaging application. It maps each of them into Reactive Messaging Messages .","title":"Receiving messages from MQTT"},{"location":"mqtt/receiving-mqtt-messages/#example","text":"Let\u2019s imagine you have a MQTT server/broker running, and accessible using the mqtt:1883 address (by default it would use localhost:1883 ). Configure your application to receive MQTT messages on the prices channel as follows: 1 2 3 mp.messaging.incoming.prices.connector = smallrye-mqtt # <1> mp.messaging.incoming.prices.host = mqtt # <2> mp.messaging.incoming.prices.port = 1883 # <3> 1. Sets the connector for the prices channel 2. Configure the broker/server host name. 3. Configure the broker/server port. 1883 is the default. Note You don\u2019t need to set the MQTT topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. Note It is generally recommended to set the client-id . By default, the connector is generating a unique client-id . Important Message coming from MQTT have a byte[] payload. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 package mqtt.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class MqttPriceConsumer { @Incoming ( \"prices\" ) public void consume ( byte [] raw ) { double price = Double . parseDouble ( new String ( raw )); // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package mqtt.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class MqttPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < byte []> price ) { // process your price. // Acknowledge the incoming message return price . ack (); } } The inbound topic can use the MQTT wildcards ( + and # ).","title":"Example"},{"location":"mqtt/receiving-mqtt-messages/#deserialization","text":"The MQTT Connector does not handle the deserialization and creates a Message .","title":"Deserialization"},{"location":"mqtt/receiving-mqtt-messages/#inbound-metadata","text":"The MQTT connector does not provide inbound metadata.","title":"Inbound Metadata"},{"location":"mqtt/receiving-mqtt-messages/#failure-management","text":"If a message produced from a MQTT message is nacked , a failure strategy is applied. The MQTT connector supports 3 strategies: fail - fail the application, no more MQTT messages will be processed. (default) The offset of the record that has not been processed correctly is not committed. ignore - the failure is logged, but the processing continue.","title":"Failure Management"},{"location":"mqtt/receiving-mqtt-messages/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default auto-clean-session Set to start with a clean session ( true by default) boolean false true auto-generated-client-id Set if the MQTT client must generate clientId automatically boolean false true auto-keep-alive Set if the MQTT client must handle PINGREQ automatically boolean false true broadcast Whether or not the messages should be dispatched to multiple consumers boolean false false buffer-size The size buffer of incoming messages waiting to be processed int false 128 client-id Set the client identifier string false client-options-name (mqtt-client-options-name) The name of the MQTT Client Option bean ( io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions ) used to customize the MQTT client configuration string false connect-timeout-seconds Set the connect timeout (in seconds) int false 60 failure-strategy Specify the failure strategy to apply when a message produced from a MQTT message is nacked. Values can be fail (default), or ignore string false fail health-enabled Whether health reporting is enabled (default) or disabled boolean false true host Set the MQTT server host name/IP string true keep-alive-seconds Set the keep alive timeout in seconds int false 30 max-inflight-queue Set max count of unacknowledged messages int false 10 max-message-size Set max MQTT message size in bytes int false 8092 password Set the password to connect to the server string false port Set the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without ssl int false qos Set the QoS level when subscribing to the topic or when sending a message int false 0 reconnect-interval-seconds Set the reconnect interval in seconds int false 1 server-name Set the SNI server name string false ssl Set whether SSL/TLS is enabled boolean false false ssl.keystore.location Set the keystore location. In case of pem type this is the server ca cert path string false ssl.keystore.password Set the keystore password. In case of pem type this is the key path string false ssl.keystore.type Set the keystore type [ pkcs12 , jks , pem ] string false pkcs12 ssl.truststore.location Set the truststore location. In case of pem type this is the client cert path string false ssl.truststore.password Set the truststore password. In case of pem type this is not necessary string false ssl.truststore.type Set the truststore type [ pkcs12 , jks , pem ] string false pkcs12 topic Set the MQTT topic. If not set, the channel name is used string false trust-all Set whether all server certificates should be trusted boolean false false unsubscribe-on-disconnection This flag restore the old behavior to unsubscribe from the broken on disconnection boolean false false username Set the username to connect to the server string false will-flag Set if will information are provided on connection boolean false false will-qos Set the QoS level for the will message int false 0 will-retain Set if the will message must be retained boolean false false The MQTT connector is based on the Vert.x MQTT client . So you can pass any attribute supported by this client. Important A single instance of MqttClient and a single connection is used for each host / port / server-name / client-id . This client is reused for both the inbound and outbound connectors. Important Using auto-clean-session=false the MQTT Connector send Subscribe requests to the broken only if a Persistent Session is not present (like on the first connection). This means that if a Session is already present (maybe for a previous run) and you add a new incoming channel, this will not be subscribed. Beware to check always the subscription present on Broker when use auto-clean-session=false .","title":"Configuration Reference"},{"location":"mqtt/sending-messages-to-mqtt/","text":"Sending messages to MQTT The MQTT Connector can write Reactive Messaging Messages as MQTT Message. Example Let\u2019s imagine you have a MQTT server/broker running, and accessible using the mqtt:1883 address (by default it would use localhost:1883 ). Configure your application to write the messages from the prices channel into a MQTT Messages as follows: 1 2 3 mp.messaging.outgoing.prices.type = smallrye-mqtt mp.messaging.outgoing.prices.host = mqtt mp.messaging.outgoing.prices.port = 1883 Sets the connector for the prices channel Configure the broker/server host name. Configure the broker/server port. 1883 is the default. Note You don\u2019t need to set the MQTT topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. NOTE: It is generally recommended to set the client-id . By default, the connector is generating a unique client-id . Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package mqtt.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class MqttPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package mqtt.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class MqttPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } } Serialization The Message sent to MQTT can have various payload types: JsonObject : JSON string encoded as byte[] JsonArray : JSON string encoded as byte[] java.lang.String and Java primitive types: toString encoded as byte[] byte[] complex objects: The objects are encoded to JSON and passed as byte[] Outbound Metadata The MQTT connector does not provide outbound metadata. Acknowledgement MQTT acknowledgement depends on the QoS level. The message is acknowledged when the broker indicated the successful reception of the message (or immediately if the level of QoS does not support acknowledgment). If a MQTT message cannot be sent to the broker, the message is nacked . Configuration Reference Attribute ( alias ) Description Type Mandatory Default auto-clean-session Set to start with a clean session ( true by default) boolean false true auto-generated-client-id Set if the MQTT client must generate clientId automatically boolean false true auto-keep-alive Set if the MQTT client must handle PINGREQ automatically boolean false true client-id Set the client identifier string false client-options-name (mqtt-client-options-name) The name of the MQTT Client Option bean ( io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions ) used to customize the MQTT client configuration string false connect-timeout-seconds Set the connect timeout (in seconds) int false 60 health-enabled Whether health reporting is enabled (default) or disabled boolean false true host Set the MQTT server host name/IP string true keep-alive-seconds Set the keep alive timeout in seconds int false 30 max-inflight-queue Set max count of unacknowledged messages int false 10 max-message-size Set max MQTT message size in bytes int false 8092 merge Whether the connector should allow multiple upstreams boolean false false password Set the password to connect to the server string false port Set the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without ssl int false qos Set the QoS level when subscribing to the topic or when sending a message int false 0 reconnect-interval-seconds Set the reconnect interval in seconds int false 1 server-name Set the SNI server name string false ssl Set whether SSL/TLS is enabled boolean false false ssl.keystore.location Set the keystore location. In case of pem type this is the server ca cert path string false ssl.keystore.password Set the keystore password. In case of pem type this is the key path string false ssl.keystore.type Set the keystore type [ pkcs12 , jks , pem ] string false pkcs12 ssl.truststore.location Set the truststore location. In case of pem type this is the client cert path string false ssl.truststore.password Set the truststore password. In case of pem type this is not necessary string false ssl.truststore.type Set the truststore type [ pkcs12 , jks , pem ] string false pkcs12 topic Set the MQTT topic. If not set, the channel name is used string false trust-all Set whether all server certificates should be trusted boolean false false unsubscribe-on-disconnection This flag restore the old behavior to unsubscribe from the broken on disconnection boolean false false username Set the username to connect to the server string false will-flag Set if will information are provided on connection boolean false false will-qos Set the QoS level for the will message int false 0 will-retain Set if the will message must be retained boolean false false The MQTT connector is based on the Vert.x MQTT client . So you can pass any attribute supported by this client. Important A single instance of MqttClient and a single connection is used for each host / port / server-name / client-id . This client is reused for both the inbound and outbound connectors.","title":"Sending MQTT messages"},{"location":"mqtt/sending-messages-to-mqtt/#sending-messages-to-mqtt","text":"The MQTT Connector can write Reactive Messaging Messages as MQTT Message.","title":"Sending messages to MQTT"},{"location":"mqtt/sending-messages-to-mqtt/#example","text":"Let\u2019s imagine you have a MQTT server/broker running, and accessible using the mqtt:1883 address (by default it would use localhost:1883 ). Configure your application to write the messages from the prices channel into a MQTT Messages as follows: 1 2 3 mp.messaging.outgoing.prices.type = smallrye-mqtt mp.messaging.outgoing.prices.host = mqtt mp.messaging.outgoing.prices.port = 1883 Sets the connector for the prices channel Configure the broker/server host name. Configure the broker/server port. 1883 is the default. Note You don\u2019t need to set the MQTT topic. By default, it uses the channel name ( prices ). You can configure the topic attribute to override it. NOTE: It is generally recommended to set the client-id . By default, the connector is generating a unique client-id . Then, your application must send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package mqtt.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class MqttPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 package mqtt.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class MqttPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble ())); } }","title":"Example"},{"location":"mqtt/sending-messages-to-mqtt/#serialization","text":"The Message sent to MQTT can have various payload types: JsonObject : JSON string encoded as byte[] JsonArray : JSON string encoded as byte[] java.lang.String and Java primitive types: toString encoded as byte[] byte[] complex objects: The objects are encoded to JSON and passed as byte[]","title":"Serialization"},{"location":"mqtt/sending-messages-to-mqtt/#outbound-metadata","text":"The MQTT connector does not provide outbound metadata.","title":"Outbound Metadata"},{"location":"mqtt/sending-messages-to-mqtt/#acknowledgement","text":"MQTT acknowledgement depends on the QoS level. The message is acknowledged when the broker indicated the successful reception of the message (or immediately if the level of QoS does not support acknowledgment). If a MQTT message cannot be sent to the broker, the message is nacked .","title":"Acknowledgement"},{"location":"mqtt/sending-messages-to-mqtt/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default auto-clean-session Set to start with a clean session ( true by default) boolean false true auto-generated-client-id Set if the MQTT client must generate clientId automatically boolean false true auto-keep-alive Set if the MQTT client must handle PINGREQ automatically boolean false true client-id Set the client identifier string false client-options-name (mqtt-client-options-name) The name of the MQTT Client Option bean ( io.smallrye.reactive.messaging.mqtt.session.MqttClientSessionOptions ) used to customize the MQTT client configuration string false connect-timeout-seconds Set the connect timeout (in seconds) int false 60 health-enabled Whether health reporting is enabled (default) or disabled boolean false true host Set the MQTT server host name/IP string true keep-alive-seconds Set the keep alive timeout in seconds int false 30 max-inflight-queue Set max count of unacknowledged messages int false 10 max-message-size Set max MQTT message size in bytes int false 8092 merge Whether the connector should allow multiple upstreams boolean false false password Set the password to connect to the server string false port Set the MQTT server port. Default to 8883 if ssl is enabled, or 1883 without ssl int false qos Set the QoS level when subscribing to the topic or when sending a message int false 0 reconnect-interval-seconds Set the reconnect interval in seconds int false 1 server-name Set the SNI server name string false ssl Set whether SSL/TLS is enabled boolean false false ssl.keystore.location Set the keystore location. In case of pem type this is the server ca cert path string false ssl.keystore.password Set the keystore password. In case of pem type this is the key path string false ssl.keystore.type Set the keystore type [ pkcs12 , jks , pem ] string false pkcs12 ssl.truststore.location Set the truststore location. In case of pem type this is the client cert path string false ssl.truststore.password Set the truststore password. In case of pem type this is not necessary string false ssl.truststore.type Set the truststore type [ pkcs12 , jks , pem ] string false pkcs12 topic Set the MQTT topic. If not set, the channel name is used string false trust-all Set whether all server certificates should be trusted boolean false false unsubscribe-on-disconnection This flag restore the old behavior to unsubscribe from the broken on disconnection boolean false false username Set the username to connect to the server string false will-flag Set if will information are provided on connection boolean false false will-qos Set the QoS level for the will message int false 0 will-retain Set if the will message must be retained boolean false false The MQTT connector is based on the Vert.x MQTT client . So you can pass any attribute supported by this client. Important A single instance of MqttClient and a single connection is used for each host / port / server-name / client-id . This client is reused for both the inbound and outbound connectors.","title":"Configuration Reference"},{"location":"rabbitmq/rabbitmq-client-customization/","text":"Customizing the underlying RabbitMQ client You can customize the underlying RabbitMQ Client configuration by producing an instance of RabbitMQOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Produces @Identifier ( \"my-named-options\" ) public RabbitMQOptions getNamedOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return ( RabbitMQOptions ) new RabbitMQOptions () . setUser ( \"admin\" ) . setPassword ( \"test\" ) . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name=my-named-options","title":"Client Customization"},{"location":"rabbitmq/rabbitmq-client-customization/#customizing-the-underlying-rabbitmq-client","text":"You can customize the underlying RabbitMQ Client configuration by producing an instance of RabbitMQOptions : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 @Produces @Identifier ( \"my-named-options\" ) public RabbitMQOptions getNamedOptions () { // You can use the produced options to configure the TLS connection PemKeyCertOptions keycert = new PemKeyCertOptions () . addCertPath ( \"./tls/tls.crt\" ) . addKeyPath ( \"./tls/tls.key\" ); PemTrustOptions trust = new PemTrustOptions (). addCertPath ( \"./tlc/ca.crt\" ); return ( RabbitMQOptions ) new RabbitMQOptions () . setUser ( \"admin\" ) . setPassword ( \"test\" ) . setSsl ( true ) . setPemKeyCertOptions ( keycert ) . setPemTrustOptions ( trust ) . setHostnameVerificationAlgorithm ( \"\" ) . setConnectTimeout ( 30000 ) . setReconnectInterval ( 5000 ); } This instance is retrieved and used to configure the client used by the connector. You need to indicate the name of the client using the client-options-name attribute: 1 mp.messaging.incoming.prices.client-options-name=my-named-options","title":"Customizing the underlying RabbitMQ client"},{"location":"rabbitmq/rabbitmq-cloud/","text":"Connecting to managed instances This section describes the connector configuration to use managed RabbitMQ instances (hosted on the Cloud). Cloud AMQP To connect to an instance of RabbitMQ hosted on Cloud AMQP , use the following configuration: 1 2 3 4 5 6 rabbitmq-host = host-name rabbitmq-port = 5671 rabbitmq-username = user-name rabbitmq-password = password rabbitmq-virtual-host = user-name rabbitmq-ssl = true You can extract the values from the AMQPS url displayed on the administration portal: 1 amqps://user-name:password@host/user-name Amazon MQ Amazon MQ can host RabbitMQ brokers (as well as AMQP 1.0 brokers). To connect to a RabbitMQ instance hosted on Amazon MQ, use the following configuration: 1 2 3 4 5 rabbitmq-host = host-name rabbitmq-port = 5671 rabbitmq-username = user-name rabbitmq-password = password rabbitmq-ssl = true You can extract the host value from the AMQPS url displayed on the administration console: 1 amqps://foobarbaz.mq.us-east-2.amazonaws.com:5671 The username and password are configured during the broker creation.","title":"Connecting to managed instances"},{"location":"rabbitmq/rabbitmq-cloud/#connecting-to-managed-instances","text":"This section describes the connector configuration to use managed RabbitMQ instances (hosted on the Cloud).","title":"Connecting to managed instances"},{"location":"rabbitmq/rabbitmq-cloud/#cloud-amqp","text":"To connect to an instance of RabbitMQ hosted on Cloud AMQP , use the following configuration: 1 2 3 4 5 6 rabbitmq-host = host-name rabbitmq-port = 5671 rabbitmq-username = user-name rabbitmq-password = password rabbitmq-virtual-host = user-name rabbitmq-ssl = true You can extract the values from the AMQPS url displayed on the administration portal: 1 amqps://user-name:password@host/user-name","title":"Cloud AMQP"},{"location":"rabbitmq/rabbitmq-cloud/#amazon-mq","text":"Amazon MQ can host RabbitMQ brokers (as well as AMQP 1.0 brokers). To connect to a RabbitMQ instance hosted on Amazon MQ, use the following configuration: 1 2 3 4 5 rabbitmq-host = host-name rabbitmq-port = 5671 rabbitmq-username = user-name rabbitmq-password = password rabbitmq-ssl = true You can extract the host value from the AMQPS url displayed on the administration console: 1 amqps://foobarbaz.mq.us-east-2.amazonaws.com:5671 The username and password are configured during the broker creation.","title":"Amazon MQ"},{"location":"rabbitmq/rabbitmq-health/","text":"Health reporting The RabbitMQ connector reports the readiness and liveness of each channel managed by the connector. On the inbound side (receiving messages from RabbitMQ), the check verifies that the receiver is connected to the broker. On the outbound side (sending records to RabbitMQ), the check verifies that the sender is not disconnected from the broker; the sender may still be in an initialized state (connection not yet attempted), but this is regarded as live/ready.","title":"Health Checks"},{"location":"rabbitmq/rabbitmq-health/#health-reporting","text":"The RabbitMQ connector reports the readiness and liveness of each channel managed by the connector. On the inbound side (receiving messages from RabbitMQ), the check verifies that the receiver is connected to the broker. On the outbound side (sending records to RabbitMQ), the check verifies that the sender is not disconnected from the broker; the sender may still be in an initialized state (connection not yet attempted), but this is regarded as live/ready.","title":"Health reporting"},{"location":"rabbitmq/rabbitmq/","text":"RabbitMQ Connector The RabbitMQ Connector adds support for RabbitMQ to Reactive Messaging, based on the AMQP 0-9-1 Protocol Specification. Advanced Message Queuing Protocol 0-9-1 ( AMQP 0-9-1 ) is an open standard for passing business messages between applications or organizations. With this connector, your application can: receive messages from a RabbitMQ queue send messages to a RabbitMQ exchange The RabbitMQ connector is based on the Vert.x RabbitMQ Client . Important The AMQP connector supports the AMQP 1.0 protocol, which is very different from AMQP 0-9-1. You can use the AMQP connector with RabbitMQ provided that the latter has the AMQP 1.0 Plugin installed, albeit with reduced functionality. Using the RabbitMQ connector To use the RabbitMQ Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-rabbitmq 3.25.0 The connector name is: smallrye-rabbitmq . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-rabbitmq # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-rabbitmq","title":"RabbitMQ Connector"},{"location":"rabbitmq/rabbitmq/#rabbitmq-connector","text":"The RabbitMQ Connector adds support for RabbitMQ to Reactive Messaging, based on the AMQP 0-9-1 Protocol Specification. Advanced Message Queuing Protocol 0-9-1 ( AMQP 0-9-1 ) is an open standard for passing business messages between applications or organizations. With this connector, your application can: receive messages from a RabbitMQ queue send messages to a RabbitMQ exchange The RabbitMQ connector is based on the Vert.x RabbitMQ Client . Important The AMQP connector supports the AMQP 1.0 protocol, which is very different from AMQP 0-9-1. You can use the AMQP connector with RabbitMQ provided that the latter has the AMQP 1.0 Plugin installed, albeit with reduced functionality.","title":"RabbitMQ Connector"},{"location":"rabbitmq/rabbitmq/#using-the-rabbitmq-connector","text":"To use the RabbitMQ Connector, add the following dependency to your project: 1 2 3 4 5 io.smallrye.reactive smallrye-reactive-messaging-rabbitmq 3.25.0 The connector name is: smallrye-rabbitmq . So, to indicate that a channel is managed by this connector you need: 1 2 3 4 5 # Inbound mp.messaging.incoming.[channel-name].connector = smallrye-rabbitmq # Outbound mp.messaging.outgoing.[channel-name].connector = smallrye-rabbitmq","title":"Using the RabbitMQ connector"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/","text":"Receiving messages from RabbitMQ The RabbitMQ connector lets you retrieve messages from a RabbitMQ broker . The RabbitMQ connector retrieves RabbitMQ Messages and maps each of them into Reactive Messaging Messages . Note In this context, the reactive messaging concept of a Channel is realised as a RabbitMQ Queue . Example Let\u2019s imagine you have a RabbitMQ broker running, and accessible using the rabbitmq:5672 address (by default it would use localhost:5672 ). Configure your application to receive RabbitMQ Messages on the prices channel as follows: 1 2 3 4 5 6 7 8 rabbitmq-host = rabbitmq # <1> rabbitmq-port = 5672 # <2> rabbitmq-username = my-username # <3> rabbitmq-password = my-password # <4> mp.messaging.incoming.prices.connector = smallrye-rabbitmq # <5> mp.messaging.incoming.prices.queue.name = my-queue # <6> mp.messaging.incoming.prices.routing-keys = urgent # <7> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using rabbitmq-host . Configures the broker/router port. You can do it per channel (using the port attribute) or globally using rabbitmq-port . The default is 5672. Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using rabbitmq-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using rabbitmq-password . Instructs the prices channel to be managed by the RabbitMQ connector. Configures the RabbitMQ queue to read messages from. Configures the binding between the RabbitMQ exchange and the RabbitMQ queue using a routing key. The default is # (all messages will be forwarded from the exchange to the queue) but in general this can be a comma-separated list of one or more keys. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package rabbitmq.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class RabbitMQPriceConsumer { @Incoming ( \"prices\" ) public void consume ( String price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package rabbitmq.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class RabbitMQPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < String > price ) { // process your price. // Acknowledge the incoming message, marking the RabbitMQ message as `accepted`. return price . ack (); } } Note Whether you need to explicitly acknowledge the message depends on the auto-acknowledgement channel setting; if that is set to true then your message will be automatically acknowledged on receipt. Deserialization The connector converts incoming RabbitMQ Messages into Reactive Messaging Message instances. The payload type T depends on the value of the RabbitMQ received message Envelope content_type and content_encoding properties. content_encoding content_type Type Value present n/a byte[] No value text/plain String No value application/json a JSON element which can be a JsonArray , JsonObject , String , ... if the buffer contains an array, object, string,... No value Anything else byte[] If you send objects with this RabbitMQ connector (outbound connector), they are encoded as JSON and sent with content_type set to application/json . You can receive this payload using (Vert.x) JSON Objects, and then map it to the object class you want: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 @ApplicationScoped public static class Generator { @Outgoing ( \"to-rabbitmq\" ) public Multi < Price > prices () { // <1> AtomicInteger count = new AtomicInteger (); return Multi . createFrom (). ticks (). every ( Duration . ofMillis ( 1000 )) . map ( l -> new Price (). setPrice ( count . incrementAndGet ())) . onOverflow (). drop (); } } @ApplicationScoped public static class Consumer { List < Price > prices = new CopyOnWriteArrayList <> (); @Incoming ( \"from-rabbitmq\" ) public void consume ( JsonObject p ) { // <2> Price price = p . mapTo ( Price . class ); // <3> prices . add ( price ); } public List < Price > list () { return prices ; } } The Price instances are automatically encoded to JSON by the connector You can receive it using a JsonObject Then, you can reconstruct the instance using the mapTo method Inbound Metadata Messages coming from RabbitMQ contain an instance of IncomingRabbitMQMetadata in the metadata. RabbitMQ message headers can be accessed from the metadata either by calling getHeader(String header, Class type) to retrieve a single header value. or getHeaders() to get a map of all header values. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 final Optional < IncomingRabbitMQMetadata > metadata = incomingMessage . getMetadata ( IncomingRabbitMQMetadata . class ); metadata . ifPresent ( meta -> { final Optional < String > contentEncoding = meta . getContentEncoding (); final Optional < String > contentType = meta . getContentType (); final Optional < String > correlationId = meta . getCorrelationId (); final Optional < ZonedDateTime > timestamp = meta . getTimestamp ( ZoneId . systemDefault ()); final Optional < Integer > priority = meta . getPriority (); final Optional < String > replyTo = meta . getReplyTo (); final Optional < String > userId = meta . getUserId (); // Access a single String-valued header final Optional < String > stringHeader = meta . getHeader ( \"my-header\" , String . class ); // Access all headers final Map < String , Object > headers = meta . getHeaders (); // ... }); The type of the header value depends on the RabbitMQ type used for the header: RabbitMQ Header Type T String String Boolean Boolean Number Number List java.util.List Acknowledgement When a Reactive Messaging Message associated with a RabbitMQ Message is acknowledged, it informs the broker that the message has been accepted . Whether you need to explicitly acknowledge the message depends on the auto-acknowledgement setting for the channel; if that is set to true then your message will be automatically acknowledged on receipt. Failure Management If a message produced from a RabbitMQ message is nacked , a failure strategy is applied. The RabbitMQ connector supports three strategies, controlled by the failure-strategy channel setting: fail - fail the application; no more RabbitMQ messages will be processed. The RabbitMQ message is marked as rejected. accept - this strategy marks the RabbitMQ message as accepted. The processing continues ignoring the failure. reject - this strategy marks the RabbitMQ message as rejected (default). The processing continues with the next message. Configuration Reference Attribute ( alias ) Description Type Mandatory Default auto-acknowledgement Whether the received RabbitMQ messages must be acknowledged when received; if true then delivery constitutes acknowledgement boolean false false auto-bind-dlq Whether to automatically declare the DLQ and bind it to the binder DLX boolean false false automatic-recovery-enabled Whether automatic connection recovery is enabled boolean false false automatic-recovery-on-initial-connection Whether automatic recovery on initial connections is enabled boolean false true broadcast Whether the received RabbitMQ messages must be dispatched to multiple subscribers boolean false false client-options-name (rabbitmq-client-options-name) The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configuration string false connection-count The number of RabbitMQ connections to create for consuming from this queue. This might be necessary to consume from a sharded queue with a single client. int false 1 connection-timeout The TCP connection timeout (ms); 0 is interpreted as no timeout int false 60000 content-type-override Override the content_type attribute of the incoming message, should be a valid MINE type string false credentials-provider-name (rabbitmq-credentials-provider-name) The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ client string false dead-letter-exchange A DLX to assign to the queue. Relevant only if auto-bind-dlq is true string false DLX dead-letter-exchange-type The type of the DLX to assign to the queue. Relevant only if auto-bind-dlq is true string false direct dead-letter-queue-mode If automatically declare DLQ, we can choose different modes of DLQ [lazy, default] string false dead-letter-queue-name The name of the DLQ; if not supplied will default to the queue name with '.dlq' appended string false dead-letter-queue-type If automatically declare DLQ, we can choose different types of DLQ [quorum, classic, stream] string false dead-letter-routing-key A dead letter routing key to assign to the queue; if not supplied will default to the queue name string false dlx.declare Whether to declare the dead letter exchange binding. Relevant only if auto-bind-dlq is true; set to false if these are expected to be set up independently boolean false false exchange.auto-delete Whether the exchange should be deleted after use boolean false false exchange.declare Whether to declare the exchange; set to false if the exchange is expected to be set up independently boolean false true exchange.durable Whether the exchange is durable boolean false true exchange.name The exchange that messages are published to or consumed from. If not set, the channel name is used. If set to \"\", the default exchange is used. string false exchange.type The exchange type: direct, fanout, headers or topic (default) string false topic failure-strategy The failure strategy to apply when a RabbitMQ message is nacked. Accepted values are fail , accept , reject (default) string false reject handshake-timeout The AMQP 0-9-1 protocol handshake timeout (ms) int false 10000 host (rabbitmq-host) The broker hostname string false localhost include-properties Whether to include properties when a broker message is passed on the event bus boolean false false keep-most-recent Whether to discard old messages instead of recent ones boolean false false max-incoming-internal-queue-size The maximum size of the incoming internal queue int false 500000 max-outstanding-messages The maximum number of outstanding/unacknowledged messages being processed by the connector at a time; must be a positive number int false network-recovery-interval How long (ms) will automatic recovery wait before attempting to reconnect int false 5000 password (rabbitmq-password) The password used to authenticate to the broker string false port (rabbitmq-port) The broker port int false 5672 queue.auto-delete Whether the queue should be deleted after use boolean false false queue.declare Whether to declare the queue and binding; set to false if these are expected to be set up independently boolean false true queue.durable Whether the queue is durable boolean false true queue.exclusive Whether the queue is for exclusive use boolean false false queue.name The queue from which messages are consumed. string true queue.single-active-consumer If set to true, only one consumer can actively consume messages boolean false queue.ttl If specified, the time (ms) for which a message can remain in the queue undelivered before it is dead long false queue.x-max-priority Define priority level queue consumer int false queue.x-queue-mode If automatically declare queue, we can choose different modes of queue [lazy, default] string false queue.x-queue-type If automatically declare queue, we can choose different types of queue [quorum, classic, stream] string false reconnect-attempts (rabbitmq-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (rabbitmq-reconnect-interval) The interval (in seconds) between two reconnection attempts int false 10 requested-channel-max The initially requested maximum channel number int false 2047 requested-heartbeat The initially requested heartbeat interval (seconds), zero for none int false 60 routing-keys A comma-separated list of routing keys to bind the queue to the exchange string false # ssl (rabbitmq-ssl) Whether or not the connection should use SSL boolean false false tracing.attribute-headers A comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=true string false `` tracing.enabled Whether tracing is enabled (default) or disabled boolean false true trust-all (rabbitmq-trust-all) Whether to skip trust certificate verification boolean false false trust-store-password (rabbitmq-trust-store-password) The password of the JKS trust store string false trust-store-path (rabbitmq-trust-store-path) The path to a JKS trust store string false use-nio Whether usage of NIO Sockets is enabled boolean false false user The user name to use when connecting to the broker string false guest username (rabbitmq-username) The username used to authenticate to the broker string false virtual-host (rabbitmq-virtual-host) The virtual host to use when connecting to the broker string false / To use an existing queue , you need to configure the queue.name attribute. For example, if you have a RabbitMQ broker already configured with a queue called peopleQueue that you wish to read messages from, you need the following configuration: 1 2 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.queue.name = peopleQueue If you want RabbitMQ to create the queue for you but bind it to an existing topic exchange people , you need the following configuration: 1 2 3 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.queue.name = peopleQueue mp.messaging.incoming.people.queue.declare = true Note In the above the channel name people is implicitly assumed to be the name of the exchange; if this is not the case you would need to name the exchange explicitly using the exchange.name property. Note The connector supports RabbitMQ's \"Server-named Queues\" feature to create an exclusive, auto-deleting, non-durable and randomly named queue. To enable this feature you set the queue name to exactly (server.auto) . Using this name not only enables the server named queue feature but also automatically makes ths queue exclusive, auto-deleting, and non-durable; therefore ignoring any values provided for the exclusive , auto-delete and durable options. If you want RabbitMQ to create the people exchange, queue and binding, you need the following configuration: 1 2 3 4 5 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.exchange.declare = true mp.messaging.incoming.people.queue.name = peopleQueue mp.messaging.incoming.people.queue.declare = true mp.messaging.incoming.people.queue.routing-keys = tall,short In the above we have used an explicit list of routing keys rather than the default ( # ). Each component of the list creates a separate binding between the queue and the exchange, so in the case above we would have two bindings; one based on a routing key of tall , the other based on one of short . Note The default value of routing-keys is # (indicating a match against all possible routing keys) which is only appropriate for topic Exchanges. If you are using other types of exchange and/or need to declare queue bindings, you\u2019ll need to supply a valid value for the exchange in question.","title":"Receiving messages"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#receiving-messages-from-rabbitmq","text":"The RabbitMQ connector lets you retrieve messages from a RabbitMQ broker . The RabbitMQ connector retrieves RabbitMQ Messages and maps each of them into Reactive Messaging Messages . Note In this context, the reactive messaging concept of a Channel is realised as a RabbitMQ Queue .","title":"Receiving messages from RabbitMQ"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#example","text":"Let\u2019s imagine you have a RabbitMQ broker running, and accessible using the rabbitmq:5672 address (by default it would use localhost:5672 ). Configure your application to receive RabbitMQ Messages on the prices channel as follows: 1 2 3 4 5 6 7 8 rabbitmq-host = rabbitmq # <1> rabbitmq-port = 5672 # <2> rabbitmq-username = my-username # <3> rabbitmq-password = my-password # <4> mp.messaging.incoming.prices.connector = smallrye-rabbitmq # <5> mp.messaging.incoming.prices.queue.name = my-queue # <6> mp.messaging.incoming.prices.routing-keys = urgent # <7> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using rabbitmq-host . Configures the broker/router port. You can do it per channel (using the port attribute) or globally using rabbitmq-port . The default is 5672. Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using rabbitmq-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using rabbitmq-password . Instructs the prices channel to be managed by the RabbitMQ connector. Configures the RabbitMQ queue to read messages from. Configures the binding between the RabbitMQ exchange and the RabbitMQ queue using a routing key. The default is # (all messages will be forwarded from the exchange to the queue) but in general this can be a comma-separated list of one or more keys. Then, your application receives Message . You can consume the payload directly: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package rabbitmq.inbound ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; @ApplicationScoped public class RabbitMQPriceConsumer { @Incoming ( \"prices\" ) public void consume ( String price ) { // process your price. } } Or, you can retrieve the Message : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 package rabbitmq.inbound ; import java.util.concurrent.CompletionStage ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Incoming ; import org.eclipse.microprofile.reactive.messaging.Message ; @ApplicationScoped public class RabbitMQPriceMessageConsumer { @Incoming ( \"prices\" ) public CompletionStage < Void > consume ( Message < String > price ) { // process your price. // Acknowledge the incoming message, marking the RabbitMQ message as `accepted`. return price . ack (); } } Note Whether you need to explicitly acknowledge the message depends on the auto-acknowledgement channel setting; if that is set to true then your message will be automatically acknowledged on receipt.","title":"Example"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#deserialization","text":"The connector converts incoming RabbitMQ Messages into Reactive Messaging Message instances. The payload type T depends on the value of the RabbitMQ received message Envelope content_type and content_encoding properties. content_encoding content_type Type Value present n/a byte[] No value text/plain String No value application/json a JSON element which can be a JsonArray , JsonObject , String , ... if the buffer contains an array, object, string,... No value Anything else byte[] If you send objects with this RabbitMQ connector (outbound connector), they are encoded as JSON and sent with content_type set to application/json . You can receive this payload using (Vert.x) JSON Objects, and then map it to the object class you want: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 @ApplicationScoped public static class Generator { @Outgoing ( \"to-rabbitmq\" ) public Multi < Price > prices () { // <1> AtomicInteger count = new AtomicInteger (); return Multi . createFrom (). ticks (). every ( Duration . ofMillis ( 1000 )) . map ( l -> new Price (). setPrice ( count . incrementAndGet ())) . onOverflow (). drop (); } } @ApplicationScoped public static class Consumer { List < Price > prices = new CopyOnWriteArrayList <> (); @Incoming ( \"from-rabbitmq\" ) public void consume ( JsonObject p ) { // <2> Price price = p . mapTo ( Price . class ); // <3> prices . add ( price ); } public List < Price > list () { return prices ; } } The Price instances are automatically encoded to JSON by the connector You can receive it using a JsonObject Then, you can reconstruct the instance using the mapTo method","title":"Deserialization"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#inbound-metadata","text":"Messages coming from RabbitMQ contain an instance of IncomingRabbitMQMetadata in the metadata. RabbitMQ message headers can be accessed from the metadata either by calling getHeader(String header, Class type) to retrieve a single header value. or getHeaders() to get a map of all header values. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 final Optional < IncomingRabbitMQMetadata > metadata = incomingMessage . getMetadata ( IncomingRabbitMQMetadata . class ); metadata . ifPresent ( meta -> { final Optional < String > contentEncoding = meta . getContentEncoding (); final Optional < String > contentType = meta . getContentType (); final Optional < String > correlationId = meta . getCorrelationId (); final Optional < ZonedDateTime > timestamp = meta . getTimestamp ( ZoneId . systemDefault ()); final Optional < Integer > priority = meta . getPriority (); final Optional < String > replyTo = meta . getReplyTo (); final Optional < String > userId = meta . getUserId (); // Access a single String-valued header final Optional < String > stringHeader = meta . getHeader ( \"my-header\" , String . class ); // Access all headers final Map < String , Object > headers = meta . getHeaders (); // ... }); The type of the header value depends on the RabbitMQ type used for the header: RabbitMQ Header Type T String String Boolean Boolean Number Number List java.util.List","title":"Inbound Metadata"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#acknowledgement","text":"When a Reactive Messaging Message associated with a RabbitMQ Message is acknowledged, it informs the broker that the message has been accepted . Whether you need to explicitly acknowledge the message depends on the auto-acknowledgement setting for the channel; if that is set to true then your message will be automatically acknowledged on receipt.","title":"Acknowledgement"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#failure-management","text":"If a message produced from a RabbitMQ message is nacked , a failure strategy is applied. The RabbitMQ connector supports three strategies, controlled by the failure-strategy channel setting: fail - fail the application; no more RabbitMQ messages will be processed. The RabbitMQ message is marked as rejected. accept - this strategy marks the RabbitMQ message as accepted. The processing continues ignoring the failure. reject - this strategy marks the RabbitMQ message as rejected (default). The processing continues with the next message.","title":"Failure Management"},{"location":"rabbitmq/receiving-messages-from-rabbitmq/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default auto-acknowledgement Whether the received RabbitMQ messages must be acknowledged when received; if true then delivery constitutes acknowledgement boolean false false auto-bind-dlq Whether to automatically declare the DLQ and bind it to the binder DLX boolean false false automatic-recovery-enabled Whether automatic connection recovery is enabled boolean false false automatic-recovery-on-initial-connection Whether automatic recovery on initial connections is enabled boolean false true broadcast Whether the received RabbitMQ messages must be dispatched to multiple subscribers boolean false false client-options-name (rabbitmq-client-options-name) The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configuration string false connection-count The number of RabbitMQ connections to create for consuming from this queue. This might be necessary to consume from a sharded queue with a single client. int false 1 connection-timeout The TCP connection timeout (ms); 0 is interpreted as no timeout int false 60000 content-type-override Override the content_type attribute of the incoming message, should be a valid MINE type string false credentials-provider-name (rabbitmq-credentials-provider-name) The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ client string false dead-letter-exchange A DLX to assign to the queue. Relevant only if auto-bind-dlq is true string false DLX dead-letter-exchange-type The type of the DLX to assign to the queue. Relevant only if auto-bind-dlq is true string false direct dead-letter-queue-mode If automatically declare DLQ, we can choose different modes of DLQ [lazy, default] string false dead-letter-queue-name The name of the DLQ; if not supplied will default to the queue name with '.dlq' appended string false dead-letter-queue-type If automatically declare DLQ, we can choose different types of DLQ [quorum, classic, stream] string false dead-letter-routing-key A dead letter routing key to assign to the queue; if not supplied will default to the queue name string false dlx.declare Whether to declare the dead letter exchange binding. Relevant only if auto-bind-dlq is true; set to false if these are expected to be set up independently boolean false false exchange.auto-delete Whether the exchange should be deleted after use boolean false false exchange.declare Whether to declare the exchange; set to false if the exchange is expected to be set up independently boolean false true exchange.durable Whether the exchange is durable boolean false true exchange.name The exchange that messages are published to or consumed from. If not set, the channel name is used. If set to \"\", the default exchange is used. string false exchange.type The exchange type: direct, fanout, headers or topic (default) string false topic failure-strategy The failure strategy to apply when a RabbitMQ message is nacked. Accepted values are fail , accept , reject (default) string false reject handshake-timeout The AMQP 0-9-1 protocol handshake timeout (ms) int false 10000 host (rabbitmq-host) The broker hostname string false localhost include-properties Whether to include properties when a broker message is passed on the event bus boolean false false keep-most-recent Whether to discard old messages instead of recent ones boolean false false max-incoming-internal-queue-size The maximum size of the incoming internal queue int false 500000 max-outstanding-messages The maximum number of outstanding/unacknowledged messages being processed by the connector at a time; must be a positive number int false network-recovery-interval How long (ms) will automatic recovery wait before attempting to reconnect int false 5000 password (rabbitmq-password) The password used to authenticate to the broker string false port (rabbitmq-port) The broker port int false 5672 queue.auto-delete Whether the queue should be deleted after use boolean false false queue.declare Whether to declare the queue and binding; set to false if these are expected to be set up independently boolean false true queue.durable Whether the queue is durable boolean false true queue.exclusive Whether the queue is for exclusive use boolean false false queue.name The queue from which messages are consumed. string true queue.single-active-consumer If set to true, only one consumer can actively consume messages boolean false queue.ttl If specified, the time (ms) for which a message can remain in the queue undelivered before it is dead long false queue.x-max-priority Define priority level queue consumer int false queue.x-queue-mode If automatically declare queue, we can choose different modes of queue [lazy, default] string false queue.x-queue-type If automatically declare queue, we can choose different types of queue [quorum, classic, stream] string false reconnect-attempts (rabbitmq-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (rabbitmq-reconnect-interval) The interval (in seconds) between two reconnection attempts int false 10 requested-channel-max The initially requested maximum channel number int false 2047 requested-heartbeat The initially requested heartbeat interval (seconds), zero for none int false 60 routing-keys A comma-separated list of routing keys to bind the queue to the exchange string false # ssl (rabbitmq-ssl) Whether or not the connection should use SSL boolean false false tracing.attribute-headers A comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=true string false `` tracing.enabled Whether tracing is enabled (default) or disabled boolean false true trust-all (rabbitmq-trust-all) Whether to skip trust certificate verification boolean false false trust-store-password (rabbitmq-trust-store-password) The password of the JKS trust store string false trust-store-path (rabbitmq-trust-store-path) The path to a JKS trust store string false use-nio Whether usage of NIO Sockets is enabled boolean false false user The user name to use when connecting to the broker string false guest username (rabbitmq-username) The username used to authenticate to the broker string false virtual-host (rabbitmq-virtual-host) The virtual host to use when connecting to the broker string false / To use an existing queue , you need to configure the queue.name attribute. For example, if you have a RabbitMQ broker already configured with a queue called peopleQueue that you wish to read messages from, you need the following configuration: 1 2 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.queue.name = peopleQueue If you want RabbitMQ to create the queue for you but bind it to an existing topic exchange people , you need the following configuration: 1 2 3 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.queue.name = peopleQueue mp.messaging.incoming.people.queue.declare = true Note In the above the channel name people is implicitly assumed to be the name of the exchange; if this is not the case you would need to name the exchange explicitly using the exchange.name property. Note The connector supports RabbitMQ's \"Server-named Queues\" feature to create an exclusive, auto-deleting, non-durable and randomly named queue. To enable this feature you set the queue name to exactly (server.auto) . Using this name not only enables the server named queue feature but also automatically makes ths queue exclusive, auto-deleting, and non-durable; therefore ignoring any values provided for the exclusive , auto-delete and durable options. If you want RabbitMQ to create the people exchange, queue and binding, you need the following configuration: 1 2 3 4 5 mp.messaging.incoming.people.connector = smallrye-rabbitmq mp.messaging.incoming.people.exchange.declare = true mp.messaging.incoming.people.queue.name = peopleQueue mp.messaging.incoming.people.queue.declare = true mp.messaging.incoming.people.queue.routing-keys = tall,short In the above we have used an explicit list of routing keys rather than the default ( # ). Each component of the list creates a separate binding between the queue and the exchange, so in the case above we would have two bindings; one based on a routing key of tall , the other based on one of short . Note The default value of routing-keys is # (indicating a match against all possible routing keys) which is only appropriate for topic Exchanges. If you are using other types of exchange and/or need to declare queue bindings, you\u2019ll need to supply a valid value for the exchange in question.","title":"Configuration Reference"},{"location":"rabbitmq/sending-messages-to-rabbitmq/","text":"Sending messages to RabbitMQ The RabbitMQ connector can write Reactive Messaging Messages as RabbitMQ Messages. Note In this context, the reactive messaging concept of a Channel is realised as a RabbitMQ Exchange . Example Let\u2019s imagine you have a RabbitMQ broker running, and accessible using the rabbitmq:5672 address (by default it would use localhost:5672 ). Configure your application to send the messages from the prices channel as a RabbitMQ Message as follows: 1 2 3 4 5 6 7 rabbitmq-host=rabbitmq # <1> rabbitmq-port=5672 # <2> rabbitmq-username=my-username # <3> rabbitmq-password=my-password # <4> mp.messaging.outgoing.prices.connector=smallrye-rabbitmq # <5> mp.messaging.outgoing.prices.default-routing-key=normal # <6> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using rabbitmq-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using rabbitmq-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using rabbitmq-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using rabbitmq-password . Instructs the prices channel to be managed by the RabbitMQ connector Supplies the default routing key to be included in outbound messages; this will be if the \"raw payload\" form of message sending is used (see below). Note You don\u2019t need to set the RabbitMQ exchange name. By default, it uses the channel name ( prices ) as the name of the exchange to send messages to. You can configure the exchange.name attribute to override it. Then, your application can send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package rabbitmq.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class RabbitMQPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message , which affords the opportunity to explicitly specify metadata on the outgoing message: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 package rabbitmq.outbound ; import java.time.Duration ; import java.time.ZonedDateTime ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Metadata ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; import io.smallrye.reactive.messaging.rabbitmq.OutgoingRabbitMQMetadata ; @ApplicationScoped public class RabbitMQPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble (), Metadata . of ( new OutgoingRabbitMQMetadata . Builder () . withRoutingKey ( \"normal\" ) . withTimestamp ( ZonedDateTime . now ()) . build ()))); } } Serialization When sending a Message , the connector converts the message into a RabbitMQ Message. The payload is converted to the RabbitMQ Message body. T RabbitMQ Message Body primitive types or UUID / String String value with content_type set to text/plain JsonObject or JsonArray Serialized String payload with content_type set to application/json io.vertx.mutiny.core.buffer.Buffer Binary content, with content_type set to application/octet-stream byte[] Binary content, with content_type set to application/octet-stream Any other class The payload is converted to JSON (using a Json Mapper) then serialized with content_type set to application/json If the message payload cannot be serialized to JSON, the message is nacked . Outbound Metadata When sending Messages , you can add an instance of OutgoingRabbitMQMetadata to influence how the message is handled by RabbitMQ. For example, you can configure the routing key, timestamp and headers: 1 2 3 4 5 6 7 8 final OutgoingRabbitMQMetadata metadata = new OutgoingRabbitMQMetadata . Builder () . withHeader ( \"my-header\" , \"xyzzy\" ) . withRoutingKey ( \"urgent\" ) . withTimestamp ( ZonedDateTime . now ()) . build (); // Add `metadata` to the metadata of the outgoing message. return Message . of ( \"Hello\" , Metadata . of ( metadata )); Acknowledgement By default, the Reactive Messaging Message is acknowledged when the broker acknowledges the message. Configuration Reference Attribute ( alias ) Description Type Mandatory Default automatic-recovery-enabled Whether automatic connection recovery is enabled boolean false false automatic-recovery-on-initial-connection Whether automatic recovery on initial connections is enabled boolean false true client-options-name (rabbitmq-client-options-name) The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configuration string false connection-timeout The TCP connection timeout (ms); 0 is interpreted as no timeout int false 60000 credentials-provider-name (rabbitmq-credentials-provider-name) The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ client string false default-routing-key The default routing key to use when sending messages to the exchange string false `` default-ttl If specified, the time (ms) sent messages can remain in queues undelivered before they are dead long false exchange.auto-delete Whether the exchange should be deleted after use boolean false false exchange.declare Whether to declare the exchange; set to false if the exchange is expected to be set up independently boolean false true exchange.durable Whether the exchange is durable boolean false true exchange.name The exchange that messages are published to or consumed from. If not set, the channel name is used. If set to \"\", the default exchange is used. string false exchange.type The exchange type: direct, fanout, headers or topic (default) string false topic handshake-timeout The AMQP 0-9-1 protocol handshake timeout (ms) int false 10000 host (rabbitmq-host) The broker hostname string false localhost include-properties Whether to include properties when a broker message is passed on the event bus boolean false false max-inflight-messages The maximum number of messages to be written to RabbitMQ concurrently; must be a positive number long false 1024 max-outgoing-internal-queue-size The maximum size of the outgoing internal queue int false network-recovery-interval How long (ms) will automatic recovery wait before attempting to reconnect int false 5000 password (rabbitmq-password) The password used to authenticate to the broker string false port (rabbitmq-port) The broker port int false 5672 reconnect-attempts (rabbitmq-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (rabbitmq-reconnect-interval) The interval (in seconds) between two reconnection attempts int false 10 requested-channel-max The initially requested maximum channel number int false 2047 requested-heartbeat The initially requested heartbeat interval (seconds), zero for none int false 60 ssl (rabbitmq-ssl) Whether or not the connection should use SSL boolean false false tracing.attribute-headers A comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=true string false `` tracing.enabled Whether tracing is enabled (default) or disabled boolean false true trust-all (rabbitmq-trust-all) Whether to skip trust certificate verification boolean false false trust-store-password (rabbitmq-trust-store-password) The password of the JKS trust store string false trust-store-path (rabbitmq-trust-store-path) The path to a JKS trust store string false use-nio Whether usage of NIO Sockets is enabled boolean false false user The user name to use when connecting to the broker string false guest username (rabbitmq-username) The username used to authenticate to the broker string false virtual-host (rabbitmq-virtual-host) The virtual host to use when connecting to the broker string false / Using existing destinations To use an existing exchange , you may need to configure the exchange.name attribute. For example, if you have a RabbitMQ broker already configured with an exchange called people that you wish to send messages to, you need the following configuration: 1 mp.messaging.outgoing.people.connector = smallrye-rabbitmq You would need to configure the exchange.name attribute, if the exchange name were not the channel name: 1 2 mp.messaging.outgoing.people-out.connector = smallrye-rabbitmq mp.messaging.outgoing.people-out.exchange.name = people If you want RabbitMQ to create the people exchange, you need the following configuration: 1 2 3 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.exchange.name = people mp.messaging.outgoing.people-out.exchange.declare = true Note The above example will create a topic exchange and use an empty default routing-key (unless overridden programatically using outgoing metadata for the message). If you want to create a different type of exchange or have a different default routing key, then the exchange.type and default-routing-key properties need to be explicitly specified. Sending to specific queues via the default exchange To send a message to a specific queue (usually a reply queue), you have to configure the default exchange as an outgoing channel and set the name of the queue as routing key in the message metadata. The name of the exchange needs to be set to \"\" . 1 2 mp.messaging.outgoing.channel-name-for-default-exchange.connector = smallrye-rabbitmq mp.messaging.outgoing.channel-name-for-default-exchange.exchange.name = \"\"","title":"Sending messages"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#sending-messages-to-rabbitmq","text":"The RabbitMQ connector can write Reactive Messaging Messages as RabbitMQ Messages. Note In this context, the reactive messaging concept of a Channel is realised as a RabbitMQ Exchange .","title":"Sending messages to RabbitMQ"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#example","text":"Let\u2019s imagine you have a RabbitMQ broker running, and accessible using the rabbitmq:5672 address (by default it would use localhost:5672 ). Configure your application to send the messages from the prices channel as a RabbitMQ Message as follows: 1 2 3 4 5 6 7 rabbitmq-host=rabbitmq # <1> rabbitmq-port=5672 # <2> rabbitmq-username=my-username # <3> rabbitmq-password=my-password # <4> mp.messaging.outgoing.prices.connector=smallrye-rabbitmq # <5> mp.messaging.outgoing.prices.default-routing-key=normal # <6> Configures the broker/router host name. You can do it per channel (using the host attribute) or globally using rabbitmq-host Configures the broker/router port. You can do it per channel (using the port attribute) or globally using rabbitmq-port . The default is 5672 . Configures the broker/router username if required. You can do it per channel (using the username attribute) or globally using rabbitmq-username . Configures the broker/router password if required. You can do it per channel (using the password attribute) or globally using rabbitmq-password . Instructs the prices channel to be managed by the RabbitMQ connector Supplies the default routing key to be included in outbound messages; this will be if the \"raw payload\" form of message sending is used (see below). Note You don\u2019t need to set the RabbitMQ exchange name. By default, it uses the channel name ( prices ) as the name of the exchange to send messages to. You can configure the exchange.name attribute to override it. Then, your application can send Message to the prices channel. It can use double payloads as in the following snippet: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 package rabbitmq.outbound ; import java.time.Duration ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; @ApplicationScoped public class RabbitMQPriceProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Double > generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> random . nextDouble ()); } } Or, you can send Message , which affords the opportunity to explicitly specify metadata on the outgoing message: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 package rabbitmq.outbound ; import java.time.Duration ; import java.time.ZonedDateTime ; import java.util.Random ; import javax.enterprise.context.ApplicationScoped ; import org.eclipse.microprofile.reactive.messaging.Message ; import org.eclipse.microprofile.reactive.messaging.Metadata ; import org.eclipse.microprofile.reactive.messaging.Outgoing ; import io.smallrye.mutiny.Multi ; import io.smallrye.reactive.messaging.rabbitmq.OutgoingRabbitMQMetadata ; @ApplicationScoped public class RabbitMQPriceMessageProducer { private Random random = new Random (); @Outgoing ( \"prices\" ) public Multi < Message < Double >> generate () { // Build an infinite stream of random prices // It emits a price every second return Multi . createFrom (). ticks (). every ( Duration . ofSeconds ( 1 )) . map ( x -> Message . of ( random . nextDouble (), Metadata . of ( new OutgoingRabbitMQMetadata . Builder () . withRoutingKey ( \"normal\" ) . withTimestamp ( ZonedDateTime . now ()) . build ()))); } }","title":"Example"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#serialization","text":"When sending a Message , the connector converts the message into a RabbitMQ Message. The payload is converted to the RabbitMQ Message body. T RabbitMQ Message Body primitive types or UUID / String String value with content_type set to text/plain JsonObject or JsonArray Serialized String payload with content_type set to application/json io.vertx.mutiny.core.buffer.Buffer Binary content, with content_type set to application/octet-stream byte[] Binary content, with content_type set to application/octet-stream Any other class The payload is converted to JSON (using a Json Mapper) then serialized with content_type set to application/json If the message payload cannot be serialized to JSON, the message is nacked .","title":"Serialization"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#outbound-metadata","text":"When sending Messages , you can add an instance of OutgoingRabbitMQMetadata to influence how the message is handled by RabbitMQ. For example, you can configure the routing key, timestamp and headers: 1 2 3 4 5 6 7 8 final OutgoingRabbitMQMetadata metadata = new OutgoingRabbitMQMetadata . Builder () . withHeader ( \"my-header\" , \"xyzzy\" ) . withRoutingKey ( \"urgent\" ) . withTimestamp ( ZonedDateTime . now ()) . build (); // Add `metadata` to the metadata of the outgoing message. return Message . of ( \"Hello\" , Metadata . of ( metadata ));","title":"Outbound Metadata"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#acknowledgement","text":"By default, the Reactive Messaging Message is acknowledged when the broker acknowledges the message.","title":"Acknowledgement"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#configuration-reference","text":"Attribute ( alias ) Description Type Mandatory Default automatic-recovery-enabled Whether automatic connection recovery is enabled boolean false false automatic-recovery-on-initial-connection Whether automatic recovery on initial connections is enabled boolean false true client-options-name (rabbitmq-client-options-name) The name of the RabbitMQ Client Option bean used to customize the RabbitMQ client configuration string false connection-timeout The TCP connection timeout (ms); 0 is interpreted as no timeout int false 60000 credentials-provider-name (rabbitmq-credentials-provider-name) The name of the RabbitMQ Credentials Provider bean used to provide dynamic credentials to the RabbitMQ client string false default-routing-key The default routing key to use when sending messages to the exchange string false `` default-ttl If specified, the time (ms) sent messages can remain in queues undelivered before they are dead long false exchange.auto-delete Whether the exchange should be deleted after use boolean false false exchange.declare Whether to declare the exchange; set to false if the exchange is expected to be set up independently boolean false true exchange.durable Whether the exchange is durable boolean false true exchange.name The exchange that messages are published to or consumed from. If not set, the channel name is used. If set to \"\", the default exchange is used. string false exchange.type The exchange type: direct, fanout, headers or topic (default) string false topic handshake-timeout The AMQP 0-9-1 protocol handshake timeout (ms) int false 10000 host (rabbitmq-host) The broker hostname string false localhost include-properties Whether to include properties when a broker message is passed on the event bus boolean false false max-inflight-messages The maximum number of messages to be written to RabbitMQ concurrently; must be a positive number long false 1024 max-outgoing-internal-queue-size The maximum size of the outgoing internal queue int false network-recovery-interval How long (ms) will automatic recovery wait before attempting to reconnect int false 5000 password (rabbitmq-password) The password used to authenticate to the broker string false port (rabbitmq-port) The broker port int false 5672 reconnect-attempts (rabbitmq-reconnect-attempts) The number of reconnection attempts int false 100 reconnect-interval (rabbitmq-reconnect-interval) The interval (in seconds) between two reconnection attempts int false 10 requested-channel-max The initially requested maximum channel number int false 2047 requested-heartbeat The initially requested heartbeat interval (seconds), zero for none int false 60 ssl (rabbitmq-ssl) Whether or not the connection should use SSL boolean false false tracing.attribute-headers A comma-separated list of headers that should be recorded as span attributes. Relevant only if tracing.enabled=true string false `` tracing.enabled Whether tracing is enabled (default) or disabled boolean false true trust-all (rabbitmq-trust-all) Whether to skip trust certificate verification boolean false false trust-store-password (rabbitmq-trust-store-password) The password of the JKS trust store string false trust-store-path (rabbitmq-trust-store-path) The path to a JKS trust store string false use-nio Whether usage of NIO Sockets is enabled boolean false false user The user name to use when connecting to the broker string false guest username (rabbitmq-username) The username used to authenticate to the broker string false virtual-host (rabbitmq-virtual-host) The virtual host to use when connecting to the broker string false /","title":"Configuration Reference"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#using-existing-destinations","text":"To use an existing exchange , you may need to configure the exchange.name attribute. For example, if you have a RabbitMQ broker already configured with an exchange called people that you wish to send messages to, you need the following configuration: 1 mp.messaging.outgoing.people.connector = smallrye-rabbitmq You would need to configure the exchange.name attribute, if the exchange name were not the channel name: 1 2 mp.messaging.outgoing.people-out.connector = smallrye-rabbitmq mp.messaging.outgoing.people-out.exchange.name = people If you want RabbitMQ to create the people exchange, you need the following configuration: 1 2 3 mp.messaging.outgoing.people-out.connector = smallrye-amqp mp.messaging.outgoing.people-out.exchange.name = people mp.messaging.outgoing.people-out.exchange.declare = true Note The above example will create a topic exchange and use an empty default routing-key (unless overridden programatically using outgoing metadata for the message). If you want to create a different type of exchange or have a different default routing key, then the exchange.type and default-routing-key properties need to be explicitly specified.","title":"Using existing destinations"},{"location":"rabbitmq/sending-messages-to-rabbitmq/#sending-to-specific-queues-via-the-default-exchange","text":"To send a message to a specific queue (usually a reply queue), you have to configure the default exchange as an outgoing channel and set the name of the queue as routing key in the message metadata. The name of the exchange needs to be set to \"\" . 1 2 mp.messaging.outgoing.channel-name-for-default-exchange.connector = smallrye-rabbitmq mp.messaging.outgoing.channel-name-for-default-exchange.exchange.name = \"\"","title":"Sending to specific queues via the default exchange"}]} \ No newline at end of file diff --git a/3.25.0/sitemap.xml b/3.25.0/sitemap.xml new file mode 100644 index 0000000000..3dbc83f2dd --- /dev/null +++ b/3.25.0/sitemap.xml @@ -0,0 +1,283 @@ + + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/getting-started/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/amqp/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/client-customization/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/health/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/rabbitmq/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/receiving-amqp-messages/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/amqp/sending-amqp-messages/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/camel/camel-processor/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/camel/camel/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/camel/receiving-messages-from-camel/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/camel/sending-messages-to-camel/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/camel/using-existing-routes/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/acknowledgement/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/advanced-config/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/blocking/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/broadcast/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/concepts/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/connectors/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/converters/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/decorators/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/emitter/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/incomings/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/logging/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/merge/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/message-context/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/model/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/signatures/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/skipping/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/concepts/testing/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/jms/advanced-jms/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/jms/jms/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/jms/receiving-jms-messages/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/jms/sending-jms-messages/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/avro-configuration/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/client-service/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/consumer-rebalance-listener/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/default-configuration/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/health/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/kafka/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/kerberos/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/protobuf-configuration/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/receiving-kafka-records/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/test-companion/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/transactions/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/kafka/writing-kafka-records/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/mqtt/client-customization/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/mqtt/mqtt/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/mqtt/receiving-mqtt-messages/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/mqtt/sending-messages-to-mqtt/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/rabbitmq-client-customization/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/rabbitmq-cloud/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/rabbitmq-health/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/rabbitmq/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/receiving-messages-from-rabbitmq/ + 2023-07-11 + daily + + + https://smallrye.io/smallrye-reactive-messaging/3.25.0/rabbitmq/sending-messages-to-rabbitmq/ + 2023-07-11 + daily + + \ No newline at end of file diff --git a/3.25.0/sitemap.xml.gz b/3.25.0/sitemap.xml.gz new file mode 100644 index 0000000000..ef9b2cbbc9 Binary files /dev/null and b/3.25.0/sitemap.xml.gz differ diff --git a/versions.json b/versions.json index 91fa142f25..98b2d7ca11 100644 --- a/versions.json +++ b/versions.json @@ -1 +1 @@ -[{"version": "4.7.0", "title": "4.7.0", "aliases": ["latest"]}, {"version": "4.6.0", "title": "4.6.0", "aliases": []}, {"version": "4.5.0", "title": "4.5.0", "aliases": []}, {"version": "4.4.0", "title": "4.4.0", "aliases": []}, {"version": "4.3.0", "title": "4.3.0", "aliases": []}, {"version": "4.2.0", "title": "4.2.0", "aliases": []}, {"version": "4.1.1", "title": "4.1.1", "aliases": []}, {"version": "4.1.0", "title": "4.1.0", "aliases": []}, {"version": "4.0.0", "title": "4.0.0", "aliases": []}, {"version": "3.24.0", "title": "3.24.0", "aliases": []}, {"version": "3.23.0", "title": "3.23.0", "aliases": []}, {"version": "3.22.1", "title": "3.22.1", "aliases": []}, {"version": "3.22.0", "title": "3.22.0", "aliases": []}, {"version": "3.21.0", "title": "3.21.0", "aliases": []}, {"version": "3.20.0", "title": "3.20.0", "aliases": []}, {"version": "3.19.1", "title": "3.19.1", "aliases": []}, {"version": "3.19.0", "title": "3.19.0", "aliases": []}, {"version": "3.18.0", "title": "3.18.0", "aliases": []}, {"version": "3.17.0", "title": "3.17.0", "aliases": []}, {"version": "3.16.0", "title": "3.16.0", "aliases": []}, {"version": "3.15.0", "title": "3.15.0", "aliases": []}, {"version": "3.14.1", "title": "3.14.1", "aliases": []}, {"version": "3.14.0", "title": "3.14.0", "aliases": []}] \ No newline at end of file +[{"version": "4.7.0", "title": "4.7.0", "aliases": ["latest"]}, {"version": "4.6.0", "title": "4.6.0", "aliases": []}, {"version": "4.5.0", "title": "4.5.0", "aliases": []}, {"version": "4.4.0", "title": "4.4.0", "aliases": []}, {"version": "4.3.0", "title": "4.3.0", "aliases": []}, {"version": "4.2.0", "title": "4.2.0", "aliases": []}, {"version": "4.1.1", "title": "4.1.1", "aliases": []}, {"version": "4.1.0", "title": "4.1.0", "aliases": []}, {"version": "4.0.0", "title": "4.0.0", "aliases": []}, {"version": "3.25.0", "title": "3.25.0", "aliases": []}, {"version": "3.24.0", "title": "3.24.0", "aliases": []}, {"version": "3.23.0", "title": "3.23.0", "aliases": []}, {"version": "3.22.1", "title": "3.22.1", "aliases": []}, {"version": "3.22.0", "title": "3.22.0", "aliases": []}, {"version": "3.21.0", "title": "3.21.0", "aliases": []}, {"version": "3.20.0", "title": "3.20.0", "aliases": []}, {"version": "3.19.1", "title": "3.19.1", "aliases": []}, {"version": "3.19.0", "title": "3.19.0", "aliases": []}, {"version": "3.18.0", "title": "3.18.0", "aliases": []}, {"version": "3.17.0", "title": "3.17.0", "aliases": []}, {"version": "3.16.0", "title": "3.16.0", "aliases": []}, {"version": "3.15.0", "title": "3.15.0", "aliases": []}, {"version": "3.14.1", "title": "3.14.1", "aliases": []}, {"version": "3.14.0", "title": "3.14.0", "aliases": []}] \ No newline at end of file