Sync master branch with 2201.10.0-stage

ballerina-test/src/test/java/org/ballerinalang/distribution/test/OpenAPIDistributionArtifactCheck.java

@@ -52,7 +52,7 @@ public void openapiAnnotationExistsTest() {
  .resolve("cache")
  .resolve("ballerina")
  .resolve("openapi")
- .resolve("2.0.0")
+ .resolve("2.1.0")
  .resolve("bir");
 
  Path jarPath = TEST_DISTRIBUTION_PATH
@@ -61,18 +61,7 @@ public void openapiAnnotationExistsTest() {
  .resolve("cache")
  .resolve("ballerina")
  .resolve("openapi")
- .resolve("2.0.0")
- .resolve("java17");
-
- Path balaPath = TEST_DISTRIBUTION_PATH
- .resolve(DIST_NAME)
- .resolve("repo")
- .resolve("bala")
- .resolve("ballerina")
- .resolve("openapi")
- .resolve("2.0.0")
- .resolve("java17")
- .resolve("platform")
+ .resolve("2.1.0")
  .resolve("java17");
 
  Path breLibPath = TEST_DISTRIBUTION_PATH
@@ -94,8 +83,7 @@ public void openapiAnnotationExistsTest() {
  .resolve("lib");
 
  Assert.assertTrue(Files.exists(birPath));
- Assert.assertTrue(Files.exists(balaPath));
- Assert.assertTrue(Files.exists(jarPath.resolve("ballerina-openapi-2.0.0.jar")));
+ Assert.assertTrue(Files.exists(jarPath.resolve("ballerina-openapi-2.1.0.jar")));
  Assert.assertNotNull(TestUtils.findFileOrDirectory(breLibPath, "openapi-cli-"));
  Assert.assertNotNull(TestUtils.findFileOrDirectory(breLibPath, "openapi-validator-"));
  Assert.assertNotNull(TestUtils.findFileOrDirectory(breLibPath, "ballerina-to-openapi-"));

ballerina-test/src/test/resources/openapi/expected/filtered_tags.bal

@@ -1,5 +1,6 @@
 // AUTO-GENERATED FILE.
 // This file is auto-generated by the Ballerina OpenAPI tool.
+
 import ballerina/http;
 
 listener http:Listener ep0 = new (80, config = {host: "petstore.openapi.io"});
@@ -10,7 +11,7 @@ service /v1 on ep0 {
  # + 'limit - How many items to return at one time (max 100)
  # + return - returns can be any of following types
  # http:Ok (An paged array of pets)
- # http:Response (unexpected error)
- resource function get pets(int:Signed32? 'limit) returns Pets|http:Response {
+ # http:DefaultStatusCodeResponse (unexpected error)
+ resource function get pets(int:Signed32? 'limit) returns Pets|ErrorDefault {
  }
 }

examples/graphql-client-security-jwt-authentication/graphql_client_security_jwt_authentication.md

@@ -2,7 +2,7 @@
 
 The `graphql:Client` can connect to a service that is secured with self-signed JWT by adding the `Authorization: Bearer <token>` header by passing the `graphql:JwtIssuerConfig` to the `auth` configuration of the client. A self-signed JWT is issued before the request is sent.
 
-::: code graphql_client_security_authentication.bal :::
+::: code graphql_client_security_jwt_authentication.bal :::
 
 ## Prerequisites
 - Run the GraphQL service given in the [JWT Auth service](/learn/by-example/graphql-service-jwt-auth/) example.

examples/graphql-service-query-complexity/graphql_service_query_complexity.md

@@ -1,6 +1,6 @@
 # GraphQL service - Query Complexity
 
-a `graphql:Service` can be secured by limiting the complexity of the operations that can be executed. This can be done by setting a maximum complexity threshold for a given service. The query complexity is calculated by assigning a complexity value to each field in the GraphQL schema. The complexity of an operation is the sum of the complexity values of the fields in the operation.
+A `graphql:Service` can be secured by limiting the complexity of the operations that can be executed. This can be done by setting a maximum complexity threshold for a given service. The query complexity is calculated by assigning a complexity value to each field in the GraphQL schema. The complexity of an operation is the sum of the complexity values of the fields in the operation.
 
 ::: code graphql_service_query_complexity.bal :::
 

examples/http-sse-service/http_sse_service.md

@@ -12,6 +12,8 @@ Invoke the service by executing the following cURL command in a new terminal.
 
 ::: out http_sse_service.client.out :::
 
+>**Tip:** You can invoke the above service via the [Client server-sent events](/learn/by-example/http-sse-client/) example.
+
 ## Related links
 - [`http` module - API documentation](https://lib.ballerina.io/ballerina/http/latest/)
 - [Resource return types - Specification](/spec/http/#235-return-types)

examples/index.json

@@ -3837,6 +3837,29 @@
  }
  ]
  },
+ {
+ "title": "LDAP client",
+ "column": 3,
+ "category": "Network libraries",
+ "samples": [
+ {
+ "name": "Add/Remove entries",
+ "url": "ldap-add-remove-entry",
+ "verifyBuild": true,
+ "verifyOutput": false,
+ "disablePlayground": true,
+ "isLearnByExample": false
+ },
+ {
+ "name": "Search for an entry",
+ "url": "ldap-search-entry",
+ "verifyBuild": true,
+ "verifyOutput": false,
+ "disablePlayground": true,
+ "isLearnByExample": false
+ }
+ ]
+ },
  {
  "title": "JMS service",
  "column": 3,

examples/ldap-add-remove-entry/ldap_add_remove_entry.bal

@@ -0,0 +1,27 @@
+import ballerina/io;
+import ballerina/ldap;
+
+public function main() returns error? {
+ // Initializes a new LDAP client with credentials.
+ ldap:Client ldapClient = check new (
+ hostName = "localhost",
+ port = 389,
+ domainName = "cn=admin,dc=example,dc=com",
+ password = "adminpassword"
+ );
+
+ // Creates an `ldap:Entry` record for the new entry.
+ ldap:Entry addEntry = {
+ "objectClass": ["top", "person"],
+ "sn": "user",
+ "cn": "user"
+ };
+
+ // Adds an entry to the directory server.
+ ldap:LdapResponse addResponse = check ldapClient->add("cn=user,dc=example,dc=com", addEntry);
+ io:println("Add Response: ", addResponse.resultCode);
+
+ // Deletes an entry from the directory server.
+ ldap:LdapResponse deleteResponse = check ldapClient->delete("cn=user,dc=example,dc=com");
+ io:println("Delete Response: ", deleteResponse.resultCode);
+}

examples/ldap-add-remove-entry/ldap_add_remove_entry.md

@@ -0,0 +1,22 @@
+# LDAP client - Add/Remove entries
+
+The `ldap:Client` connects to a directory server and performs various operations on directories. Currently, it supports the generic LDAP operations; `add`, `modify`, `modifyDN`, `compare`, `search`, `searchWithType`, `delete`, and `close`.
+
+The `add` operation creates a new entry in a directory server. It requires a `DN` (Distinguished Name) for the entry and the attributes to be included. The `objectClass` attribute must be specified to define the object classes for the entry, and any attributes required by these object classes should also be included.
+
+The `delete` operation removes an entry from a directory server. It requires a `DN` (Distinguished Name) of the entry to be deleted.
+
+::: code ldap_add_remove_entry.bal :::
+
+## Prerequisites
+- Ensure that an LDAP server is up and running locally on port 389 while running the example.
+
+- Run the example by executing the command below.
+
+::: out ldap_add_remove_entry.server.out :::
+
+## Related links
+- [`ldap:Client` `add` operation - API documentation](https://central.ballerina.io/ballerina/ldap/latest#Client-add)
+- [`ldap:Client` `delete` operation - API documentation](https://central.ballerina.io/ballerina/ldap/latest#Client-delete)
+- [`ldap` module - API documentation](https://lib.ballerina.io/ballerina/ldap/latest/)
+- [`ldap:Client` - Specification](/spec/ldap/#2-ldap-client)

examples/ldap-add-remove-entry/ldap_add_remove_entry.metatags

@@ -0,0 +1,2 @@
+description: This example is on how to create/delete entries in a directory server using LDAP in Ballerina.
+keywords: ballerina, ballerina by example, bbe, ldap, add

examples/ldap-add-remove-entry/ldap_add_remove_entry.server.out

@@ -0,0 +1,3 @@
+$ bal run ldap_add_remove_entry.bal
+Add Response: SUCCESS
+Delete Response: SUCCESS

examples/ldap-search-entry/ldap_search_entry.bal

@@ -0,0 +1,20 @@
+import ballerina/io;
+import ballerina/ldap;
+
+public function main() returns error? {
+ // Initializes a new LDAP client with credentials.
+ ldap:Client ldapClient = check new (
+ hostName = "localhost",
+ port = 389,
+ domainName = "cn=admin,dc=example,dc=com",
+ password = "adminpassword"
+ );
+
+ // Searches for an entry in the directory server.
+ ldap:SearchResult searchResult = check ldapClient->search(
+ "cn=user,dc=example,dc=com",
+ "(sn=user)",
+ ldap:SUB
+ );
+ io:println("Search Response: ", searchResult.resultCode);
+}

examples/ldap-search-entry/ldap_search_entry.md

@@ -0,0 +1,25 @@
+# LDAP client - Seacrh for an entry
+
+The `ldap:Client` connects to a directory server and performs various operations on directories. Currently, it supports the main LDAP operations; `add`, `modify`, `modifyDN`, `compare`, `search`, `searchWithType`, `delete`, and `close`.
+
+The `search` operation is used to retrieve entries that match specified criteria. The components of an LDAP search request include:
+
+- `baseDN`: Defines the base of the subtree for the search.
+- `filter`: Specifies the criteria that entries must meet.
+- `scope`: Determines extent of the the search coverage within the subtree.
+
+When a directory server processes a valid search request, it finds entries within the defined scope that meet the filter criteria. The matching entries are then returned to the client in a `ldap:SearchResult` record.
+
+::: code ldap_search_entry.bal :::
+
+## Prerequisites
+- Ensure that an LDAP server is up and running locally on port 389 while running the example.
+
+- Run the example by executing the command below.
+
+::: out ldap_search_entry.server.out :::
+
+## Related links
+- [`ldap:Client` `search` operation - API documentation](https://central.ballerina.io/ballerina/ldap/latest#Client-search)
+- [`ldap` module - API documentation](https://lib.ballerina.io/ballerina/ldap/latest/)
+- [`ldap:Client` - Specification](/spec/ldap/#2-ldap-client)

examples/ldap-search-entry/ldap_search_entry.metatags

@@ -0,0 +1,2 @@
+description: This example is on how to search for an entry in a directory server using LDAP in Ballerina.
+keywords: ballerina, ballerina by example, bbe, ldap, search

examples/ldap-search-entry/ldap_search_entry.server.out

@@ -0,0 +1,2 @@
+$ bal run ldap_search_entry.bal
+Search Response: SUCCESS

gradle.properties

@@ -4,7 +4,7 @@ group=org.ballerinalang
 version=2201.10.0-SNAPSHOT
 codeName=swan-lake
 
-ballerinaLangVersion=2201.10.0-20240722-112100-1b113f29
+ballerinaLangVersion=2201.10.0
 ballerinaJreVersion=2.0.0
 dependencyJREVersion=jdk-17.0.7+7-jre
 specVersion=2024R1
@@ -18,82 +18,83 @@ stdlibJavaArraysVersion=1.4.0
 stdlibTimeVersion=2.4.0
 stdlibUrlVersion=2.4.0
 stdlibXmldataVersion=2.8.0
-observeVersion=1.2.3
+observeVersion=1.3.0
 stdlibMathVectorVersion=1.0.2
-stdlibLdapVersion=1.0.0
+stdlibLdapVersion=1.0.1
 
 # Stdlib Level 02
 stdlibAvroVersion=1.0.0
 stdlibConstraintVersion=1.5.0
 stdlibCryptoVersion=2.7.2
-stdlibDataXmldataVersion=0.1.4
-stdlibLogVersion=2.9.0
+stdlibDataXmldataVersion=1.0.0
+stdlibLogVersion=2.10.0
 stdlibOsVersion=1.8.0
 stdlibProtobufVersion=1.6.0
-stdlibPersistVersion=1.3.0
+stdlibPersistVersion=1.4.0
 stdlibRandomVersion=1.5.0
 stdlibTaskVersion=2.5.0
-stdlibXsltVersion=2.6.0
-observeInternalVersion=1.2.2
+stdlibXsltVersion=2.7.0
+observeInternalVersion=1.3.0
 
 # Stdlib Level 03
 stdlibCacheVersion=3.8.0
-stdlibFileVersion=1.9.0
-stdlibFtpVersion=2.10.1
-stdlibMimeVersion=2.10.0-20240724-124600-f193322
-stdlibTcpVersion=1.10.0
-stdlibUdpVersion=1.10.0
+stdlibFileVersion=1.10.0
+stdlibFtpVersion=2.11.0
+stdlibMimeVersion=2.10.0
+stdlibTcpVersion=1.11.0
+stdlibUdpVersion=1.11.0
 stdlibUuidVersion=1.8.0
 
 # Stdlib Level 04
-stdlibAuthVersion=2.11.0
-stdlibDataJsondataVersion=0.1.0
-stdlibDataYamlVersion=0.1.0-20240805-142200-476565f
-stdlibEdiVersion=1.2.0
-stdlibEmailVersion=2.9.0
-stdlibJwtVersion=2.12.1
-stdlibMqttVersion=1.1.1
-stdlibOAuth2Version=2.11.0
-stdlibTomlVersion=0.5.1
-stdlibYamlVersion=0.5.3
+stdlibAuthVersion=2.12.0
+stdlibDataJsondataVersion=0.2.0
+stdlibDataYamlVersion=0.1.0
+stdlibEdiVersion=1.3.0
+stdlibEmailVersion=2.10.0
+stdlibJwtVersion=2.13.0
+stdlibMqttVersion=1.2.0
+stdlibOAuth2Version=2.12.0
+stdlibTomlVersion=0.6.0
+stdlibYamlVersion=0.6.0
 
 # Stdlib Level 05
-stdlibHttpVersion=2.12.0-20240801-081400-0b676d6
+stdlibHttpVersion=2.12.0
+
 
 # Stdlib Level 06
-stdlibGrpcVersion=1.11.1
-stdlibSoapVersion=1.0.0
-stdlibTransactionVersion=1.9.0
-stdlibWebsocketVersion=2.11.0
-stdlibWebsubVersion=2.11.0
-stdlibWebsubhubVersion=1.11.0
+stdlibGrpcVersion=1.12.0
+stdlibSoapVersion=1.1.0
+stdlibTransactionVersion=1.10.0
+stdlibWebsocketVersion=2.12.0
+stdlibWebsubVersion=2.12.0
+stdlibWebsubhubVersion=1.12.0
 
 # Stdlib Level 07
-stdlibGraphqlVersion=1.14.0-20240801-114000-e4337a2
-stdlibSqlVersion=1.13.0
+stdlibGraphqlVersion=1.14.0
+stdlibSqlVersion=1.14.0
 
 # Persist Tool
-persistToolVersion=1.3.0
+persistToolVersion=1.4.0
 
 # Dev Tools
-devToolsVersion=1.4.0
+devToolsVersion=1.5.0
 ballerinaCommandVersion=1.4.2
 
 # API Doc UI
 docUiApi=https://api.dev-central.ballerina.io/2.0/docs/doc-ui
 
 # GraphQL Tool
-graphqlToolVersion=0.10.0
+graphqlToolVersion=0.11.0
 
 # Protoc Tool
 protocToolVersion=0.3.0
 
 # OpenAPI Module
-openapiToolVersion=2.0.0
+openapiToolVersion=2.1.0
 
 # AsyncAPI Module
-asyncapiToolVersion=0.8.0
+asyncapiToolVersion=0.9.0
 
-c2cVersion=3.0.0
+c2cVersion=3.1.0
 
 installerVersion=f7b952b2-f64b-45f0-ab86-df7d892ffc21