Remove "preview" from QE prefix+suffix, and rename "text" to "string"

XMLWordPrintableJSON

    • Hide

      DRIVERS-3321:
      Summary of necessary driver changes

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

      "substringPreview" remains experimental API and is pending. If decided as GA, "substringPreview" will be renamed to "substring" as part of DRIVERS-3540.

      This is expected 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

      Show
      DRIVERS-3321 : Summary of necessary driver changes Rename QE "text" APIs to "string" and document as stable rename TextOpts to StringOpts replace "prefixPreview" queryType with "prefix" replace "suffixPreview" queryType with "suffix" replace "TextPreview" algorithm with "String" Update spec and prose tests for the new names. Upgrade to libmongocrypt 1.19.0+ to support the new names. "substringPreview" remains experimental API and is pending. If decided as GA, "substringPreview" will be renamed to "substring" as part of DRIVERS-3540 . This is expected 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 https://github.com/mongodb/specifications/commit/c9b3ee0af76537b37a1a95e8025811f0337e468c
    • Needed
    • None
    • Hide

      1. What would you like to communicate to the user about this feature?
      2. Would you like the user to see examples of the syntax and/or executable code and its output?
      3. Which versions of the driver/connector does this apply to?

      Show
      1. What would you like to communicate to the user about this feature? 2. Would you like the user to see examples of the syntax and/or executable code and its output? 3. Which versions of the driver/connector does this apply to?
    • None
    • None
    • None
    • None
    • None
    • None

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

       


      Summary

      Support Queryable Encryption (QE) text indexes with prefix and suffix query types as Generally Available features in the Node.js driver.

      Background

      The Node.js driver currently supports QE text indexes (prefix, suffix, substring) as preview/experimental features (released in v6.19 via NODE-6911). These preview features use TextPreview as the algorithm name and prefixPreview/suffixPreview as query types.

      Server 9.0 will promote prefix and suffix query types to Generally Available (GA), deprecating the preview variants. The Node.js driver must be updated to support the GA naming conventions while maintaining backward compatibility requirements.

      This work is part of the broader SPM-4539: Queryable Encryption Prefix/Suffix GA Improvements initiative documented in the Queryable Encryption Initiative Plan (section 3.24).

      Acceptance Criteria

      See DRIVERS-3321

       

            Assignee:
            Unassigned
            Reporter:
            TPM Jira Automations Bot
            None
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated: