From 9f1a42f48a35bebf6d312785393a41faf6cbd18d Mon Sep 17 00:00:00 2001
From: Pierre Millot <pierre.millot@algolia.com>
Date: Fri, 19 Sep 2025 14:30:57 +0200
Subject: [PATCH] fix(snippets): remove snippets for non-existing helpers

---
 scripts/buildLanguages.ts                      |  5 +----
 specs/search/helpers/deleteObjects.yml         | 11 +++++++++++
 specs/search/helpers/generateSecuredApiKey.yml | 11 +++++++++++
 specs/search/helpers/indexExists.yml           | 11 +++++++++++
 specs/search/helpers/partialUpdateObjects.yml  | 11 +++++++++++
 specs/search/helpers/replaceAllObjects.yml     | 11 +++++++++++
 specs/search/helpers/saveObjects.yml           | 11 +++++++++++
 specs/search/helpers/waitForApiKey.yml         | 11 +++++++++++
 specs/search/helpers/waitForAppTask.yml        | 11 +++++++++++
 specs/search/helpers/waitForTask.yml           | 12 ++++++++++++
 templates/dart/snippets/method.mustache        |  1 +
 11 files changed, 102 insertions(+), 4 deletions(-)

diff --git a/scripts/buildLanguages.ts b/scripts/buildLanguages.ts
index b5e60b0621c..b7759f468b4 100644
--- a/scripts/buildLanguages.ts
+++ b/scripts/buildLanguages.ts
@@ -38,10 +38,7 @@ async function buildLanguage(language: Language, gens: Generator[], buildType: B
       await run('dotnet build --configuration Release', { cwd, language });
       break;
     case 'dart':
-      if (buildType !== 'snippets') {
-        // fix the snippets at some point
-        await run('dart pub get && dart analyze', { cwd, language });
-      }
+      await run('dart pub get && dart analyze', { cwd, language });
       break;
     case 'go':
       await run('go build -o /dev/null ./...', { cwd, language });
diff --git a/specs/search/helpers/deleteObjects.yml b/specs/search/helpers/deleteObjects.yml
index bbdb376b66e..6b20ed7d8eb 100644
--- a/specs/search/helpers/deleteObjects.yml
+++ b/specs/search/helpers/deleteObjects.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Records
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: deleteObjects
     summary: Deletes every records for the given objectIDs
     description: |
diff --git a/specs/search/helpers/generateSecuredApiKey.yml b/specs/search/helpers/generateSecuredApiKey.yml
index 97afb11b9c2..e781655ba72 100644
--- a/specs/search/helpers/generateSecuredApiKey.yml
+++ b/specs/search/helpers/generateSecuredApiKey.yml
@@ -4,6 +4,17 @@ method:
     x-asynchronous-helper: false
     tags:
       - Api Keys
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: generateSecuredApiKey
     summary: Create secured API keys
     description: |
diff --git a/specs/search/helpers/indexExists.yml b/specs/search/helpers/indexExists.yml
index 15c3d06f8f1..77efbffd07a 100644
--- a/specs/search/helpers/indexExists.yml
+++ b/specs/search/helpers/indexExists.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Index
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: indexExists
     summary: Check if an index exists or not
     description: |
diff --git a/specs/search/helpers/partialUpdateObjects.yml b/specs/search/helpers/partialUpdateObjects.yml
index a845e9467bd..4c85fe05d67 100644
--- a/specs/search/helpers/partialUpdateObjects.yml
+++ b/specs/search/helpers/partialUpdateObjects.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Records
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: partialUpdateObjects
     summary: Replaces object content of all the given objects according to their respective `objectID` field
     description: |
diff --git a/specs/search/helpers/replaceAllObjects.yml b/specs/search/helpers/replaceAllObjects.yml
index e7bf57eb5cf..f1e25ca0bd8 100644
--- a/specs/search/helpers/replaceAllObjects.yml
+++ b/specs/search/helpers/replaceAllObjects.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Records
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: replaceAllObjects
     summary: Replace all records in an index
     description: |
diff --git a/specs/search/helpers/saveObjects.yml b/specs/search/helpers/saveObjects.yml
index 18db8cd09c0..a33b27c256d 100644
--- a/specs/search/helpers/saveObjects.yml
+++ b/specs/search/helpers/saveObjects.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Records
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: saveObjects
     summary: Saves the given array of objects in the given index
     description: |
diff --git a/specs/search/helpers/waitForApiKey.yml b/specs/search/helpers/waitForApiKey.yml
index 8854fd46ac6..52b5b9dc4cc 100644
--- a/specs/search/helpers/waitForApiKey.yml
+++ b/specs/search/helpers/waitForApiKey.yml
@@ -3,6 +3,17 @@ method:
     x-helper: true
     tags:
       - Api Keys
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: waitForApiKey
     summary: Wait for an API key operation
     description: Waits for an API key to be added, updated, or deleted.
diff --git a/specs/search/helpers/waitForAppTask.yml b/specs/search/helpers/waitForAppTask.yml
index ea177c3cfce..0c904302e98 100644
--- a/specs/search/helpers/waitForAppTask.yml
+++ b/specs/search/helpers/waitForAppTask.yml
@@ -1,6 +1,17 @@
 method:
   get:
     x-helper: true
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: waitForAppTask
     summary: Wait for application-level operation to complete
     description: Wait for a application-level task to complete.
diff --git a/specs/search/helpers/waitForTask.yml b/specs/search/helpers/waitForTask.yml
index 99ef8c6d25f..aa86acfebef 100644
--- a/specs/search/helpers/waitForTask.yml
+++ b/specs/search/helpers/waitForTask.yml
@@ -3,6 +3,18 @@ method:
     x-helper: true
     tags:
       - Records
+    # it's called waitTask in dart
+    x-available-languages:
+      - csharp
+      - go
+      - java
+      - javascript
+      - kotlin
+      - php
+      - python
+      - ruby
+      - scala
+      - swift
     operationId: waitForTask
     summary: Wait for operation to complete
     description: |
diff --git a/templates/dart/snippets/method.mustache b/templates/dart/snippets/method.mustache
index bb3b6320fba..5172abcd941 100644
--- a/templates/dart/snippets/method.mustache
+++ b/templates/dart/snippets/method.mustache
@@ -1,4 +1,5 @@
 // {{generationBanner}}
+// ignore_for_file: unused_local_variable
 // >IMPORT
 {{> snippets/import}}
 // IMPORT<