feat(specs): add abtesting specs and client (#76)

Author: shortcuts

.eslintrc.js

@@ -63,9 +63,6 @@ module.exports = {
     'max-classes-per-file': 0,
     'no-continue': 0,
     '@typescript-eslint/prefer-enum-initializers': 0,
-    // there's a conflict when declaring `type` and `namespaces`, even with `ignoreDeclarationMerge`
-    'no-redeclare': 0,
-    '@typescript-eslint/no-redeclare': 0,
 
     '@typescript-eslint/no-unused-vars': 2,
     'unused-imports/no-unused-imports-ts': 2,

.github/actions/cache/action.yml

@@ -46,6 +46,13 @@ runs:
         path: /home/runner/work/api-clients-automation/api-clients-automation/clients/algoliasearch-client-javascript/client-analytics/dist
         key: ${{ runner.os }}-js-client-analytics-${{ hashFiles('clients/algoliasearch-client-javascript/client-analytics/**') }}
 
+    - name: Restore built JavaScript abtesting client
+      if: ${{ inputs.job == 'cts' }}
+      uses: actions/cache@v2
+      with:
+        path: /home/runner/work/api-clients-automation/api-clients-automation/clients/algoliasearch-client-javascript/client-abtesting/dist
+        key: ${{ runner.os }}-js-client-abtesting-${{ hashFiles('clients/algoliasearch-client-javascript/client-abtesting/**') }}
+
     - name: Restore built JavaScript insights client
       if: ${{ inputs.job == 'cts' }}
       uses: actions/cache@v2

.github/actions/setup/action.yml

@@ -35,7 +35,7 @@ runs:
         echo "::set-output name=PERSO_SPECS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- specs/personalization | wc -l)"
         echo "::set-output name=INSIGHTS_SPECS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- specs/insights | wc -l)"
         echo "::set-output name=ANALYTICS_SPECS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- specs/analytics | wc -l)"
-        echo "::set-output name=AB_SPECS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- specs/abtesting | wc -l)"
+        echo "::set-output name=ABTESTING_SPECS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- specs/abtesting | wc -l)"
 
         echo "::set-output name=TESTS_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- tests | wc -l)"
 
@@ -47,6 +47,7 @@ runs:
         echo "::set-output name=JS_QUERY_SUGGESTIONS_CLIENT_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- clients/algoliasearch-client-javascript/client-query-suggestions | wc -l)"
         echo "::set-output name=JS_PERSO_CLIENT_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- clients/algoliasearch-client-javascript/client-personalization | wc -l)"
         echo "::set-output name=JS_ANALYTICS_CLIENT_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- clients/algoliasearch-client-javascript/client-analytics | wc -l)"
+        echo "::set-output name=JS_ABTESTING_CLIENT_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- clients/algoliasearch-client-javascript/client-abtesting | wc -l)"
         echo "::set-output name=JS_INSIGHTS_CLIENT_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- clients/algoliasearch-client-javascript/client-insights | wc -l)"
         echo "::set-output name=JS_TEMPLATE_CHANGED::$(git diff --shortstat origin/${{ github.base_ref }}..HEAD -- templates/javascript | wc -l)"
 
@@ -73,9 +74,9 @@ outputs:
   RUN_SPECS_ANALYTICS:
     description: Determine if the `specs_analytics` job should run
     value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.ANALYTICS_SPECS_CHANGED > 0 }}
-  RUN_SPECS_AB:
-    description: Determine if the `specs_ab` job should run
-    value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.AB_SPECS_CHANGED > 0 }}
+  RUN_SPECS_ABTESTING:
+    description: Determine if the `specs_abtesting` job should run
+    value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.ABTESTING_SPECS_CHANGED > 0 }}
 
   # js client variables
   RUN_JS_CLIENT_SEARCH:
@@ -93,6 +94,9 @@ outputs:
   RUN_JS_CLIENT_ANALYTICS:
     description: Determine if the `client_javascript_analytics` job should run
     value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.ANALYTICS_SPECS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.JS_ANALYTICS_CLIENT_CHANGED > 0 || steps.diff.outputs.JS_TEMPLATE_CHANGED > 0 }}
+  RUN_JS_CLIENT_ABTESTING:
+    description: Determine if the `client_javascript_abtesting` job should run
+    value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.ABTESTING_SPECS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.JS_ABTESTING_CLIENT_CHANGED > 0 || steps.diff.outputs.JS_TEMPLATE_CHANGED > 0 }}
   RUN_JS_CLIENT_INSIGHTS:
     description: Determine if the `client_javascript_insights` job should run
     value: ${{ github.ref == 'refs/heads/main' || steps.diff.outputs.GITHUB_ACTIONS_CHANGED > 0 || steps.diff.outputs.COMMON_SPECS_CHANGED > 0 || steps.diff.outputs.INSIGHTS_SPECS_CHANGED > 0 || steps.diff.outputs.SCRIPTS_CHANGED > 0 || steps.diff.outputs.JS_INSIGHTS_CLIENT_CHANGED > 0 || steps.diff.outputs.JS_TEMPLATE_CHANGED > 0 }}

.github/workflows/check.yml

@@ -32,13 +32,14 @@ jobs:
       RUN_SPECS_PERSO: ${{ steps.setup.outputs.RUN_SPECS_PERSO }}
       RUN_SPECS_INSIGHTS: ${{ steps.setup.outputs.RUN_SPECS_INSIGHTS }}
       RUN_SPECS_ANALYTICS: ${{ steps.setup.outputs.RUN_SPECS_ANALYTICS }}
-      RUN_SPECS_AB: ${{ steps.setup.outputs.RUN_SPECS_AB }}
+      RUN_SPECS_ABTESTING: ${{ steps.setup.outputs.RUN_SPECS_ABTESTING }}
 
       RUN_JS_CLIENT_SEARCH: ${{ steps.setup.outputs.RUN_JS_CLIENT_SEARCH }}
       RUN_JS_CLIENT_RECOMMEND: ${{ steps.setup.outputs.RUN_JS_CLIENT_RECOMMEND }}
       RUN_JS_CLIENT_QUERY_SUGGESTIONS: ${{ steps.setup.outputs.RUN_JS_CLIENT_QUERY_SUGGESTIONS }}
       RUN_JS_CLIENT_PERSO: ${{ steps.setup.outputs.RUN_JS_CLIENT_PERSO }}
       RUN_JS_CLIENT_ANALYTICS: ${{ steps.setup.outputs.RUN_JS_CLIENT_ANALYTICS }}
+      RUN_JS_CLIENT_ABTESTING: ${{ steps.setup.outputs.RUN_JS_CLIENT_ABTESTING }}
       RUN_JS_CLIENT_INSIGHTS: ${{ steps.setup.outputs.RUN_JS_CLIENT_INSIGHTS }}
 
       RUN_JAVA_CLIENT: ${{ steps.setup.outputs.RUN_JAVA_CLIENT }}
@@ -125,6 +126,22 @@ jobs:
       - name: Lint analytics specs
         run: yarn eslint --ext=yml specs/analytics
 
+  specs_abtesting:
+    runs-on: ubuntu-20.04
+    needs: setup
+    if: ${{ always() && needs.setup.outputs.RUN_SPECS_ABTESTING == 'true' }}
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Restore cache
+        uses: ./.github/actions/cache
+
+      - name: Checking abtesting specs
+        run: yarn build:specs abtesting
+
+      - name: Lint abtesting specs
+        run: yarn eslint --ext=yml specs/abtesting
+
   specs_insights:
     runs-on: ubuntu-20.04
     needs: setup
@@ -266,6 +283,31 @@ jobs:
         if: steps.cache.outputs.cache-hit != 'true'
         run: yarn build:clients javascript analytics
 
+  client_javascript_abtesting:
+    runs-on: ubuntu-20.04
+    needs: [specs_abtesting]
+    if: ${{ always() && needs.setup.outputs.RUN_JS_CLIENT_ABTESTING == 'true' }}
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Restore cache
+        uses: ./.github/actions/cache
+
+      - name: Cache abtesting client
+        id: cache
+        uses: actions/cache@v2
+        with:
+          path: /home/runner/work/api-clients-automation/api-clients-automation/clients/algoliasearch-client-javascript/client-abtesting/dist
+          key: ${{ runner.os }}-js-client-abtesting-${{ hashFiles('clients/algoliasearch-client-javascript/client-abtesting/**') }}
+
+      - name: Generate abtesting client
+        if: steps.cache.outputs.cache-hit != 'true'
+        run: yarn generate javascript abtesting
+
+      - name: Build abtesting client
+        if: steps.cache.outputs.cache-hit != 'true'
+        run: yarn build:clients javascript abtesting
+
   client_javascript_insights:
     runs-on: ubuntu-20.04
     needs: [specs_insights]
@@ -326,6 +368,7 @@ jobs:
       - client_javascript_query_suggestions
       - client_javascript_perso
       - client_javascript_analytics
+      - client_javascript_abtesting
       - client_javascript_insights
       - client_java_search
 

README.md

@@ -101,19 +101,19 @@ The clients can be tested inside the [`playground`](./playground) folder
 ### Usage
 
 ```bash
-yarn docker playground:<language>:<client>
+yarn docker playground <language> <client>
 ```
 
 ### JavaScript
 
 ```bash
-yarn docker playground:js:search
+yarn docker playground javascript search
 ```
 
 ### Java
 
 ```bash
-yarn docker playground:java:search
+yarn docker playground java search
 ```
 
 # Troubleshooting

clients/README.md

@@ -4,11 +4,20 @@ This folder hosts the generated clients and their utils.
 
 ## Generated clients
 
+### Java
+
+- [algoliasearch-client-java-2](./algoliasearch-client-java-2/): The Algolia search client.
+
 ### JavaScript
 
-- [algoliasearch](./algoliasearch-client-javascript/algoliasearch/): The Algolia search client.
+- [@algolia/client-abtesting](./algoliasearch-client-javascript/client-abtesting/): The Algolia AB testing client.
+- [@algolia/client-analytics](./algoliasearch-client-javascript/client-analytics/): The Algolia analytics client.
+- [@algolia/client-insights](./algoliasearch-client-javascript/client-insights/): The Algolia insights client.
+- [@algolia/client-personalization](./algoliasearch-client-javascript/client-personalization/): The Algolia personalization client.
+- [@algolia/client-query-suggestions](./algoliasearch-client-javascript/client-query-suggestions/): The Algolia query suggestions client.
+- [@algolia/client-search](./algoliasearch-client-javascript/client-search/): The Algolia search client.
 - [@algolia/recommend](./algoliasearch-client-javascript/recommend/): The Algolia recommend client.
 
-## Utils
+#### Utils
 
 - [JavaScript](./algoliasearch-client-javascript/utils/): The JavaScript clients utils.

clients/algoliasearch-client-java-2/algoliasearch-core/com/algolia/model/BatchResponse.java

@@ -20,7 +20,7 @@ public BatchResponse taskID(Integer taskID) {
   }
 
   /**
-   * taskID of the indexing task to wait for.
+   * taskID of the task to wait for.
    *
    * @return taskID
    */

clients/algoliasearch-client-java-2/algoliasearch-core/com/algolia/model/DeletedAtResponse.java

@@ -19,7 +19,7 @@ public DeletedAtResponse taskID(Integer taskID) {
   }
 
   /**
-   * taskID of the indexing task to wait for.
+   * taskID of the task to wait for.
    *
    * @return taskID
    */

clients/algoliasearch-client-java-2/algoliasearch-core/com/algolia/model/SaveObjectResponse.java

@@ -40,7 +40,7 @@ public SaveObjectResponse taskID(Integer taskID) {
   }
 
   /**
-   * taskID of the indexing task to wait for.
+   * taskID of the task to wait for.
    *
    * @return taskID
    */

clients/algoliasearch-client-java-2/algoliasearch-core/com/algolia/model/SaveSynonymResponse.java

@@ -22,7 +22,7 @@ public SaveSynonymResponse taskID(Integer taskID) {
   }
 
   /**
-   * taskID of the indexing task to wait for.
+   * taskID of the task to wait for.
    *
    * @return taskID
    */