[andy-stark-redis]

Summary

DOC-7267 item 5. 383 core-command entries in nredisstack_async were exact copies of the sync entry, so the Async tab showed StringAppend returning long instead of StringAppendAsync returning Task<long>. Each now has the ...Async name and the real return type from the released interfaces.

The diff is 383 entries changing signature and returns.type, plus the regenerated data/command-api-mapping.json. Parameters and descriptions are unchanged because the async methods take the same parameters. No other client or field changed.

How to review

• A reflection probe over IDatabaseAsync, IServer, ISubscriber, IRedisAsync and IConnectionMultiplexer found every rewritten entry's method by name, parameter names and parameter types, on StackExchange.Redis 3.3.1 and 3.4.31 with identical results. All 383 resolve on IDatabaseAsync.
• The apply script only touched entries that were identical to a sync entry and had an exact match, and it refused files that don't round-trip through json.dumps(indent=2).
• The merged file equals the per-command data, and its only semantic change is those 383 entries.
• Return types: 380 are Task<T> or Task. Three (HSCAN, SSCAN, ZSCAN, the 6-parameter overload) return IAsyncEnumerable<T> directly, which is what the interface declares.
• Format: no return prefix in signature, Task<T> in returns.type. That matches the sync core entries and 54 of the existing core async entries. 67 existing core async entries carry a prefix (Task SaveAsync(...)); I left them alone.

Left for the rest of DOC-7267

18 of the 401 copies are not rewritten because the data itself is wrong, not only the copy:

• 11 sync entries across GET, HINCRBYFLOAT, INCR, INCRBY, INCRBYFLOAT, ZINCRBY and ZREM are expression text such as StringIncrement(key, -value, flags) with a return type of return.
• GETRANGE and SUBSTR carry a sorted-set helper signature (GetRange(double value, Exclude exclude, bool isStart)).
• HSCAN, SSCAN and ZSCAN index 0 are 4-parameter overloads with no async twin (index 1 is the real one).
• KEYS lacks the database parameter that IServer.KeysAsync takes, and SCAN has no ScanAsync.

Separately, 31 commands have an nredisstack_sync entry but no nredisstack_async key at all: 23 JSON.* commands, BLMPOP, BLPOP, BRPOP, BRPOPLPUSH, BZMPOP, BZPOPMAX, BZPOPMIN and SHUTDOWN. The DOC-7263 sweep looked only at empty lists, so it did not see them.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only metadata in JSON mapping files; no runtime or Redis behavior changes.

Overview
Fixes 383 nredisstack_async entries in per-command mapping JSON that had been duplicated from sync: method signatures now use the real …Async names (e.g. StringGetAsync, HashSetAsync) and return types use Task<T>, Task, or IAsyncEnumerable<T> where the StackExchange.Redis async interfaces do (notably HashScanAsync → IAsyncEnumerable<HashEntry>).

Only the async client slice changes; parameters, descriptions, sync mappings, and other languages are untouched. The merged command-api-mapping.json is regenerated from these files so docs/async tabs show callable async APIs instead of sync-looking names.

^{Reviewed by Cursor Bugbot for commit b1cb176. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

DOC-7267

[github-actions]

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

• Commit — DOC-7267 Give NRedisStack async entries their Async method names and Task returns 🆕

  DOC-7267 Give NRedisStack async entries their Async method names and Task returns

• PR — DOC-7263 Fill missing client signatures in the command-API mapping 🆕

  Summary

• PR — DOC-6968 Complete cmds_generic, and make C examples able to fail 🆕

  DOC-6968 — the four SCAN steps for seven clients

• Commit — DOC-6968 Add the four SCAN steps to seven cmds_generic client examples 🆕

  DOC-6968 Add the four SCAN steps to seven cmds_generic client examples

• PR — DOC-7170 Add compare-and-swap/compare-and-delete example to the strings page 🆕

  Adds a compare-and-swap / compare-and-delete example (Redis 8.4 SET ... IFEQ and DELEX ... IFEQ) to the strings data type page, and refr

Memory updated at b1cb176