@algolia/wizard 0.8.0-rc.64.51 → 0.8.0-rc.65.53

package/dist/main.js

@@ -2206,6 +2206,7 @@ function shellQuote(value) {
 // src/lib/languages.ts
 var ENTRYPOINT_TOKEN = "{entrypoint}";
 var INGEST_DIR = ".algolia-wizard";
+var CSHARP_PROJECT = `${INGEST_DIR}/ingest/ingest.csproj`;
 var VISIBLE_INGEST_DIR = "algolia-wizard";
 var PY_VENV = `${INGEST_DIR}/.venv`;
 var PY_VENV_PYTHON = `${PY_VENV}/bin/python`;
@@ -2578,6 +2579,44 @@ var LANGUAGE_PROFILES = {
     // that some repos use it for source; scanning it is cheap, missing source
     // is not.
     skipDirs: ["target"]
+  },
+  csharp: {
+    id: "csharp",
+    displayName: "C#",
+    aliases: ["c#", "csharp", "cs", ".net", "dotnet", "net", "asp.net"],
+    manifests: ["*.csproj", "*.sln", "global.json"],
+    packageManagers: [
+      {
+        id: "dotnet",
+        // A self-contained project under .algolia-wizard keeps the ingest script
+        // out of the repo's own build graph.
+        dependency: { mode: "agent-declares", file: CSHARP_PROJECT },
+        installSteps: [{ argv: ["dotnet", "restore", CSHARP_PROJECT] }],
+        ingest: {
+          kind: "auto",
+          argv: ["dotnet", "run", "--project", ENTRYPOINT_TOKEN],
+          entrypointExtensions: [".csproj"]
+        }
+      }
+    ],
+    sdk: {
+      packageName: "Algolia.Search",
+      versionPin: "7.*",
+      docKey: "csharp"
+    },
+    ingestEntrypointExample: CSHARP_PROJECT,
+    verification: [
+      {
+        label: "dotnet build",
+        argv: ["dotnet", "build", CSHARP_PROJECT, "--nologo"],
+        requiresFile: CSHARP_PROJECT
+      }
+    ],
+    envReadInstruction: 'Read them from `Environment.GetEnvironmentVariable("NAME")`.',
+    // Deliberately not `packages`: modern .NET uses PackageReference, and
+    // `packages/` is where pnpm/Lerna/Turborepo monorepos keep all their source —
+    // skipping it would hide the entities the scan is looking for.
+    skipDirs: ["bin", "obj"]
   }
 };
 var DEFAULT_LANGUAGE_ID = "javascript";
@@ -3260,7 +3299,7 @@ var detectLanguageSchema = z16.object({
 var detectLanguage = () => runAgent({
   instructions: [
     "Analyze the codebase and determine the programming languages and frameworks used",
-    "Start from the dependency manifests: package.json, pyproject.toml, requirements.txt, Gemfile, composer.json, go.mod, pom.xml, build.gradle(.kts), build.sbt.",
+    "Start from the dependency manifests: package.json, pyproject.toml, requirements.txt, Gemfile, composer.json, go.mod, pom.xml, build.gradle(.kts), *.csproj, build.sbt.",
     "List the language that owns the backend/data code first \u2014 that is the one an ingestion script will be written in.",
     "If a superset language is found, exclude the subset language. TS-over-JS. Kotlin-over-Java when Kotlin is primary.",
     "If a meta-framework is used, exclude the framework. Next-over-React.",
@@ -3313,7 +3352,7 @@ var MODE_CONFIG = {
       "Analyze the codebase to find the data entities (models) that should be ingested into Algolia.",
       "For each entity, return its name, the file path(s) where it is defined, and its indexable attribute keys (the fields a user would search or filter on).",
       "Inspect the source of each entity to extract real field names for attributes \u2014 do not guess or leave attributes empty.",
-      "Entities live wherever the stack keeps them: TypeScript interfaces or a Prisma schema, Django models.py, Rails app/models, Laravel Eloquent models, JPA @Entity classes, Go structs, Pydantic models.",
+      "Entities live wherever the stack keeps them: TypeScript interfaces or a Prisma schema, Django models.py, Rails app/models, Laravel Eloquent models, JPA @Entity classes, Go structs, C# entity classes, Pydantic models.",
       "Prefer domain models (e.g. Document, Product, User) over framework or infrastructure types.",
       "Use as few tools as possible, but do not guess. If you cannot find any entities, return an empty array.",
       "Ignore directories that may be related to testing, like `/fixtures`, `/tests`, etc",
@@ -3336,7 +3375,7 @@ var MODE_CONFIG = {
   verification: {
     instructions: [
       "Analyze the codebase to determine which code-quality tools are available to validate changes.",
-      "Look at the dependency manifest and config files for the project's languages: package.json scripts with tsconfig/eslint/prettier, pyproject.toml or setup.cfg (ruff, mypy, black), Gemfile with .rubocop.yml, composer.json scripts (phpstan, pint), go.mod with a golangci-lint config, Maven/Gradle verification tasks.",
+      "Look at the dependency manifest and config files for the project's languages: package.json scripts with tsconfig/eslint/prettier, pyproject.toml or setup.cfg (ruff, mypy, black), Gemfile with .rubocop.yml, composer.json scripts (phpstan, pint), go.mod with a golangci-lint config, Maven/Gradle verification tasks, .NET analyzers.",
       'Return the tool names as an array, e.g. ["eslint", "prettier", "tsc"] or ["ruff", "mypy"].',
       "Use as few tools as possible, but do not guess. If you cannot find any, return an empty array.",
       "Ignore directories that may be related to testing, like `/fixtures`, `/tests`, etc",
@@ -3364,7 +3403,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.8.0-rc.64.51",
+  version: "0.8.0-rc.65.53",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {

package/docs/algolia-sdk/README.md

@@ -23,6 +23,7 @@ Install the latest stable within the major; never pin an exact patch.
 | Java | `com.algolia:algoliasearch` | `4.+` |
 | Kotlin | `com.algolia:algoliasearch-client-kotlin` | `3.+` |
 | Scala | `com.algolia:algoliasearch-scala_2.13` | `2.+` |
+| C# | `Algolia.Search` | `7.*` |
 
 ## Search UI
 

package/docs/algolia-sdk/save-records-csharp.md

@@ -0,0 +1,71 @@
+# Save records (Algolia.Search v7)
+
+Adds records to an index. Write op — use a **write key**, server-side only.
+
+The generated script is a self-contained console project at
+`.algolia-wizard/ingest/ingest.csproj` + `Program.cs`, run with
+`dotnet run --project .algolia-wizard/ingest/ingest.csproj`.
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Algolia.Search" Version="7.*" />
+  </ItemGroup>
+</Project>
+```
+
+`<OutputType>Exe</OutputType>` is required — `dotnet run` on a library has no entry
+point. `<TargetFramework>` must match an installed SDK; `net8.0` (LTS) is the safe
+default. Under Central Package Management (`Directory.Packages.props` at the repo
+root) omit `Version` here and pin it there — `Version` on a `PackageReference` is
+an error under CPM (NU1008).
+
+```csharp
+using System.Text.Json;
+using Algolia.Search.Clients;
+
+var appId = Environment.GetEnvironmentVariable("ALGOLIA_APPLICATION_ID")
+    ?? throw new InvalidOperationException("ALGOLIA_APPLICATION_ID is not set");
+var writeKey = Environment.GetEnvironmentVariable("ALGOLIA_WRITE_API_KEY")
+    ?? throw new InvalidOperationException("ALGOLIA_WRITE_API_KEY is not set");
+
+var client = new SearchClient(new SearchConfig(appId, writeKey));
+var indexName = "products";
+
+var records = new List<Dictionary<string, object>>
+{
+    new() { ["objectID"] = "1", ["name"] = "Adam" },
+    new() { ["objectID"] = "2", ["name"] = "Benoit" },
+};
+
+var responses = await client.SaveObjectsAsync(indexName, records, waitForTasks: true);
+```
+
+```csharp
+Task<List<BatchResponse>> SaveObjectsAsync<T>(
+  string indexName, IEnumerable<T> objects, bool waitForTasks = false,
+  int batchSize = 1000, RequestOptions options = null,
+  CancellationToken cancellationToken = default) where T : class;
+```
+
+Records need an `objectID`; batching in 1,000s is automatic. Returns
+`List<BatchResponse>` — one entry per batch, each `{ TaskID, ObjectIDs }`, never a
+single response. `T` is constrained to `class`, so use `Dictionary<string, object>`
+or a record/class, never a struct.
+
+Read records from a JSON file:
+
+```csharp
+var json = await File.ReadAllTextAsync("records.json");
+var records = JsonSerializer.Deserialize<List<Dictionary<string, object>>>(json)
+    ?? new List<Dictionary<string, object>>();
+```
+
+After a successful ingest, print `ALGOLIA_WIZARD_RECORD_COUNT=<n>` as the last
+stdout line; send all other logging to stderr so nothing follows it on stdout.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.8.0-rc.64.51",
+  "version": "0.8.0-rc.65.53",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {