feat(clients): add new realtime-personalization api (#4613)

Co-authored-by: Bilel Benamira <bilel.benamira@algolia.com>
Co-authored-by: shortcuts <vannicattec@gmail.com>

Author: 3 people

clients/algoliasearch-client-dart/packages/client_composition/lib/src/extension.dart

@@ -0,0 +1 @@
+

clients/algoliasearch-client-dart/packages/client_realtime_personalization/build.yaml

@@ -0,0 +1,14 @@
+targets:
+  $default:
+    builders:
+      json_serializable:
+        options:
+          any_map: false
+          checked: true
+          create_factory: true
+          create_to_json: true
+          disallow_unrecognized_keys: false
+          explicit_to_json: true
+          field_rename: none
+          ignore_unannotated: false
+          include_if_null: false

clients/algoliasearch-client-dart/packages/client_realtime_personalization/lib/src/extension.dart

@@ -0,0 +1 @@
+

clients/algoliasearch-client-javascript/package.json

@@ -7,7 +7,7 @@
     "packages/*"
   ],
   "scripts": {
-    "build": "lerna run build --skip-nx-cache --scope '@algolia/requester-testing' --scope '@algolia/logger-console' --scope 'algoliasearch' --scope '@algolia/client-composition' --scope '@algolia/composition' --include-dependencies",
+    "build": "lerna run build --skip-nx-cache --scope '@algolia/requester-testing' --scope '@algolia/logger-console' --scope 'algoliasearch' --scope '@algolia/client-composition' --scope '@algolia/composition' --scope '@algolia/client-realtime-personalization' --include-dependencies",
     "clean": "lerna run clean",
     "release:publish": "tsc --project scripts/tsconfig.json && node scripts/dist/publish.js",
     "test": "lerna run test $*",

clients/algoliasearch-client-javascript/packages/client-realtime-personalization/package.json

@@ -0,0 +1,68 @@
+{
+  "version": "0.0.1-alpha.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/algolia/algoliasearch-client-javascript.git"
+  },
+  "homepage": "https://github.com/algolia/algoliasearch-client-javascript/packages/client-realtime-personalization#readme",
+  "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-realtime-personalization",
+  "description": "JavaScript client for client-realtime-personalization",
+  "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/worker.d.ts",
+        "default": "./dist/builds/worker.js"
+      },
+      "default": {
+        "types": "./dist/browser.d.ts",
+        "module": "./dist/builds/browser.js",
+        "import": "./dist/builds/browser.js",
+        "default": "./dist/builds/browser.umd.js"
+      }
+    },
+    "./dist/builds/*": "./dist/builds/*.js"
+  },
+  "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.22.0",
+    "@algolia/requester-browser-xhr": "5.22.0",
+    "@algolia/requester-fetch": "5.22.0",
+    "@algolia/requester-node-http": "5.22.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.17.4",
+    "@types/node": "22.13.11",
+    "publint": "0.3.9",
+    "rollup": "4.36.0",
+    "tsup": "8.4.0",
+    "typescript": "5.7.3"
+  },
+  "engines": {
+    "node": ">= 14.0.0"
+  }
+}

clients/algoliasearch-client-javascript/yarn.lock

@@ -122,6 +122,23 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@algolia/client-realtime-personalization@workspace:packages/client-realtime-personalization":
+  version: 0.0.0-use.local
+  resolution: "@algolia/client-realtime-personalization@workspace:packages/client-realtime-personalization"
+  dependencies:
+    "@algolia/client-common": "npm:5.22.0"
+    "@algolia/requester-browser-xhr": "npm:5.22.0"
+    "@algolia/requester-fetch": "npm:5.22.0"
+    "@algolia/requester-node-http": "npm:5.22.0"
+    "@arethetypeswrong/cli": "npm:0.17.4"
+    "@types/node": "npm:22.13.11"
+    publint: "npm:0.3.9"
+    rollup: "npm:4.36.0"
+    tsup: "npm:8.4.0"
+    typescript: "npm:5.7.3"
+  languageName: unknown
+  linkType: soft
+
 "@algolia/client-search@npm:5.22.0, @algolia/client-search@workspace:packages/client-search":
   version: 0.0.0-use.local
   resolution: "@algolia/client-search@workspace:packages/client-search"

config/clients.config.json

@@ -10,7 +10,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-csharp",
     "gitRepoId": "algoliasearch-client-csharp",
@@ -48,6 +49,10 @@
       {
         "name": "search",
         "output": "clients/algoliasearch-client-dart/packages/client_search"
+      },
+      {
+        "name": "realtime-personalization",
+        "output": "clients/algoliasearch-client-dart/packages/client_realtime_personalization"
       }
     ],
     "folder": "clients/algoliasearch-client-dart",
@@ -76,7 +81,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-go",
     "gitRepoId": "algoliasearch-client-go",
@@ -104,7 +110,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-java",
     "gitRepoId": "algoliasearch-client-java",
@@ -176,6 +183,10 @@
       {
         "name": "composition-full",
         "output": "clients/algoliasearch-client-javascript/packages/client-composition"
+      },
+      {
+        "name": "realtime-personalization",
+        "output": "clients/algoliasearch-client-javascript/packages/client-realtime-personalization"
       }
     ],
     "folder": "clients/algoliasearch-client-javascript",
@@ -203,7 +214,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-kotlin",
     "gitRepoId": "algoliasearch-client-kotlin",
@@ -231,7 +243,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-php",
     "gitRepoId": "algoliasearch-client-php",
@@ -259,7 +272,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-python",
     "gitRepoId": "algoliasearch-client-python",
@@ -294,7 +308,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-ruby",
     "gitRepoId": "algoliasearch-client-ruby",
@@ -322,7 +337,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-scala",
     "gitRepoId": "algoliasearch-client-scala",
@@ -349,7 +365,8 @@
       "personalization",
       "query-suggestions",
       "recommend",
-      "search"
+      "search",
+      "realtime-personalization"
     ],
     "folder": "clients/algoliasearch-client-swift",
     "gitRepoId": "algoliasearch-client-swift",

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

@@ -28,9 +28,9 @@ public String getName() {
   public void processOpts() {
     String client = (String) additionalProperties.get("client");
 
-    additionalProperties.put("packageName", client.equals("query-suggestions") ? "suggestions" : client);
+    additionalProperties.put("packageName", client.equals("query-suggestions") ? "suggestions" : Helpers.camelize(client));
     additionalProperties.put("enumClassPrefix", true);
-    additionalProperties.put("is" + Helpers.capitalize(Helpers.camelize((String) additionalProperties.get("client"))) + "Client", true);
+    additionalProperties.put("is" + Helpers.capitalize(Helpers.camelize(client)) + "Client", true);
 
     String outputFolder = "algolia" + File.separator + client;
     setOutputDir(getOutputDir() + File.separator + outputFolder);

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

@@ -145,7 +145,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(Helpers.camelize(client)) + "Client", true);
-      bundle.put("isStandaloneClient", client.contains("search") || client.contains("composition"));
+      bundle.put("isStandaloneClient", client.contains("search") || client.contains("composition") || client.contains("realtime"));
       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/GoCTSManager.java

@@ -23,11 +23,13 @@ public String getClient() {
 
   @Override
   public void addDataToBundle(Map<String, Object> bundle) throws GeneratorException {
-    Object clientPrefix = bundle.get("clientPrefix");
+    String clientPrefix = (String) bundle.get("clientPrefix");
     bundle.put("clientName", Helpers.toPascalCase(this.client));
 
     if (clientPrefix.equals("query-suggestions")) {
       bundle.put("clientPrefix", "suggestions");
+    } else {
+      bundle.put("clientPrefix", Helpers.camelize(clientPrefix));
     }
 
     bundle.put("clientImport", clientPrefix);