Add QE prefix+suffix GA and rename API to string

XMLWordPrintableJSON

    • Type: Task
    • Resolution: Fixed
    • Priority: Major - P3
    • 3.8.0
    • Affects Version/s: None
    • Component/s: None
    • Hide

      DRIVERS-3321:
      Summary of necessary driver changes

      • Rename QE "text" APIs to "string"
        • rename TextOpts to StringOpts
        • rename "TextPreview" algorithm to "String"
        • add queryType "prefix"
        • add queryType "suffix"
        • document "prefix" and "suffix" as stable.
      • Update spec and prose tests for the new names.
      • Upgrade to libmongocrypt 1.19.1+ to support the new names.

      "substring" will be added in DRIVERS-3540 pending server changes.

      "prefixPreview" and "suffixPreview" are still experimental and planned for removal in DRIVERS-3548.

      The API renames break compatibility of experimental QE APIs. This is expected to be OK in a minor release since APIs were documented as "unstable API and subject to backwards breaking changes".

      Commits for syncing spec/prose tests

      Changelog

      • 2026-06-16: changed scope to only add "prefix" and "suffix" without dropping "prefixPreview" and "suffixPreview". Motivated by slack thread
      Show
      DRIVERS-3321 : Summary of necessary driver changes Rename QE "text" APIs to "string" rename TextOpts to StringOpts rename "TextPreview" algorithm to "String" add queryType "prefix" add queryType "suffix" document "prefix" and "suffix" as stable. Update spec and prose tests for the new names. Upgrade to libmongocrypt 1.19.1+ to support the new names. "substring" will be added in DRIVERS-3540 pending server changes. "prefixPreview" and "suffixPreview" are still experimental and planned for removal in DRIVERS-3548 . The API renames break compatibility of experimental QE APIs. This is expected to be OK in a minor release since APIs were documented as "unstable API and subject to backwards breaking changes". Commits for syncing spec/prose tests mongodb/specifications@c9b3ee made the initial change. mongodb/specifications@7a3f70 restored prefixPreview+suffixPreview. Changelog 2026-06-16: changed scope to only add "prefix" and "suffix" without dropping "prefixPreview" and "suffixPreview". Motivated by slack thread
    • None
    • Needed
    • Hide

      1. What would you like to communicate to the user about this feature?

      The prefix, suffix, and substring APIs are now GA, and no longer require the text-indexes-unstable feature to be used.  Those projects that had that feature enabled will need to adjust code slightly to continue to compile.

      2. Would you like the user to see examples of the syntax and/or executable code and its output?

      No.

      3. Which versions of the driver/connector does this apply to?

      3.8.0+

      Show
      1. What would you like to communicate to the user about this feature? The prefix, suffix, and substring APIs are now GA, and no longer require the text-indexes-unstable feature to be used.  Those projects that had that feature enabled will need to adjust code slightly to continue to compile. 2. Would you like the user to see examples of the syntax and/or executable code and its output? No. 3. Which versions of the driver/connector does this apply to? 3.8.0+
    • None
    • None
    • None
    • None
    • None
    • None

      This ticket was split from DRIVERS-3321, please see that ticket for a detailed description.

            Assignee:
            Abraham Egnor
            Reporter:
            TPM Jira Automations Bot
            None
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: