DOCSP-36298 : Refactor RQL for JSv12 (#3266)

## Pull Request Info - SDK Docs Consolidation

Jira ticket: https://jira.mongodb.org/browse/DOCSP-3629
- Ports legacy RQL models and tests to v12 test suite
- Generates updated snippets from v12 `.ts` test file

Jira ticket: https://jira.mongodb.org/browse/DOCSP-36618
- Updates Realm Query Language page: 
  - Add language selector
  - Reference new v12 snippets
  - Reorganize sections  

Jira ticket: https://jira.mongodb.org/browse/DOCSP-36265
- Update to indicate support for comparison operators on strings
(expanded lexicographical querying)
- Add example

*Staged Page*

- [Realm Query
Language](https://preview-mongodbcbullinger.gatsbyjs.io/realm/docsp-36298-rql/sdk/crud/query-engines/realm-query-language/)

*Page Source*

- [Realm Query
Language](https://www.mongodb.com/docs/atlas/device-sdks/realm-query-language)

### PR Author Checklist

Before requesting a review for your PR, please check these items:

- [x] Open the PR against the `feature-consolidated-sdk-docs` branch
instead of `master`
- [x] Tag the consolidated page for:
  - genre
  - meta.keywords
  - meta.description

#### Naming
- [x] Update Realm naming and the language around persistence
layer/local/device per [this
document](https://docs.google.com/document/d/126OczVxBWAwZ4P5ZsSM29WI3REvONEr1ald-mAwPtyQ/edit?usp=sharing)
- [x] Include `.rst` files comply with [the naming
guidelines](https://docs.google.com/document/d/1h8cr66zoEVeXytVfvDxlCSsUS5IZwvUQvfSCEXNMpek/edit#heading=h.ulh8b5f2hu9)

#### Links and Refs
- [x] Create new consolidated SDK ref targets starting with "_sdks-" for
relevant sections
- [x] Remove or update any SDK-specific refs to use the new consolidated
SDK ref targets
- N/A ~[ ] [Update any Kotlin API
links](https://jira.mongodb.org/browse/DOCSP-32519) to use the new
Kotlin SDK roles~

#### Content
- [x] Shared code boxes have snippets or placeholders for all 9
languages
> NOTE: Omitted Swift and Objective-C from page
- N/A ~[ ] API description sections have API details or a generic
placeholder for all 9 languages~
- [x] Check related pages for relevant content to include
- [x] Create a ticket for missing examples in each relevant SDK:
Consolidation Gaps epic

### Reviewer Checklist

As a reviewer, please check these items:

- [ ] Shared code example boxes contain language-specific snippets or
placeholders for every language
- [ ] API reference details contain working API reference links or
generic content
- [ ] Realm naming/language has been updated
- [ ] All relevant content from individual SDK pages is present on the
consolidated page

Author: cbullinger

examples/node/legacy/Examples/realm-query-language.js

@@ -1,9 +1,12 @@
 import Realm, { BSON } from "realm";
 import { ItemModel, ProjectModel } from "./schemas/rql-data-models";
 
-// Tests for new RQL operators or updates should be placed in the new 
-// file compatible with JSv12 and later, located at 
-// examples/node/v12/__tests__/realm-query-language.test.js
+/*
+  DON'T UPDATE THIS FILE. DEPRECATED IN FAVOR OF V12 TESTS.
+  Tests for new RQL operators or updates should be placed in the new
+  files compatible with JSv12 and later, located at:
+  examples/node/v12/__tests__/realm-query-language.test.js/ts
+*/
 
 describe("Realm Query Language Reference", () => {
   let realm;
@@ -148,7 +151,7 @@ describe("Realm Query Language Reference", () => {
     const progressMinutesRange = items.filtered(
       // :remove-end:
 
-      // Find to-do items within a certain time range by finding items 
+      // Find to-do items within a certain time range by finding items
       // where the progressMinutes property is between two numbers.
       "progressMinutes BETWEEN { $0 , $1 }", 30, 60
       // :remove-start:
@@ -406,7 +409,7 @@ describe("Realm Query Language Reference", () => {
       );
       expect(shallowResultLinkingObjects.length).toBe(1);
       expect(shallowResultLinkingObjects[0].name).toBe("Get coffee");
-      
+
       const shallowResultAtLinks = realm.objects("Item").filtered(
         // :remove-end:
         // Find items that are not referenced by any project

examples/node/legacy/Examples/rql-data-models.js

@@ -1,6 +1,13 @@
 import Realm from "realm";
 import { ItemModel, ProjectModel } from "./schemas/rql-data-models";
 
+/*
+  DON'T UPDATE THIS FILE. DEPRECATED IN FAVOR OF V12 TESTS.
+  Updates should be placed in the new files compatible with
+  JSv12 and later, located at:
+  examples/node/v12/__tests__/rql-data-models.test.js/ts
+*/
+
 describe("test models", () => {
   let realm;
   const config = {

examples/node/legacy/Examples/schemas/rql-data-models.js

@@ -1,3 +1,9 @@
+/*
+  DON'T UPDATE THIS FILE. DEPRECATED IN FAVOR OF V12 MODELS.
+  Updates should be placed in the new file compatible with
+  JSv12 and later, located at:
+  examples/node/v12/__tests__/models/rql-data-models.ts
+*/
 // :snippet-start: rql-data-models
 const ItemModel = {
   name: "Item",

examples/node/v12/__tests__/models/rql-data-models.js

@@ -0,0 +1,54 @@
+// Models for embedded objects & dot notation queries
+const Address = {
+  name: "Address",
+  embedded: true,
+  properties: {
+    name: "string",
+    street: "string",
+    zipcode: "int",
+  },
+};
+
+const Office = {
+  name: "Office",
+  properties: {
+    name: "string",
+    address: "Address",
+  },
+};
+
+// :snippet-start: rql-data-models
+const Item = {
+  name: "Item",
+  properties: {
+    _id: "objectId",
+    name: { type: "string", indexed: "full-text" },
+    isComplete: { type: "bool", default: false },
+    assignee: "string?",
+    priority: { type: "int", default: 0 },
+    progressMinutes: { type: "int", default: 0 },
+    projects: {
+      type: "linkingObjects",
+      objectType: "Project",
+      property: "items",
+    },
+  },
+  primaryKey: "_id",
+};
+
+const Project = {
+  name: "Project",
+  properties: {
+    _id: "objectId",
+    name: "string",
+    items: "Item[]",
+    quota: "int?",
+    comments: "string?{}",
+    projectLocation: "Office?",
+    additionalInfo: "mixed",
+  },
+  primaryKey: "_id",
+};
+// :snippet-end:
+
+export { Address, Item, Office, Project };

examples/node/v12/__tests__/models/rql-data-models.ts

@@ -1,5 +1,36 @@
 import Realm, { BSON, ObjectSchema } from "realm";
 
+// Models for embedded objects & dot notation queries
+export class Address extends Realm.Object<Address> {
+  name!: string;
+  street!: string;
+  zipcode!: number;
+
+  static schema: ObjectSchema = {
+    name: "Address",
+    embedded: true,
+    properties: {
+      name: "string",
+      street: "string",
+      zipcode: "int",
+    },
+  };
+}
+
+export class Office extends Realm.Object<Office> {
+  name!: string;
+  address!: Address;
+
+  static schema: ObjectSchema = {
+    name: "Office",
+    properties: {
+      name: "string",
+      address: "Address",
+    },
+  };
+}
+
+// :snippet-start: rql-data-models
 export class Item extends Realm.Object<Item> {
   _id!: BSON.ObjectId;
   name!: string;
@@ -12,17 +43,11 @@ export class Item extends Realm.Object<Item> {
     name: "Item",
     properties: {
       _id: "objectId",
-      name: { type:"string", indexed: "full-text" },
+      name: { type: "string", indexed: "full-text" },
       isComplete: { type: "bool", default: false },
       assignee: "string?",
-      priority: {
-        type: "int",
-        default: 0,
-      },
-      progressMinutes: {
-        type: "int",
-        default: 0,
-      },
+      priority: { type: "int", default: 0 },
+      progressMinutes: { type: "int", default: 0 },
       projects: {
         type: "linkingObjects",
         objectType: "Project",
@@ -32,12 +57,14 @@ export class Item extends Realm.Object<Item> {
     primaryKey: "_id",
   };
 }
-
 export class Project extends Realm.Object<Project> {
   _id!: BSON.ObjectId;
   name!: string;
-  items!: Realm.List<Item>
-  quota?: number
+  items!: Realm.List<Item>;
+  quota?: number;
+  comments?: Realm.Dictionary<string>;
+  projectLocation?: Office;
+  additionalInfo!: Realm.Mixed;
 
   static schema: ObjectSchema = {
     name: "Project",
@@ -46,7 +73,11 @@ export class Project extends Realm.Object<Project> {
       name: "string",
       items: "Item[]",
       quota: "int?",
+      comments: "string?{}",
+      projectLocation: "Office?",
+      additionalInfo: "mixed",
     },
     primaryKey: "_id",
-  }
-};
+  };
+}
+// :snippet-end: