Add export method feature

.code-samples.meilisearch.yaml

@@ -858,3 +858,12 @@ search_parameter_reference_media_1: |-
       }
     }
   })
+export_post_1: |-
+  client.export({
+    url: 'TARGET_INSTANCE_URL',
+    indexes: {
+      '*': {
+        overrideSettings: true
+      }
+    }
+  })

.github/workflows/meilisearch-prototype-tests.yml

@@ -44,6 +44,13 @@ jobs:
           MEILI_NO_ANALYTICS: 'true'
         ports:
           - '7700:7700'
+      export-meilisearch:
+        image: getmeili/meilisearch:${{ needs.meilisearch-version.outputs.version }}
+        env:
+          MEILI_MASTER_KEY: 'masterKey'
+          MEILI_NO_ANALYTICS: 'true'
+        ports:
+          - '7702:7700'
     strategy:
       matrix:
         node: ['20', '22']

.github/workflows/pre-release-tests.yml

@@ -41,6 +41,13 @@ jobs:
           MEILI_NO_ANALYTICS: 'true'
         ports:
           - '7700:7700'
+      export-meilisearch:
+        image: getmeili/meilisearch:${{ needs.meilisearch-version.outputs.version }}
+        env:
+          MEILI_MASTER_KEY: 'masterKey'
+          MEILI_NO_ANALYTICS: 'true'
+        ports:
+          - '7702:7700'
     strategy:
       matrix:
         node: ['20', '22']

.github/workflows/tests.yml

@@ -33,6 +33,11 @@ jobs:
           MEILI_NO_ANALYTICS: 'true'
         ports:
           - '7700:7700'
+      export-meilisearch:
+        image: getmeili/meilisearch:latest
+        env:
+          MEILI_MASTER_KEY: 'masterKey'
+          MEILI_NO_ANALYTICS: 'true'
     strategy:
       fail-fast: false
       matrix:

docker-compose.yml

@@ -20,3 +20,17 @@ services:
     environment:
       - MEILI_MASTER_KEY=masterKey
       - MEILI_NO_ANALYTICS=true
+    networks:
+      - ms-network
+
+  export-meilisearch:
+    image: getmeili/meilisearch
+    environment:
+      - MEILI_MASTER_KEY=masterKey
+      - MEILI_NO_ANALYTICS=true
+    networks:
+      - ms-network
+
+networks:
+  ms-network:
+    driver: bridge

src/meilisearch.ts

@@ -34,6 +34,7 @@ import type {
   ResultsWrapper,
   WebhookCreatePayload,
   WebhookUpdatePayload,
+  ExportOptions,
 } from "./types/index.js";
 import { ErrorStatusCode } from "./types/index.js";
 import { HttpRequests } from "./http-requests.js";
@@ -547,6 +548,15 @@ export class MeiliSearch {
     });
   }
 
+  ///
+  /// EXPORT
+  ///
+
+  /** {@link https://www.meilisearch.com/docs/reference/api/export} */
+  export(options: ExportOptions): EnqueuedTaskPromise {
+    return this.#httpRequestsWithTask.post({ path: "export", body: options });
+  }
+
   ///
   /// EXPERIMENTAL-FEATURES
   ///

src/types/export.ts

@@ -0,0 +1,30 @@
+import type { Filter } from "./types.js";
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/export#indexes}
+ *
+ * @see `meilisearch::routes::export::ExportIndexSettings`
+ */
+export type ExportIndexSettings = {
+  filter?: Filter;
+  overrideSettings?: boolean;
+};
+
+/** {@link https://www.meilisearch.com/docs/reference/api/export#indexes} */
+export type ExportIndexSettingsRecord = Record<string, ExportIndexSettings>;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/export#body}
+ *
+ * @see `meilisearch::routes::export::Export`
+ */
+export type ExportOptions = {
+  /** {@link https://www.meilisearch.com/docs/reference/api/export#url} */
+  url: string;
+  /** {@link https://www.meilisearch.com/docs/reference/api/export#apikey} */
+  apiKey?: string;
+  /** {@link https://www.meilisearch.com/docs/reference/api/export#payloadsize} */
+  payloadSize?: string;
+  /** {@link https://www.meilisearch.com/docs/reference/api/export#indexes} */
+  indexes?: ExportIndexSettingsRecord;
+};

src/types/index.ts

@@ -1,4 +1,5 @@
 export * from "./experimental-features.js";
+export * from "./export.js";
 export * from "./task_and_batch.js";
 export * from "./token.js";
 export * from "./types.js";

src/types/task_and_batch.ts

@@ -52,6 +52,7 @@ export type TaskType = PascalToCamelCase<
   | "TaskDeletion"
   | "DumpCreation"
   | "SnapshotCreation"
+  | "Export"
   | "UpgradeDatabase"
 >;
 

tests/export.test.ts

@@ -0,0 +1,40 @@
+import { randomUUID } from "node:crypto";
+import { afterAll, beforeAll, test } from "vitest";
+import { assert, getClient } from "./utils/meilisearch-test-utils.js";
+
+const INDEX_UID = randomUUID();
+const ms = await getClient("Master");
+
+beforeAll(async () => {
+  const task = await ms.createIndex(INDEX_UID).waitTask();
+  assert.isTaskSuccessful(task);
+
+  const idx = ms.index(INDEX_UID);
+
+  const task2 = await idx.updateFilterableAttributes(["beep"]).waitTask();
+  assert.isTaskSuccessful(task2);
+
+  const task3 = await idx.addDocuments([{ id: 0, beep: "boop" }]).waitTask();
+  assert.isTaskSuccessful(task3);
+});
+
+afterAll(async () => {
+  const task = await ms.deleteIndex(INDEX_UID).waitTask();
+  assert.isTaskSuccessful(task);
+});
+
+test(`${ms.export.name} method`, async () => {
+  const task = await ms
+    .export({
+      url: "http://export-meilisearch:7700",
+      apiKey: "masterKey",
+      payloadSize: "50MiB",
+      indexes: {
+        [INDEX_UID]: { filter: "beep = boop", overrideSettings: true },
+      },
+    })
+    .waitTask({ timeout: 60_000 });
+
+  assert.isTaskSuccessful(task);
+  assert.strictEqual(task.type, "export");
+});

tests/utils/meilisearch-test-utils.ts

@@ -155,7 +155,7 @@
   },
   isTask(task: Task) {
     const { length } = Object.keys(task);
-    vitestAssert(length >= 11 && length <= 12);
+    vitestAssert(length >= 11 && length <= 13);
     const {
       indexUid,
       status,
@@ -199,6 +199,7 @@
         taskDeletion: null,
         dumpCreation: null,
         snapshotCreation: null,
+        export: null,
         upgradeDatabase: null,
       }),
     );
@@ -224,7 +225,7 @@
   },
   isTaskSuccessful(task: Task) {
     this.isTask(task);
     vitestAssert.isNull(task.error);
     vitestAssert.strictEqual(task.status, "succeeded");
   },
 };

tests/utils/tasks-and-batches.ts

@@ -29,6 +29,7 @@ export const possibleTaskTypes = objectKeys<TaskType>({
   taskDeletion: null,
   dumpCreation: null,
   snapshotCreation: null,
+  export: null,
   upgradeDatabase: null,
 });