feat(specs): add composition API (#4056)

Co-authored-by: shortcuts <[email protected]>
Co-authored-by: Pierre Millot <[email protected]>

Author: 3 people

clients/algoliasearch-client-javascript/bundlesize.config.json

@@ -16,6 +16,10 @@
       "path": "packages/client-analytics/dist/builds/browser.umd.js",
       "maxSize": "4.85KB"
     },
+    {
+      "path": "packages/client-composition/dist/builds/browser.umd.js",
+      "maxSize": "4.05KB"
+    },
     {
       "path": "packages/client-insights/dist/builds/browser.umd.js",
       "maxSize": "3.90KB"

clients/algoliasearch-client-javascript/package.json

@@ -6,7 +6,7 @@
     "packages/*"
   ],
   "scripts": {
-    "build": "lerna run build --scope '@algolia/requester-testing' --scope '@algolia/logger-console' --scope 'algoliasearch' --include-dependencies",
+    "build": "lerna run build --scope '@algolia/requester-testing' --scope '@algolia/logger-console' --scope 'algoliasearch' --scope '@algolia/client-composition' --include-dependencies",
     "clean": "lerna run clean",
     "release:bump": "lerna version ${0:-patch} --no-changelog --no-git-tag-version --no-push --exact --force-publish --yes",
     "release:publish": "tsc --project scripts/tsconfig.json && node scripts/dist/scripts/publish.js",

clients/algoliasearch-client-javascript/packages/client-composition/package.json

@@ -0,0 +1,67 @@
+{
+  "version": "0.0.1-alpha.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/algolia/algoliasearch-client-javascript.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "author": "Algolia",
+  "scripts": {
+    "build": "yarn clean && yarn tsup && yarn rollup -c rollup.config.js",
+    "clean": "rm -rf ./dist || true",
+    "test:bundle": "publint . && attw --pack ."
+  },
+  "name": "@algolia/client-composition",
+  "description": "JavaScript client for client-composition",
+  "exports": {
+    ".": {
+      "node": {
+        "types": {
+          "import": "./dist/node.d.ts",
+          "module": "./dist/node.d.ts",
+          "require": "./dist/node.d.cts"
+        },
+        "import": "./dist/builds/node.js",
+        "module": "./dist/builds/node.js",
+        "require": "./dist/builds/node.cjs"
+      },
+      "worker": {
+        "types": "./dist/fetch.d.ts",
+        "default": "./dist/builds/fetch.js"
+      },
+      "default": {
+        "types": "./dist/browser.d.ts",
+        "module": "./dist/builds/browser.js",
+        "import": "./dist/builds/browser.js",
+        "default": "./dist/builds/browser.umd.js"
+      }
+    },
+    "./src/*": "./src/*.ts"
+  },
+  "jsdelivr": "./dist/builds/browser.umd.js",
+  "unpkg": "./dist/builds/browser.umd.js",
+  "react-native": "./dist/builds/browser.js",
+  "files": [
+    "dist",
+    "index.js",
+    "index.d.ts"
+  ],
+  "dependencies": {
+    "@algolia/client-common": "5.12.0",
+    "@algolia/requester-browser-xhr": "5.12.0",
+    "@algolia/requester-node-http": "5.12.0",
+    "@algolia/requester-fetch": "5.12.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.16.4",
+    "@types/node": "22.8.1",
+    "publint": "0.2.12",
+    "rollup": "4.24.2",
+    "tsup": "8.3.5",
+    "typescript": "5.6.3"
+  },
+  "engines": {
+    "node": ">= 14.0.0"
+  }
+}

clients/algoliasearch-client-javascript/yarn.lock

@@ -54,6 +54,23 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@algolia/client-composition@workspace:packages/client-composition":
+  version: 0.0.0-use.local
+  resolution: "@algolia/client-composition@workspace:packages/client-composition"
+  dependencies:
+    "@algolia/client-common": "npm:5.12.0"
+    "@algolia/requester-browser-xhr": "npm:5.12.0"
+    "@algolia/requester-fetch": "npm:5.12.0"
+    "@algolia/requester-node-http": "npm:5.12.0"
+    "@arethetypeswrong/cli": "npm:0.16.4"
+    "@types/node": "npm:22.8.1"
+    publint: "npm:0.2.12"
+    rollup: "npm:4.24.2"
+    tsup: "npm:8.3.5"
+    typescript: "npm:5.6.3"
+  languageName: unknown
+  linkType: soft
+
 "@algolia/client-insights@npm:5.12.0, @algolia/client-insights@workspace:packages/client-insights":
   version: 0.0.0-use.local
   resolution: "@algolia/client-insights@workspace:packages/client-insights"

config/clients.config.json

@@ -113,12 +113,7 @@
       "extension": ".java",
       "outputFolder": "src/test/java/com/algolia"
     },
-    "supportedVersions": [
-      "8",
-      "11",
-      "21",
-      "17"
-    ]
+    "supportedVersions": ["8", "11", "21", "17"]
   },
   "javascript": {
     "clients": [
@@ -161,6 +156,10 @@
       {
         "name": "search",
         "output": "clients/algoliasearch-client-javascript/packages/client-search"
+      },
+      {
+        "name": "composition",
+        "output": "clients/algoliasearch-client-javascript/packages/client-composition"
       }
     ],
     "folder": "clients/algoliasearch-client-javascript",
@@ -257,13 +256,7 @@
       "extension": ".py",
       "outputFolder": ""
     },
-    "supportedVersions": [
-      "3.8",
-      "3.9",
-      "3.10",
-      "3.11",
-      "3.12"
-    ]
+    "supportedVersions": ["3.8", "3.9", "3.10", "3.11", "3.12"]
   },
   "ruby": {
     "clients": [

generators/src/main/java/com/algolia/codegen/AlgoliaJavascriptGenerator.java

@@ -18,6 +18,7 @@ public class AlgoliaJavascriptGenerator extends TypeScriptNodeClientCodegen {
 
   private String CLIENT;
   private boolean isAlgoliasearchClient;
+  private boolean isAlgoliaCompositionClient;
 
   @Override
   public String getName() {
@@ -30,6 +31,7 @@ public void processOpts() {
 
     CLIENT = Helpers.camelize((String) additionalProperties.get("client"));
     isAlgoliasearchClient = CLIENT.equals("algoliasearch");
+    isAlgoliaCompositionClient = CLIENT.equals("composition");
 
     // generator specific options
     setSupportsES6(true);
@@ -155,6 +157,7 @@ private void setDefaultGeneratorOptions() {
     additionalProperties.put("isSearchClient", CLIENT.equals("search") || isAlgoliasearchClient);
     additionalProperties.put("isIngestionClient", CLIENT.equals("ingestion"));
     additionalProperties.put("isAlgoliasearchClient", isAlgoliasearchClient);
+    additionalProperties.put("isAlgoliaCompositionClient", isAlgoliaCompositionClient);
     additionalProperties.put("packageVersion", Helpers.getPackageJsonVersion(packageName));
     additionalProperties.put("packageName", packageName);
     additionalProperties.put("npmPackageName", isAlgoliasearchClient ? packageName : "@algolia/" + packageName);
@@ -169,10 +172,16 @@ private void setDefaultGeneratorOptions() {
           continue;
         }
 
+        String version = Helpers.getPackageJsonVersion(name);
+
+        if (version.contains("alpha") || version.contains("beta")) {
+          continue;
+        }
+
         var dependency = new HashMap<String, Object>();
         dependency.put("dependencyName", Helpers.createClientName((String) pkg.get("name"), "javascript"));
         dependency.put("dependencyPackage", "@algolia/" + name);
-        dependency.put("dependencyVersion", Helpers.getPackageJsonVersion(name));
+        dependency.put("dependencyVersion", version);
         dependency.put("withInitMethod", !name.contains("search"));
         dependency.put(
           "dependencyHasRegionalHosts",

generators/src/main/java/com/algolia/codegen/cts/AlgoliaCTSGenerator.java

@@ -148,6 +148,7 @@ public Map<String, Object> postProcessSupportingFileData(Map<String, Object> obj
       // We can put whatever we want in the bundle, and it will be accessible in the template
       bundle.put("mode", mode);
       bundle.put("is" + Helpers.capitalize(client) + "Client", true);
+      bundle.put("isStandaloneClient", client.contains("search") || client.equals("composition"));
       bundle.put("isSearchClient", client.contains("search")); // just so algoliasearch is treated as a search client too
       bundle.put("client", Helpers.createClientName(importClientName, language) + "Client");
       bundle.put("clientPrefix", Helpers.createClientName(importClientName, language));

generators/src/main/java/com/algolia/codegen/cts/manager/JavascriptCTSManager.java

@@ -46,7 +46,13 @@ public void addDataToBundle(Map<String, Object> bundle) throws GeneratorExceptio
     bundle.put("utilsPackageVersion", Helpers.getPackageJsonVersion("client-common"));
     bundle.put("algoliasearchVersion", Helpers.getPackageJsonVersion("algoliasearch"));
     bundle.put("initMethod", "init" + Helpers.capitalize(Helpers.camelize(client)));
-    bundle.put("clientName", client.equals("algoliasearch") ? "liteClient" : "algoliasearch");
-    bundle.put("importPackage", client.equals("algoliasearch") ? "algoliasearch/lite" : "algoliasearch");
+    bundle.put(
+      "clientName",
+      client.equals("algoliasearch") ? "liteClient" : client.equals("composition") ? "compositionClient" : "algoliasearch"
+    );
+    bundle.put(
+      "importPackage",
+      client.equals("algoliasearch") ? "algoliasearch/lite" : client.equals("composition") ? "@algolia/client-composition" : "algoliasearch"
+    );
   }
 }

playground/javascript/node/composition.ts

@@ -0,0 +1,24 @@
+import { ApiError } from '@algolia/client-common';
+import { compositionClient } from '@algolia/client-composition';
+
+const appId = process.env.ALGOLIA_APPLICATION_ID || '**** APP_ID *****';
+const apiKey = process.env.ALGOLIA_ADMIN_KEY || '**** ADMIN_KEY *****';
+
+// Init client with appId and apiKey
+const client = compositionClient(appId, apiKey);
+
+async function testComposition() {
+  try {
+    const res = await client.listCompositions();
+
+    console.log(`[OK]`, res);
+  } catch (e) {
+    if (e instanceof ApiError) {
+      return console.log(`[${e.status}] ${e.message}`, e.stackTrace, e);
+    }
+
+    console.log('[ERROR]', e);
+  }
+}
+
+testComposition();

playground/javascript/node/package.json

@@ -10,6 +10,7 @@
     "@algolia/client-abtesting": "link:../../../clients/algoliasearch-client-javascript/packages/client-abtesting",
     "@algolia/client-analytics": "link:../../../clients/algoliasearch-client-javascript/packages/client-analytics",
     "@algolia/client-common": "link:../../../clients/algoliasearch-client-javascript/packages/client-common",
+    "@algolia/client-composition": "link:../../../clients/algoliasearch-client-javascript/packages/client-composition",
     "@algolia/client-insights": "link:../../../clients/algoliasearch-client-javascript/packages/client-insights",
     "@algolia/client-personalization": "link:../../../clients/algoliasearch-client-javascript/packages/client-personalization",
     "@algolia/client-query-suggestions": "link:../../../clients/algoliasearch-client-javascript/packages/client-query-suggestions",