fix: assert region

Author: shortcuts

packages/algoliasearch/src/__tests__/default.test.ts

@@ -187,6 +187,13 @@ describe('default preset', () => {
       );
     });
 
+    test('throws when wrong transformation.region', () => {
+      expect(() =>
+        // @ts-ignore
+        algoliasearch('APP_ID', 'API_KEY', { transformation: { region: 'cn' } })
+      ).toThrow('`region` is required and must be one of the following: eu, us}`');
+    });
+
     test('throws when calling the transformation methods without init parameters', async () => {
       await expect(
         index.saveObjectsWithTransformation([{ objectID: 'bar', baz: 42 }], { waitForTasks: true })

packages/algoliasearch/src/ingestion.ts

@@ -13,6 +13,7 @@ import {
   IngestionClient,
   PushOptions,
   PushProps,
+  REGIONS,
   TransformationOptions,
   WatchResponse,
 } from './types';
@@ -24,6 +25,12 @@ export function createIngestionClient(
     throw new Error('`region` must be provided when leveraging the transformation pipeline');
   }
 
+  if (!REGIONS.includes(options.transformation.region)) {
+    throw new Error(
+      `\`region\` is required and must be one of the following: ${REGIONS.join(', ')}`
+    );
+  }
+
   const appId = options.appId;
 
   const auth = createAuth(AuthMode.WithinHeaders, appId, options.apiKey);

packages/algoliasearch/src/types/Ingestion.ts

@@ -7,11 +7,14 @@ import {
 } from '@algolia/client-search';
 import { RequestOptions } from '@algolia/transporter';
 
+export const REGIONS = ['eu', 'us'] as const;
+export type Region = typeof REGIONS[number];
+
 export type TransformationOptions = {
   // When provided, a second transporter will be created in order to leverage the `*WithTransformation` methods exposed by the Push connector (https://www.algolia.com/doc/guides/sending-and-managing-data/send-and-update-your-data/connectors/push/).
   readonly transformation?: {
     // The region of your Algolia application ID, used to target the correct hosts of the transformation service.
-    readonly region: 'eu' | 'us';
+    readonly region: Region;
   };
 };