integrate helper into monorepo

.circleci/config.yml

@@ -64,6 +64,13 @@ workflows:
             branches:
               only:
                 - master
+      - helper docs:
+          requires:
+            - build
+          filters:
+            branches:
+              only:
+                - master
       - e2e tests:
           context: fx-libraries
           requires:
@@ -80,6 +87,7 @@ workflows:
             - unit tests
             - examples
             - legacy algoliasearch
+            - helper docs
             - e2e tests
           filters:
             branches:
@@ -136,6 +144,7 @@ jobs:
       - persist_to_workspace:
           root: *workspace_root
           paths:
+            - packages/algoliasearch-helper/dist
             - packages/instantsearch.js/es
             - packages/instantsearch.js/cjs
             - packages/instantsearch.js/dist
@@ -193,6 +202,24 @@ jobs:
           name: Type Checking
           command: yarn run type-check:v3
 
+  algoliasearch v3:
+    <<: *defaults
+    steps:
+      - checkout
+      - *attach_workspace
+      - *install_yarn_version
+      - *restore_yarn_cache
+      - *run_yarn_install
+      - run:
+          name: Install algoliasearch v3
+          command: yarn add --dev [email protected] @types/[email protected]
+      - run:
+          name: Unit & Integration tests
+          command: yarn workspace algoliasearch-helper run test --maxWorkers=4
+      - run:
+          name: Type checking
+          command: yarn workspace algoliasearch-helper tsc
+
   vue v3:
     <<: *defaults
     steps:
@@ -246,6 +273,22 @@ jobs:
           paths:
             - website/examples
 
+  helper docs:
+    <<: *defaults
+    steps:
+      - checkout
+      - *attach_workspace
+      - *install_yarn_version
+      - *restore_yarn_cache
+      - *run_yarn_install
+      - run:
+          name: Build helper documentation
+          command: yarn workspace algoliasearch-helper run doc
+      - persist_to_workspace:
+          root: *workspace_root
+          paths:
+            - website/algoliasearch-helper-js
+
   e2e tests:
     <<: *defaults
     resource_class: large

.eslintrc.js

@@ -294,7 +294,7 @@ const config = {
       },
     },
     {
-      files: ['*.js'],
+      files: ['*.js', '*.d.ts'],
       rules: {
         '@typescript-eslint/explicit-member-accessibility': 'off',
       },
@@ -390,6 +390,59 @@ const config = {
           'packages/react-instantsearch-hooks-router-nextjs/tsconfig.json',
       },
     },
+    {
+      files: ['packages/algoliasearch-helper/**/*.js'],
+      rules: {
+        // Helper uses CommonJS for now
+        'import/no-commonjs': 'off',
+        strict: 'off',
+        // Helper uses ES5 for now
+        'no-var': 'off',
+        'vars-on-top': 'off',
+        'object-shorthand': 'off',
+        'prefer-template': 'off',
+        'prefer-spread': 'off',
+        'prefer-rest-params': 'off',
+      },
+    },
+    {
+      // The only TypeScript files in the Helper package are declaration files and a test file.
+      files: [
+        'packages/algoliasearch-helper/**/*.d.ts',
+        'packages/algoliasearch-helper/test/types.ts',
+      ],
+      rules: {
+        // TypeScript declaration file
+        'no-dupe-class-members': 'off',
+        'no-new': 'off',
+        'no-warning-comments': 'off',
+        'no-shadow': 'off',
+        '@typescript-eslint/naming-convention': 'off',
+        '@typescript-eslint/method-signature-style': 'off',
+      },
+    },
+    {
+      files: ['packages/algoliasearch-helper/documentation-src/**/*.js'],
+      rules: {
+        'no-console': 'off',
+        'valid-jsdoc': 'off',
+      },
+    },
+    {
+      files: ['packages/algoliasearch-helper/test/**/*.js'],
+      rules: {
+        'no-console': 'off',
+        'jest/no-done-callback': 'off',
+        'jest/no-conditional-expect': 'off',
+      },
+      env: {
+        jest: true,
+      },
+      globals: {
+        test: true,
+        beforeAll: true,
+      },
+    },
   ],
 };
 

.gitignore

@@ -12,6 +12,7 @@ build/
 
 # Generated files
 /docs
+/website/algoliasearch-helper-js/*
 /website/examples/*
 /website/stories/*
 /website/specs/*

bundlesize.config.json

@@ -1,5 +1,13 @@
 {
   "files": [
+    {
+      "path": "packages/algoliasearch-helper/dist/algoliasearch.helper.js",
+      "maxSize": "38.5 kB"
+    },
+    {
+      "path": "packages/algoliasearch-helper/dist/algoliasearch.helper.min.js",
+      "maxSize": "12 kB"
+    },
     {
       "path": "./packages/instantsearch.js/dist/instantsearch.production.min.js",
       "maxSize": "74.50 kB"
@@ -26,11 +34,11 @@
     },
     {
       "path": "packages/react-instantsearch-hooks/dist/umd/ReactInstantSearchHooks.min.js",
-      "maxSize": "45.20 kB"
+      "maxSize": "46.25 kB"
     },
     {
       "path": "packages/react-instantsearch-hooks-web/dist/umd/ReactInstantSearchHooksDOM.min.js",
-      "maxSize": "55.50 kB"
+      "maxSize": "56 kB"
     },
     {
       "path": "packages/react-instantsearch-dom/dist/umd/ReactInstantSearchDOM.min.js",

jest.config.js

@@ -12,6 +12,7 @@ const config = {
     '<rootDir>/packages/*/dist*',
     '<rootDir>/tests/e2e/*',
     '<rootDir>/examples/',
+    '<rootDir>/packages/algoliasearch-helper',
     '<rootDir>/packages/create-instantsearch-app',
     '<rootDir>/packages/react-instantsearch-hooks-router-nextjs',
     '/__utils__/',

netlify.toml

@@ -2,7 +2,8 @@
   command=""" \
     yarn build:ci && \
     yarn website:storybook && \
-    yarn website:examples --concurrency=1
+    yarn website:examples --concurrency=1 && \
+    yarn workspace algoliasearch-helper doc
     """
   publish="website"
 

package.json

@@ -30,7 +30,7 @@
     "test:e2e:local": "wdio scripts/wdio/local.conf.js",
     "test:e2e:saucelabs": "wdio scripts/wdio/saucelabs.conf.js",
     "release": "shipjs prepare",
-    "prepare": "lerna run prepare",
+    "prepare": "lerna run prepare && patch-package",
     "prepare-vue3": "./scripts/prepare-vue3.js"
   },
   "devDependencies": {
@@ -131,6 +131,7 @@
     "jscodeshift": "0.7.0",
     "jsdom-global": "3.0.2",
     "lerna": "6.0.3",
+    "patch-package": "6.2.2",
     "places.js": "1.17.1",
     "prettier": "2.4.1",
     "prop-types": "15.6.2",