@nymphjs/nymph 1.0.0-beta.1 → 1.0.0-beta.100

package/src/driver/testArtifacts.ts

@@ -1,18 +1,29 @@
-import fs from 'fs';
-import strtotime from 'locutus/php/datetime/strtotime';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import strtotime from 'locutus/php/datetime/strtotime.js';
 import { guid } from '@nymphjs/guid';
 
-import type Nymph from '../Nymph';
-import { TestBModel, TestModel, TestModelData } from '../testArtifacts';
+import type Nymph from '../Nymph.js';
+import { EntityUniqueConstraintError } from '../errors/index.js';
+import {
+  TestBModel as TestBModelClass,
+  TestModel as TestModelClass,
+  TestModelData,
+  TestEmptyModel as TestEmptyModelClass,
+} from '../testArtifacts.js';
 
-export function QueriesTest(
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export function EntitiesTest(
   nymph: Nymph,
-  it: (name: string, fn: () => void) => void
+  it: (name: string, fn: () => void) => void,
 ) {
-  nymph.addEntityClass(TestModel);
-  nymph.addEntityClass(TestBModel);
+  const TestModel = nymph.addEntityClass(TestModelClass);
+  const TestBModel = nymph.addEntityClass(TestBModelClass);
+  const TestEmptyModel = nymph.addEntityClass(TestEmptyModelClass);
 
-  let testEntity: TestModel & TestModelData;
+  let testEntity: TestModelClass & TestModelData;
   let testGuid: string;
   let refGuid: string;
   let createdMultiple = false;
@@ -30,12 +41,16 @@ export function QueriesTest(
     testEntity.name = 'Entity Test ' + new Date().toLocaleString();
     testEntity.null = null;
     testEntity.string = 'test';
-    testEntity.array = ['full', 'of', 'values', 500];
-    testEntity.match = `Hello, my name is Edward McCheese. It is a pleasure to meet you. As you can see, I have several hats of the most pleasant nature.
-
-This one's email address is nice_hat-wednesday+newyork@im-a-hat.hat.
-This one's phone number is (555) 555-1818.
-This one's zip code is 92064.`;
+    testEntity.array = [
+      'full',
+      'of',
+      'values',
+      500,
+      { test: true },
+      { nullbyte: '\\\x00\u0000  \x00' },
+    ];
+    testEntity.match = matchValue;
+    testEntity.search = searchValue;
     testEntity.number = 30;
     testEntity.numberString = '30';
     testEntity.timestamp = Date.now();
@@ -43,7 +58,7 @@ This one's zip code is 92064.`;
     expect(testEntity.guid).not.toBeNull();
     testGuid = testEntity.guid as string;
 
-    const entityReferenceTest: TestModel & TestModelData = new TestModel();
+    const entityReferenceTest: TestModelClass & TestModelData = new TestModel();
     entityReferenceTest.string = 'wrong';
     entityReferenceTest.timestamp = strtotime('-2 days') * 1000;
     expect(await entityReferenceTest.$save()).toEqual(true);
@@ -55,19 +70,11 @@ This one's zip code is 92064.`;
     entityReferenceTest.test = 'good';
     expect(await entityReferenceTest.$save()).toEqual(true);
 
-    // Test synchronous getEntity.
-    testEntity = nymph.driver.getEntitySync(
-      { class: TestModel },
-      testGuid
-    ) as TestModel & TestModelData;
-    expect(testEntity).toBeInstanceOf(TestModel);
-    expect(testEntity.guid).toEqual(testGuid);
-
     // Test asynchronous getEntity.
     testEntity = (await nymph.getEntity(
       { class: TestModel },
-      testGuid
-    )) as TestModel & TestModelData;
+      testGuid,
+    )) as TestModelClass & TestModelData;
     expect(testEntity).toBeInstanceOf(TestModel);
     expect(testEntity.guid).toEqual(testGuid);
   }
@@ -80,6 +87,8 @@ This one's zip code is 92064.`;
       for (let i = 0; i < 100; i++) {
         const testEntity = await TestModel.factory();
         testEntity.name = `Multi Test ${i}`;
+        // Reverse the number for sort testing.
+        testEntity.number = 100 - i;
         testEntity.$removeTag('test');
         testEntity.$addTag('multiTest');
         expect(await testEntity.$save()).toEqual(true);
@@ -90,20 +99,36 @@ This one's zip code is 92064.`;
   }
 
   it('delete old test data', async () => {
-    let all = await nymph.getEntities({ class: TestModel });
-    expect(Array.isArray(all)).toEqual(true);
-    for (const cur of all) {
+    let amodels = await nymph.getEntities({ class: TestModel });
+    expect(Array.isArray(amodels)).toEqual(true);
+    for (const cur of amodels) {
       expect(await cur.$delete()).toEqual(true);
     }
 
-    all = await nymph.getEntities({ class: TestModel });
-    expect(all.length).toEqual(0);
+    amodels = await nymph.getEntities({ class: TestModel });
+    expect(amodels.length).toEqual(0);
+
+    let bmodels = await nymph.getEntities({ class: TestBModel });
+    expect(Array.isArray(bmodels)).toEqual(true);
+    for (const cur of bmodels) {
+      expect(await cur.$delete()).toEqual(true);
+    }
+
+    bmodels = await nymph.getEntities({ class: TestBModel });
+    expect(bmodels.length).toEqual(0);
   });
 
   it('create entity', async () => {
     await createTestEntities();
   });
 
+  it("doesn't create empty entity", async () => {
+    const testEntity = await TestEmptyModel.factory();
+
+    expect(await testEntity.$save()).toBeFalsy();
+    expect(testEntity.guid).toBeNull();
+  });
+
   it('update mdate on save', async () => {
     await createTestEntities();
 
@@ -135,6 +160,35 @@ This one's zip code is 92064.`;
     expect(testEntity.$is(resultEntity)).toEqual(false);
   });
 
+  it('guaranteed guid', async () => {
+    // Creating entity...
+    const testEntity = await TestModel.factory();
+
+    // Saving entity...
+    testEntity.name = 'Entity Test ' + new Date().toLocaleString();
+    testEntity.null = null;
+    testEntity.string = 'test';
+    testEntity.array = [];
+    testEntity.match = matchValue;
+    testEntity.number = 30;
+    testEntity.numberString = '30';
+    testEntity.timestamp = Date.now();
+
+    // Get the guaranteed GUID.
+    const testGuid = testEntity.$getGuaranteedGUID();
+
+    expect(await testEntity.$save()).toEqual(true);
+    expect(testEntity.guid).not.toBeNull();
+    expect(testEntity.guid).toEqual(testGuid);
+
+    // Retrieving entity by GUID...
+    let resultEntity = await nymph.getEntity({ class: TestModel }, testGuid);
+    expect(testEntity.$is(resultEntity)).toEqual(true);
+
+    // Delete the entity.
+    expect(await testEntity.$delete()).toEqual(true);
+  });
+
   it('transactions', async () => {
     await createTestEntities();
 
@@ -146,7 +200,7 @@ This one's zip code is 92064.`;
 
     if (!(await transaction.inTransaction())) {
       console.log(
-        'This Nymph driver or database seems to not support transactions. Skipping transaction tests.'
+        'This Nymph driver or database seems to not support transactions. Skipping transaction tests.',
       );
       await transaction.rollback('test');
       return;
@@ -177,7 +231,7 @@ This one's zip code is 92064.`;
     expect(await testEntity.$delete()).toEqual(true);
     const resultEntity = await transaction.getEntity(
       { class: TestModel },
-      testGuid
+      testGuid,
     );
     expect(resultEntity).toBeNull();
 
@@ -190,13 +244,13 @@ This one's zip code is 92064.`;
     // Verify it's back.
     testEntity = (await transaction.getEntity(
       { class: TestModel },
-      testGuid
-    )) as TestModel & TestModelData;
+      testGuid,
+    )) as TestModelClass & TestModelData;
 
     expect(testEntity.guid).toEqual(testGuid);
 
-    // Start a new transaction.
-    transaction = await nymph.startTransaction('test');
+    // Start a new transaction with a dot in the name.
+    transaction = await nymph.startTransaction('test.1');
     testEntity.$nymph = transaction;
 
     // Verify in a transaction.
@@ -207,7 +261,7 @@ This one's zip code is 92064.`;
     expect(await testEntity.$save()).toEqual(true);
 
     // Commit the transaction.
-    await transaction.commit('test');
+    await transaction.commit('test.1');
     testEntity.$nymph = nymph;
 
     // Verify not in a transaction.
@@ -236,7 +290,7 @@ This one's zip code is 92064.`;
         limit: 1,
         sort: 'cdate',
       },
-      { type: '&', tag: 'test' }
+      { type: '&', tag: 'test' },
     );
     expect(resultEntities.length).toEqual(1);
     expect(testEntity.$is(resultEntities[0])).toEqual(true);
@@ -248,7 +302,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by GUID and tags...
     const resultEntity = await nymph.getEntity(
       { class: TestModel },
-      { type: '&', guid: testGuid, tag: 'test' }
+      { type: '&', guid: testGuid, tag: 'test' },
     );
     expect(testEntity.$is(resultEntity)).toEqual(true);
   });
@@ -259,7 +313,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by GUID and tags...
     const resultEntity = await nymph.getEntity(
       { class: TestModel },
-      { type: '|', guid: [testGuid, guid()] }
+      { type: '|', guid: [testGuid, guid()] },
     );
     expect(testEntity.$is(resultEntity)).toEqual(true);
   });
@@ -270,7 +324,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by GUID and tags...
     const resultEntity = await nymph.getEntity(
       { class: TestModel },
-      { type: '|', guid: [guid(), guid()] }
+      { type: '|', guid: [guid(), guid()] },
     );
     expect(testEntity.$is(resultEntity)).toEqual(false);
   });
@@ -281,7 +335,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !GUID...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', '!guid': guid(), tag: 'test' }
+      { type: '&', '!guid': guid(), tag: 'test' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -292,7 +346,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !tags...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', guid: testGuid, '!tag': ['barbecue', 'pickles'] }
+      { type: '&', guid: testGuid, '!tag': ['barbecue', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -303,7 +357,7 @@ This one's zip code is 92064.`;
     // Testing GUID and wrong tags...
     const resultEntity = await nymph.getEntity(
       { class: TestModel },
-      { type: '&', guid: testGuid, tag: ['pickles'] }
+      { type: '&', guid: testGuid, tag: ['pickles'] },
     );
     expect(resultEntity).toBeNull();
   });
@@ -314,7 +368,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by tags...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test' }
+      { type: '&', tag: 'test' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -325,7 +379,7 @@ This one's zip code is 92064.`;
     // Testing wrong tags...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'pickles' }
+      { type: '&', tag: 'pickles' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -336,7 +390,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by tags inclusively...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '|', tag: ['pickles', 'test', 'barbecue'] }
+      { type: '|', tag: ['pickles', 'test', 'barbecue'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -347,7 +401,7 @@ This one's zip code is 92064.`;
     // Testing wrong inclusive tags...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '|', tag: ['pickles', 'barbecue'] }
+      { type: '|', tag: ['pickles', 'barbecue'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -359,7 +413,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '|', tag: ['pickles', 'test', 'barbecue'] }
+      { type: '|', tag: ['pickles', 'test', 'barbecue'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -371,7 +425,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '|', tag: ['pickles', 'barbecue'] }
+      { type: '|', tag: ['pickles', 'barbecue'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -383,7 +437,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'pickles' },
-      { type: '|', tag: ['test', 'barbecue'] }
+      { type: '|', tag: ['test', 'barbecue'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -394,7 +448,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by defined...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', defined: 'string' }
+      { type: '&', defined: 'string' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -405,7 +459,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !defined...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', '!defined': 'pickles' }
+      { type: '&', tag: 'test', '!defined': 'pickles' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -417,7 +471,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '!&', defined: 'pickles' },
-      { type: '&', tag: 'test' }
+      { type: '&', tag: 'test' },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -426,9 +480,60 @@ This one's zip code is 92064.`;
     await createTestEntities();
 
     // Retrieving entity by equal...
-    const resultEntity = await nymph.getEntities(
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', equal: ['string', 'test'] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by equal...
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', equal: ['null', null] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by equal...
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', equal: ['boolean', true] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by equal...
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', equal: ['number', 30] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by equal...
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        equal: [
+          'array',
+          [
+            'full',
+            'of',
+            'values',
+            500,
+            { test: true },
+            { nullbyte: '\\\x00\u0000  \x00' },
+          ],
+        ],
+      },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by equal...
+    resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', equal: ['string', 'test'] }
+      {
+        type: '&',
+        equal: ['match', matchValue],
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -442,7 +547,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !equal...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', '!equal': ['string', 'wrong'] }
+      { type: '&', tag: 'test', '!equal': ['string', 'wrong'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -454,7 +559,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by like...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', like: ['string', 't_s%'] }
+      { type: '&', like: ['string', 't_s%'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -468,7 +573,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !like...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', '!like': ['string', 'wr_n%'] }
+      { type: '&', tag: 'test', '!like': ['string', 'wr_n%'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -480,7 +585,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by ilike...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ilike: ['string', 'T_s%'] }
+      { type: '&', ilike: ['string', 'T_s%'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -494,7 +599,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by !ilike...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', '!ilike': ['string', 'wr_n%'] }
+      { type: '&', tag: 'test', '!ilike': ['string', 'wr_n%'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -506,7 +611,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by like...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', like: ['string', 'T_s%'] }
+      { type: '&', like: ['string', 'T_s%'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -517,7 +622,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by tags and equal...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', equal: ['string', 'test'] }
+      { type: '&', tag: 'test', equal: ['string', 'test'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -528,7 +633,7 @@ This one's zip code is 92064.`;
     // Testing wrong tags and right equal...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'pickles', equal: ['string', 'test'] }
+      { type: '&', tag: 'pickles', equal: ['string', 'test'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -539,7 +644,7 @@ This one's zip code is 92064.`;
     // Testing right tags and wrong equal...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', equal: ['string', 'pickles'] }
+      { type: '&', tag: 'test', equal: ['string', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -550,7 +655,7 @@ This one's zip code is 92064.`;
     // Testing wrong tags and wrong equal...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'pickles', equal: ['string', 'pickles'] }
+      { type: '&', tag: 'pickles', equal: ['string', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -561,14 +666,21 @@ This one's zip code is 92064.`;
     // Retrieving entity by contain...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', contain: ['array', 'values'] }
+      { type: '&', contain: ['array', 'values'] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+
+    // Retrieving entity by contain...
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', contain: ['array', 500] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
-    // Retrieving entity by contain with full match...
+    // Retrieving entity by contain...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', contain: ['string', 'test'] }
+      { type: '&', contain: ['array', { test: true }] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -580,7 +692,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '!&', contain: ['array', 'pickles'] }
+      { type: '!&', contain: ['array', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -591,14 +703,14 @@ This one's zip code is 92064.`;
     // Testing wrong contain...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', contain: ['array', 'pickles'] }
+      { type: '&', contain: ['array', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
     // Testing wrong contain...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', contain: ['string', 'pickles'] }
+      { type: '&', contain: ['string', 'pickles'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -609,12 +721,12 @@ This one's zip code is 92064.`;
     // Retrieving entity by regex match...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', match: ['match', '.*'] } // anything
+      { type: '&', match: ['match', '.*'] }, // anything
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', match: ['match', 'Edward McCheese'] } // a substring
+      { type: '&', tag: 'test', match: ['match', 'Edward McCheese'] }, // a substring
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     resultEntity = await nymph.getEntities(
@@ -626,7 +738,7 @@ This one's zip code is 92064.`;
           ['string', '[0-9]'],
           ['match', 'Edward McCheese'],
         ],
-      } // inclusive test
+      }, // inclusive test
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     resultEntity = await nymph.getEntities(
@@ -635,7 +747,7 @@ This one's zip code is 92064.`;
         type: '&',
         tag: 'test',
         match: ['match', '[-a-zA-Z0-9+_]+@[-a-zA-Z0-9_]+.[-a-zA-Z0-9_]{2,4}'],
-      } // a simple email
+      }, // a simple email
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     resultEntity = await nymph.getEntities(
@@ -644,7 +756,7 @@ This one's zip code is 92064.`;
         type: '&',
         tag: 'test',
         match: ['match', '\\([0-9]{3}\\) [0-9]{3}-[0-9]{4}'],
-      } // a phone number
+      }, // a phone number
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -655,7 +767,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by regex match...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', imatch: ['match', 'edward mccheese'] } // a substring
+      { type: '&', tag: 'test', imatch: ['match', 'edward mccheese'] }, // a substring
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -666,12 +778,12 @@ This one's zip code is 92064.`;
     // Testing wrong regex match...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', match: ['match', 'Q'] }
+      { type: '&', match: ['match', '='] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'pickle', match: ['match', '.*'] }
+      { type: '&', tag: 'pickle', match: ['match', '.*'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
     resultEntity = await nymph.getEntities(
@@ -682,7 +794,7 @@ This one's zip code is 92064.`;
           ['string', '[0-9]'],
           ['match', ',,'],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -693,7 +805,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by regex match...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', match: ['match', 'edward mccheese'] } // a substring
+      { type: '&', tag: 'test', match: ['match', 'edward mccheese'] }, // a substring
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -705,7 +817,181 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '|', equal: ['string', 'pickles'], match: ['string', 'test'] }
+      { type: '|', equal: ['string', 'pickles'], match: ['string', 'test'] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('basic search', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: [
+          'search',
+          'Declaration of the thirteen united States of America',
+        ],
+      }, // a substring
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', tag: 'test' },
+      {
+        type: '|',
+        search: [
+          ['string', 'pickle'],
+          ['search', 'Declaration of the thirteen united States of America'],
+        ],
+      }, // inclusive test
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', 'July 4, 1776'],
+      }, // a string with a number
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('or search', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', 'Declaration or pickles'],
+      }, // a string with an or
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('series search', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', '"excited domestic insurrections"'],
+      }, // double quoted substring
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', "'exciting domestic insurrected'"],
+      }, // single quoted substring
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('negated search', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', '-pickle'],
+      }, // negated term
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('combined search', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', 'Declaration -pickle'],
+      }, // negated term with positive term
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: ['search', 'Declaration "General Congress"'],
+      }, // terms found in separate areas
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('wrong search', async () => {
+    await createTestEntities();
+
+    // Testing wrong search...
+    let resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', search: ['search', 'pickles'] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(false);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', tag: 'pickle', search: ['search', 'Declaration'] },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(false);
+    resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '|',
+        search: [
+          ['string', 'pickle'],
+          ['search', 'Hawaii'],
+        ],
+      },
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(false);
+  });
+
+  it('search must be case insensitive', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by full text search...
+    const resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      {
+        type: '&',
+        tag: 'test',
+        search: [
+          'search',
+          'DECLARATION OF THE THIRTEEN UNITED STATES OF AMERICA',
+        ],
+      }, // a substring
+    );
+    expect(testEntity.$inArray(resultEntity)).toEqual(true);
+  });
+
+  it('search and equal inclusive', async () => {
+    await createTestEntities();
+
+    // Retrieving entity by fts + equal inclusively...
+    const resultEntity = await nymph.getEntities(
+      { class: TestModel },
+      { type: '&', tag: 'test' },
+      { type: '|', equal: ['string', 'pickles'], search: ['string', 'test'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -722,7 +1008,7 @@ This one's zip code is 92064.`;
           ['number', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -735,7 +1021,7 @@ This one's zip code is 92064.`;
           ['number', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -748,7 +1034,7 @@ This one's zip code is 92064.`;
           ['number', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -761,7 +1047,7 @@ This one's zip code is 92064.`;
           ['numberString', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -774,7 +1060,7 @@ This one's zip code is 92064.`;
           ['numberString', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -787,7 +1073,7 @@ This one's zip code is 92064.`;
           ['numberString', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -804,7 +1090,7 @@ This one's zip code is 92064.`;
           ['number', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -817,7 +1103,7 @@ This one's zip code is 92064.`;
           ['number', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -830,7 +1116,7 @@ This one's zip code is 92064.`;
           ['number', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -843,7 +1129,7 @@ This one's zip code is 92064.`;
           ['numberString', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -856,7 +1142,7 @@ This one's zip code is 92064.`;
           ['numberString', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -869,7 +1155,7 @@ This one's zip code is 92064.`;
           ['numberString', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -886,7 +1172,7 @@ This one's zip code is 92064.`;
           ['number', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -899,7 +1185,7 @@ This one's zip code is 92064.`;
           ['number', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -912,7 +1198,7 @@ This one's zip code is 92064.`;
           ['number', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -925,7 +1211,7 @@ This one's zip code is 92064.`;
           ['numberString', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -938,7 +1224,7 @@ This one's zip code is 92064.`;
           ['numberString', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -951,7 +1237,7 @@ This one's zip code is 92064.`;
           ['numberString', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -968,7 +1254,7 @@ This one's zip code is 92064.`;
           ['number', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -981,7 +1267,7 @@ This one's zip code is 92064.`;
           ['number', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -994,7 +1280,7 @@ This one's zip code is 92064.`;
           ['number', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
 
@@ -1007,7 +1293,7 @@ This one's zip code is 92064.`;
           ['numberString', 30],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -1020,7 +1306,7 @@ This one's zip code is 92064.`;
           ['numberString', 31],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -1033,7 +1319,7 @@ This one's zip code is 92064.`;
           ['numberString', 29],
           ['pickles', 100],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1045,7 +1331,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '!&', gte: ['number', 60] }
+      { type: '!&', gte: ['number', 60] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1056,7 +1342,7 @@ This one's zip code is 92064.`;
     // Testing wrong inequality...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', lte: ['number', 29.99] }
+      { type: '&', lte: ['number', 29.99] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1067,7 +1353,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by time...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', gt: ['cdate', (testEntity.cdate ?? 0) - 120] }
+      { type: '&', tag: 'test', gt: ['cdate', (testEntity.cdate ?? 0) - 120] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1078,7 +1364,7 @@ This one's zip code is 92064.`;
     // Testing wrong time...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', gte: ['cdate', (testEntity.cdate ?? 0) + 1] }
+      { type: '&', tag: 'test', gte: ['cdate', (testEntity.cdate ?? 0) + 1] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1091,7 +1377,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', gt: ['timestamp', null, '-1 day'] }
+      { type: '&', gt: ['timestamp', null, '-1 day'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -1105,7 +1391,7 @@ This one's zip code is 92064.`;
           ['timestamp', null, '-1 day'],
           ['timestamp', null, '+5 days'],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -1113,7 +1399,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', gt: ['timestamp', null, '-3 days'] }
+      { type: '&', gt: ['timestamp', null, '-3 days'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(true);
@@ -1121,7 +1407,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', gt: ['cdate', null, '-1 day'] }
+      { type: '&', gt: ['cdate', null, '-1 day'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(true);
@@ -1135,7 +1421,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     let resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', gt: ['timestamp', null, '+1 day'] }
+      { type: '&', tag: 'test', gt: ['timestamp', null, '+1 day'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -1143,7 +1429,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', lt: ['timestamp', null, '-3 days'] }
+      { type: '&', tag: 'test', lt: ['timestamp', null, '-3 days'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -1151,7 +1437,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by relative time...
     resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', tag: 'test', gt: ['cdate', null, '+1 day'] }
+      { type: '&', tag: 'test', gt: ['cdate', null, '+1 day'] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
     expect(referenceEntity.$inArray(resultEntity)).toEqual(false);
@@ -1161,9 +1447,11 @@ This one's zip code is 92064.`;
     await createTestEntities();
 
     // Testing referenced entities...
+    await testEntity.reference?.$wake();
     expect(testEntity.reference?.test).toEqual('good');
 
     // Testing referenced entity arrays...
+    await Promise.all(testEntity.refArray?.map((e) => e.$wake()) || []);
     expect(testEntity.refArray?.[0].test).toEqual('good');
   });
 
@@ -1173,7 +1461,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by reference...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ref: ['reference', refGuid] }
+      { type: '&', ref: ['reference', refGuid] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1185,7 +1473,7 @@ This one's zip code is 92064.`;
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
       { type: '&', tag: 'test' },
-      { type: '!&', ref: ['reference', guid()] }
+      { type: '!&', ref: ['reference', guid()] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1196,7 +1484,7 @@ This one's zip code is 92064.`;
     // Testing wrong reference...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ref: ['reference', guid()] }
+      { type: '&', ref: ['reference', guid()] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1207,7 +1495,7 @@ This one's zip code is 92064.`;
     // Testing non-existent reference...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ref: ['pickle', refGuid] }
+      { type: '&', ref: ['pickle', refGuid] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1224,7 +1512,7 @@ This one's zip code is 92064.`;
           ['reference', refGuid],
           ['reference', guid()],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1241,7 +1529,7 @@ This one's zip code is 92064.`;
           ['reference', guid()],
           ['reference', guid()],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1252,7 +1540,7 @@ This one's zip code is 92064.`;
     // Retrieving entity by array reference...
     const resultEntity = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ref: ['refArray', refGuid] }
+      { type: '&', ref: ['refArray', refGuid] },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1269,7 +1557,7 @@ This one's zip code is 92064.`;
           ['refArray', refGuid],
           ['refArray', guid()],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1303,6 +1591,8 @@ This one's zip code is 92064.`;
           ['array', 'of'],
           ['array', 'values'],
           ['array', 500],
+          ['array', { test: true }],
+          ['array', { nullbyte: '\\\x00\u0000  \x00' }],
         ],
       },
       {
@@ -1314,7 +1604,7 @@ This one's zip code is 92064.`;
           ['array', 'values'],
           ['array', 500],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1334,13 +1624,13 @@ This one's zip code is 92064.`;
 
     const resultSelectors = await nymph.getEntities(
       { class: TestModel },
-      { type: '&', ref: ['reference', refGuid] }
+      { type: '&', ref: ['reference', refGuid] },
     );
 
     // Testing count return with selectors...
     const resultSelectorsCount = await nymph.getEntities(
       { class: TestModel, return: 'count' },
-      { type: '&', ref: ['reference', refGuid] }
+      { type: '&', ref: ['reference', refGuid] },
     );
     expect(resultSelectorsCount).toBeGreaterThanOrEqual(1);
     expect(resultSelectorsCount).toEqual(resultSelectors.length);
@@ -1363,7 +1653,7 @@ This one's zip code is 92064.`;
     // Testing empty count...
     const resultSelectorsEmpty = await nymph.getEntities(
       { class: TestModel, return: 'count' },
-      { type: '&', ref: ['reference', guid()] }
+      { type: '&', ref: ['reference', guid()] },
     );
     expect(resultSelectorsEmpty).toEqual(0);
   });
@@ -1397,6 +1687,8 @@ This one's zip code is 92064.`;
           ['array', 'of'],
           ['array', 'values'],
           ['array', 500],
+          ['array', { test: true }],
+          ['array', { nullbyte: '\\\x00\u0000  \x00' }],
         ],
       },
       {
@@ -1408,11 +1700,66 @@ This one's zip code is 92064.`;
           ['array', 'values'],
           ['array', 500],
         ],
-      }
+      },
     );
     expect(resultGuid.indexOf(testEntity.guid ?? '')).toBeGreaterThan(-1);
   });
 
+  it('object return', async () => {
+    await createTestEntities();
+
+    // Testing object return using logic operations...
+    const resultObjects = await nymph.getEntities(
+      { class: TestModel, return: 'object' },
+      {
+        type: '&',
+        '!ref': [
+          ['refArray', guid()],
+          ['refArray', guid()],
+        ],
+        '!lte': ['number', 29.99],
+      },
+      {
+        type: '|',
+        '!lte': [
+          ['number', 29.99],
+          ['number', 30],
+        ],
+      },
+      {
+        type: '!&',
+        '!equal': ['string', 'test'],
+        '!contain': [
+          ['array', 'full'],
+          ['array', 'of'],
+          ['array', 'values'],
+          ['array', 500],
+          ['array', { test: true }],
+          ['array', { nullbyte: '\\\x00\u0000  \x00' }],
+        ],
+      },
+      {
+        type: '!|',
+        '!equal': ['string', 'test'],
+        contain: [
+          ['array', 'full'],
+          ['array', 'of'],
+          ['array', 'values'],
+          ['array', 500],
+        ],
+      },
+    );
+
+    const resultObject = resultObjects.find(
+      (entity) => entity.guid === testEntity.guid,
+    );
+
+    expect(resultObject).toBeInstanceOf(Object);
+    expect(resultObject).not.toBeInstanceOf(TestModel);
+    expect(Array.isArray(resultObject?.tags)).toBeTruthy();
+    expect(resultObject?.string).toEqual('test');
+  });
+
   it('deep selector', async () => {
     await createTestEntities();
 
@@ -1445,6 +1792,8 @@ This one's zip code is 92064.`;
               ['array', 'of'],
               ['array', 'values'],
               ['array', 500],
+              ['array', { test: true }],
+              ['array', { nullbyte: '\\\x00\u0000  \x00' }],
             ],
           },
           {
@@ -1458,7 +1807,7 @@ This one's zip code is 92064.`;
             ],
           },
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
 
@@ -1490,6 +1839,8 @@ This one's zip code is 92064.`;
               ['array', 'of'],
               ['array', 'values'],
               ['array', 500],
+              ['array', { test: true }],
+              ['array', { nullbyte: '\\\x00\u0000  \x00' }],
             ],
           },
           {
@@ -1503,7 +1854,7 @@ This one's zip code is 92064.`;
             ],
           },
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity2)).toEqual(true);
 
@@ -1519,7 +1870,7 @@ This one's zip code is 92064.`;
           },
           { type: '&', gte: ['number', 16000] },
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity3)).toEqual(true);
 
@@ -1541,7 +1892,7 @@ This one's zip code is 92064.`;
             },
           },
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity4)).toEqual(true);
   });
@@ -1560,7 +1911,7 @@ This one's zip code is 92064.`;
           },
           { type: '&', gte: ['number', 16000] },
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1577,7 +1928,7 @@ This one's zip code is 92064.`;
           'reference',
           [{ class: TestModel }, { type: '&', equal: ['test', 'good'] }],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1594,7 +1945,7 @@ This one's zip code is 92064.`;
           'reference',
           [{ class: TestModel }, { type: '&', equal: ['test', 'pickles'] }],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(true);
   });
@@ -1611,7 +1962,7 @@ This one's zip code is 92064.`;
           'reference',
           [{ class: TestBModel }, { type: '&', equal: ['test', 'good'] }],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
@@ -1628,31 +1979,28 @@ This one's zip code is 92064.`;
           'reference',
           [{ class: TestModel }, { type: '&', equal: ['test', 'pickles'] }],
         ],
-      }
+      },
     );
     expect(testEntity.$inArray(resultEntity)).toEqual(false);
   });
 
-  it('sort option', async () => {
+  it('cdate and mdate sort option', async () => {
     await createMultipleTestEntities();
 
-    for (const sort of ['cdate', 'mdate']) {
+    for (const sort of ['cdate', 'mdate'] as ('cdate' | 'mdate')[]) {
       // Retrieving entities sorted...
-      let resultEntities = await nymph.getEntities({
-        class: TestModel,
-        sort: sort as 'cdate' | 'mdate',
-      });
+      let resultEntities = await nymph.getEntities({ class: TestModel, sort });
       expect(resultEntities.length).toBeGreaterThan(100);
       for (let i = 0; i < resultEntities.length - 1; i++) {
-        expect(
-          resultEntities[i + 1][sort as 'cdate' | 'mdate']
-        ).toBeGreaterThan(resultEntities[i][sort as 'cdate' | 'mdate'] ?? 0);
+        expect(resultEntities[i + 1][sort]).toBeGreaterThan(
+          resultEntities[i][sort] ?? 0,
+        );
       }
 
       // And test the same with guid return...
       let resultGuids = await nymph.getEntities({
         class: TestModel,
-        sort: sort as 'cdate' | 'mdate',
+        sort,
         return: 'guid',
       });
       expect(resultGuids.length).toBeGreaterThan(100);
@@ -1663,48 +2011,121 @@ This one's zip code is 92064.`;
       // Retrieving entities reverse sorted...
       resultEntities = await nymph.getEntities({
         class: TestModel,
-        sort: sort as 'cdate' | 'mdate',
+        sort,
         reverse: true,
       });
       expect(resultEntities.length).toBeGreaterThan(100);
       for (let i = 0; i < resultEntities.length - 1; i++) {
-        expect(resultEntities[i + 1][sort as 'cdate' | 'mdate']).toBeLessThan(
-          resultEntities[i][sort as 'cdate' | 'mdate'] ?? 0
+        expect(resultEntities[i + 1][sort]).toBeLessThan(
+          resultEntities[i][sort] ?? 0,
         );
       }
 
       // And again with other selectors.
       // Retrieving entities sorted...
       resultEntities = await nymph.getEntities(
-        { class: TestModel, sort: sort as 'cdate' | 'mdate' },
-        { type: '&', match: ['name', '^Multi Test '] }
+        { class: TestModel, sort },
+        { type: '&', match: ['name', '^Multi Test '] },
       );
       expect(resultEntities.length).toEqual(100);
       for (let i = 0; i < resultEntities.length - 1; i++) {
-        expect(
-          resultEntities[i + 1][sort as 'cdate' | 'mdate']
-        ).toBeGreaterThan(resultEntities[i][sort as 'cdate' | 'mdate'] ?? 0);
+        expect(resultEntities[i + 1][sort]).toBeGreaterThan(
+          resultEntities[i][sort] ?? 0,
+        );
       }
 
       // Retrieving entities reverse sorted...
       resultEntities = await nymph.getEntities(
-        { class: TestModel, sort: sort as 'cdate' | 'mdate', reverse: true },
-        { type: '&', match: ['name', '^Multi Test '] }
+        { class: TestModel, sort, reverse: true },
+        { type: '&', match: ['name', '^Multi Test '] },
       );
       expect(resultEntities.length).toEqual(100);
       for (let i = 0; i < resultEntities.length - 1; i++) {
-        expect(resultEntities[i + 1][sort as 'cdate' | 'mdate']).toBeLessThan(
-          resultEntities[i][sort as 'cdate' | 'mdate'] ?? 0
+        expect(resultEntities[i + 1][sort]).toBeLessThan(
+          resultEntities[i][sort] ?? 0,
         );
       }
     }
   });
 
+  it('property sort option', async () => {
+    await createMultipleTestEntities();
+
+    // Retrieving entities sorted...
+    let resultEntities = await nymph.getEntities({
+      class: TestModel,
+      sort: 'number',
+    });
+    expect(resultEntities.length).toBeGreaterThan(100);
+    for (let i = 0; i < resultEntities.length - 1; i++) {
+      expect(resultEntities[i + 1].number ?? Infinity).toBeGreaterThanOrEqual(
+        resultEntities[i].number ?? 0,
+      );
+    }
+
+    // And test the same with guid return...
+    let resultGuids = await nymph.getEntities({
+      class: TestModel,
+      sort: 'number',
+      return: 'guid',
+    });
+    expect(resultGuids.length).toBeGreaterThan(100);
+    for (let i = 0; i < resultGuids.length - 1; i++) {
+      expect(resultGuids[i]).toEqual(resultEntities[i].guid);
+    }
+
+    // Retrieving entities reverse sorted...
+    resultEntities = await nymph.getEntities({
+      class: TestModel,
+      sort: 'number',
+      reverse: true,
+    });
+    expect(resultEntities.length).toBeGreaterThan(100);
+    for (let i = 0; i < resultEntities.length - 1; i++) {
+      expect(resultEntities[i + 1].number ?? 0).toBeLessThanOrEqual(
+        resultEntities[i].number ?? Infinity,
+      );
+    }
+
+    // And again with other selectors.
+    // Retrieving entities sorted...
+    resultEntities = await nymph.getEntities(
+      { class: TestModel, sort: 'number' },
+      { type: '&', match: ['name', '^Multi Test '] },
+    );
+    expect(resultEntities.length).toEqual(100);
+    for (let i = 0; i < resultEntities.length - 1; i++) {
+      expect(resultEntities[i + 1].number ?? Infinity).toBeGreaterThan(
+        resultEntities[i].number ?? 0,
+      );
+      expect(resultEntities[i].name).toEqual(
+        `Multi Test ${100 - (resultEntities[i].number ?? 0)}`,
+      );
+    }
+
+    // Retrieving entities reverse sorted...
+    resultEntities = await nymph.getEntities(
+      { class: TestModel, sort: 'number', reverse: true },
+      { type: '&', match: ['name', '^Multi Test '] },
+    );
+    expect(resultEntities.length).toEqual(100);
+    for (let i = 0; i < resultEntities.length - 1; i++) {
+      expect(resultEntities[i + 1].number ?? 0).toBeLessThan(
+        resultEntities[i].number ?? Infinity,
+      );
+      expect(resultEntities[i].name).toEqual(
+        `Multi Test ${100 - (resultEntities[i].number ?? 0)}`,
+      );
+    }
+  });
+
   it('delete reference', async () => {
     await createTestEntities();
 
     // Deleting referenced entities...
+    await testEntity.reference?.$wake();
     expect(await testEntity.reference?.$delete()).toEqual(true);
+    await Promise.all(testEntity.refArray?.map((e) => e.$wake()) || []);
     expect(testEntity.reference?.guid).toBeNull();
   });
 
@@ -1717,20 +2138,117 @@ This one's zip code is 92064.`;
 
     const entity = await nymph.getEntity(
       { class: TestModel },
-      { type: '&', guid: testGuid }
+      { type: '&', guid: testGuid },
     );
 
     expect(entity).toBeNull();
   });
+
+  it('allows non-duplicate unique strings', async () => {
+    // Creating entity...
+    const uniqueEntityA = await TestModel.factory();
+    uniqueEntityA.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityA.uniques = ['test a'];
+
+    // Saving entity...
+    expect(await uniqueEntityA.$save()).toEqual(true);
+    expect(uniqueEntityA.guid).not.toBeNull();
+
+    // Creating entity...
+    const uniqueEntityB = await TestModel.factory();
+    uniqueEntityB.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityB.uniques = ['test b'];
+
+    // Saving entity...
+    expect(await uniqueEntityB.$save()).toEqual(true);
+    expect(uniqueEntityB.guid).not.toBeNull();
+
+    expect(uniqueEntityA.guid).not.toEqual(uniqueEntityB.guid);
+
+    expect(await uniqueEntityA.$delete()).toEqual(true);
+    expect(await uniqueEntityB.$delete()).toEqual(true);
+  });
+
+  it('throws on duplicate unique strings', async () => {
+    // Creating entity...
+    const uniqueEntityA = await TestModel.factory();
+    uniqueEntityA.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityA.uniques = ['test a'];
+
+    // Saving entity...
+    expect(await uniqueEntityA.$save()).toEqual(true);
+    expect(uniqueEntityA.guid).not.toBeNull();
+
+    // Creating entity...
+    const uniqueEntityB = await TestModel.factory();
+    uniqueEntityB.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityB.uniques = ['test a'];
+
+    // Saving entity...
+    try {
+      await uniqueEntityB.$save();
+
+      throw Error("Shouldn't get past the uniqueness check.");
+    } catch (e: any) {
+      expect(e).toBeInstanceOf(EntityUniqueConstraintError);
+    }
+    expect(uniqueEntityB.guid).toBeNull();
+
+    expect(await uniqueEntityA.$delete()).toEqual(true);
+  });
+
+  it('allows duplicate unique string if first transaction is rolled back', async () => {
+    // Creating transaction entity...
+    const tnymphA = await nymph.startTransaction('test-unique-a');
+    const TestModelA = tnymphA.getEntityClass(TestModel);
+    const uniqueEntityA = await TestModelA.factory();
+    uniqueEntityA.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityA.uniques = ['test a'];
+
+    // Saving entity...
+    expect(await uniqueEntityA.$save()).toEqual(true);
+    expect(uniqueEntityA.guid).not.toBeNull();
+
+    // Rolling back transaction...
+    expect(await tnymphA.rollback('test-unique-a')).toEqual(true);
+
+    // Creating transaction entity...
+    const tnymphB = await nymph.startTransaction('test-unique-b');
+    const TestModelB = tnymphB.getEntityClass(TestModel);
+    const uniqueEntityB = await TestModelB.factory();
+    uniqueEntityB.name = 'Entity Test ' + new Date().toLocaleString();
+    uniqueEntityB.uniques = ['test a'];
+
+    // Saving entity...
+    expect(await uniqueEntityB.$save()).toEqual(true);
+    expect(uniqueEntityB.guid).not.toBeNull();
+
+    expect(uniqueEntityA.guid).not.toEqual(uniqueEntityB.guid);
+
+    expect(await tnymphB.commit('test-unique-b')).toEqual(true);
+
+    const uniqueEntityACheck = await nymph.getEntity(
+      { class: TestModel },
+      { type: '&', guid: uniqueEntityA.guid ?? '' },
+    );
+    expect(uniqueEntityACheck).toBeNull();
+
+    const uniqueEntityBCheck = await nymph.getEntity(
+      { class: TestModel },
+      { type: '&', guid: uniqueEntityB.guid ?? '' },
+    );
+    expect(uniqueEntityBCheck).not.toBeNull();
+
+    if (uniqueEntityBCheck != null) {
+      expect(await uniqueEntityBCheck.$delete()).toEqual(true);
+    }
+  });
 }
 
 export function UIDTest(
   nymph: Nymph,
-  it: (name: string, fn: () => void) => void
+  it: (name: string, fn: () => void) => void,
 ) {
-  nymph.addEntityClass(TestModel);
-  nymph.addEntityClass(TestBModel);
-
   it('delete old test data', async () => {
     expect(await nymph.deleteUID('TestUID')).toEqual(true);
     expect(await nymph.deleteUID('NewUID')).toEqual(true);
@@ -1770,10 +2288,10 @@ export function UIDTest(
 
 export function ExportImportTest(
   nymph: Nymph,
-  it: (name: string, fn: () => void) => void
+  it: (name: string, fn: () => void) => void,
 ) {
-  nymph.addEntityClass(TestModel);
-  nymph.addEntityClass(TestBModel);
+  const TestModel = nymph.addEntityClass(TestModelClass);
+  const TestBModel = nymph.addEntityClass(TestBModelClass);
 
   async function deleteTestData() {
     let all = await nymph.getEntities({ class: TestModel });
@@ -1806,23 +2324,38 @@ export function ExportImportTest(
     const bmodels = await nymph.getEntities({ class: TestBModel });
 
     expect(models.length).toEqual(30);
-    expect(bmodels.length).toEqual(10);
-
-    const all = [...models, ...bmodels];
-    for (const model of all) {
-      if (model.index?.match(/^\d+a$/)) {
-        expect(model.null).toBeNull();
-        expect(model.string).toEqual('test');
-        expect(model.array).toEqual(['full', 'of', 'values', 500]);
-        expect(model.number).toEqual(30);
-        expect(model.timestamp).toBeGreaterThanOrEqual(strtotime('-2 minutes'));
-
-        expect(model.reference?.guid).not.toBeNull();
-        expect(model.reference?.string).toEqual('another');
-        expect(model.reference?.index?.match(/^\d+b$/)).toBeTruthy();
-        expect(model.refArray?.[0].guid).not.toBeNull();
-        expect(model.refArray?.[0].guid).toEqual(model.reference?.guid);
-      }
+    expect(bmodels.length).toEqual(30);
+
+    for (const model of models) {
+      expect(model.name).toMatch(/^Entity Test /);
+      expect(model.null).toBeDefined();
+      expect(model.null).toBeNull();
+      expect(model.string).toEqual('test');
+      expect(model.array).toEqual([
+        'full',
+        'of',
+        'values',
+        500,
+        { test: true },
+        { nullbyte: '\\\x00\u0000  \x00' },
+      ]);
+      expect(model.match).toEqual(matchValue);
+      expect(model.number).toEqual(30);
+      expect(model.numberString).toEqual('30');
+      expect(model.timestamp).toBeGreaterThanOrEqual(strtotime('-2 minutes'));
+      expect(model.index).toMatch(/^\d+a$/);
+
+      await model.reference?.$wake();
+      expect(model.reference?.guid).not.toBeNull();
+      expect(model.reference?.string).toEqual('another');
+      expect(model.reference?.index).toMatch(/^\d+b$/);
+      expect(model.index?.substring(0, -1)).toEqual(
+        model.reference?.index?.substring(0, -1),
+      );
+      expect(model.reference?.$inArray(bmodels)).toEqual(true);
+      await Promise.all(model.refArray?.map((e) => e.$wake()) || []);
+      expect(model.refArray?.[0].guid).not.toBeNull();
+      expect(model.refArray?.[0].guid).toEqual(model.reference?.guid);
     }
   }
 
@@ -1835,22 +2368,29 @@ export function ExportImportTest(
     expect(await nymph.newUID('TestUID')).toEqual(2);
     expect(await nymph.newUID('TestUID2')).toEqual(1);
 
-    for (let i = 0; i < 20; i++) {
-      const EntityClass = i < 15 ? TestModel : TestBModel;
-
+    for (let i = 0; i < 30; i++) {
       // Creating entity...
-      const testEntity = await EntityClass.factory();
+      const testEntity = await TestModel.factory();
 
       // Saving entity...
       testEntity.name = 'Entity Test ' + new Date().toLocaleString();
       testEntity.null = null;
       testEntity.string = 'test';
-      testEntity.array = ['full', 'of', 'values', 500];
+      testEntity.array = [
+        'full',
+        'of',
+        'values',
+        500,
+        { test: true },
+        { nullbyte: '\\\x00\u0000  \x00' },
+      ];
+      testEntity.match = matchValue;
       testEntity.number = 30;
+      testEntity.numberString = '30';
       testEntity.timestamp = Date.now();
       testEntity.index = i + 'a';
 
-      const entityReferenceTest = await EntityClass.factory();
+      const entityReferenceTest = await TestBModel.factory();
       entityReferenceTest.string = 'another';
       entityReferenceTest.index = i + 'b';
 
@@ -1864,9 +2404,13 @@ export function ExportImportTest(
     await checkEntityDataAndCount();
   });
 
+  it('needs migration', async () => {
+    expect(await nymph.needsMigration()).toEqual(false);
+  });
+
   it('export data', async () => {
     expect(await nymph.export(__dirname + '/testentityexport.nex')).toEqual(
-      true
+      true,
     );
   });
 
@@ -1883,11 +2427,237 @@ export function ExportImportTest(
     expect(bmodels.length).toEqual(0);
 
     expect(await nymph.import(__dirname + '/testentityexport.nex')).toEqual(
-      true
+      true,
     );
 
     await checkEntityDataAndCount();
 
     fs.unlinkSync(__dirname + '/testentityexport.nex');
   });
+
+  it('import tokens only', async () => {
+    const model = await nymph.getEntity({ class: TestModel });
+
+    expect(model).not.toBeNull();
+
+    if (model != null) {
+      const data = model.$getData(true);
+      // These should not actually be saved in the DB.
+      data.number = 424242424242;
+      // But this should become searchable.
+      data.search = 'peanuts and pickles on a hot bun';
+
+      const sdata = Object.fromEntries(
+        Object.entries(data).map(([name, value]) => [
+          name,
+          JSON.stringify(value),
+        ]),
+      );
+
+      if (model.guid == null || model.cdate == null || model.mdate == null) {
+        throw new Error('Model data is wrong.');
+      }
+
+      await nymph.importEntityTokens({
+        guid: model.guid,
+        // Again, these should not actually be changed in the DB.
+        cdate: model.cdate + 1000,
+        mdate: model.mdate + 1000,
+        tags: [...model.tags, 'helicopter'],
+        sdata,
+        etype: TestModel.ETYPE,
+      });
+
+      const modelCheck = await nymph.getEntity(
+        { class: TestModel },
+        { type: '&', search: ['search', '"peanuts and pickles on a hot bun"'] },
+      );
+
+      expect(modelCheck?.guid).toEqual(model.guid);
+      expect(modelCheck?.cdate).toEqual(model.cdate);
+      expect(modelCheck?.mdate).toEqual(model.mdate);
+      expect(modelCheck?.$hasTag('helicopter')).toEqual(false);
+      expect(modelCheck?.number).not.toEqual(424242424242);
+      expect(modelCheck?.search).not.toEqual(
+        'peanuts and pickles on a hot bun',
+      );
+    }
+  });
 }
+
+const matchValue = `Hello, my name is Edward McCheese. It is a pleasure to meet you. As you can see, I have several hats of the most pleasant nature.
+
+This one's email address is nice_hat-wednesday+newyork@im-a-hat.hat.
+This one's phone number is (555) 555-1818.
+This one's zip code is 92064.
+This one's favorite emojis are 🔥❤️😊😂⭐🤔
+
+These hats are absolutely fantastic.
+
+\x00\x00\x00
+
+Lorem ipsum odor amet, consectetuer adipiscing elit. Metus ad mattis sit pretium per, dignissim imperdiet luctus. Congue rhoncus turpis etiam aenean ultricies dapibus justo nunc. Netus non primis quis habitasse lacus. Nascetur dapibus sociosqu ridiculus primis; elementum netus consectetur ridiculus litora. Tristique facilisis erat ex class nulla cursus amet. Metus vitae tempor euismod vel; ullamcorper ac quisque vestibulum. Mauris libero pulvinar facilisi eros natoque massa.
+
+Nunc vel hac nec tristique vivamus. Leo volutpat convallis eget integer tellus cubilia tincidunt malesuada? Consequat elit nisi tristique vehicula cubilia maecenas metus facilisi malesuada. In mattis euismod ad magnis fusce. Nisi congue sociosqu rhoncus lobortis fringilla sollicitudin at platea. Iaculis ut et varius metus eleifend laoreet hac odio libero. Non ridiculus tempus ultricies nullam curabitur.
+
+Amet pellentesque aliquam placerat; vestibulum blandit platea porttitor pulvinar. Tellus tristique ad morbi in ac placerat luctus. Ante efficitur inceptos commodo lacus sodales sit varius nunc consequat. Senectus non vel est convallis mauris. Venenatis feugiat massa nostra, purus class primis sodales odio. Risus nulla integer feugiat ridiculus porta nascetur. Rutrum tincidunt enim parturient libero nisl ante sagittis nisi. Cubilia massa non vehicula vehicula amet parturient pellentesque. Habitant dapibus fames lectus pretium rhoncus.
+
+Ridiculus nascetur mauris iaculis hendrerit ridiculus gravida auctor in. Class suscipit augue finibus semper vulputate nec. Tristique mi eu praesent commodo fermentum inceptos penatibus lobortis. Libero enim orci ultricies egestas ut pellentesque. Laoreet massa ad curabitur tellus libero laoreet habitasse enim nascetur. Iaculis euismod a euismod conubia purus. Commodo condimentum ultrices lorem ligula aenean; netus mattis sem non.
+
+Curabitur duis imperdiet mus integer vel bibendum; fusce malesuada. Dignissim duis himenaeos primis odio, congue pharetra? Egestas mus sit eget proin quis. Neque dapibus dapibus nam sociosqu; maecenas viverra himenaeos. Himenaeos faucibus himenaeos faucibus ex litora eros faucibus cras. Maximus scelerisque nullam nunc congue fringilla. Nisi eu magna erat morbi cras enim amet litora. Nostra primis vitae arcu, accumsan sollicitudin curabitur. Potenti sit vel vehicula metus leo id. Etiam blandit quisque nam orci; neque lacinia rutrum.
+
+Aliquam mollis varius hendrerit sem eleifend fermentum. Sapien rutrum condimentum inceptos ex feugiat consectetur mollis magna diam. Natoque enim nisi, ex risus finibus lacinia conubia vivamus suscipit. Habitasse interdum lorem ante, bibendum posuere dis. Lacus porttitor sapien proin; consequat velit ipsum venenatis. Vivamus porta mattis morbi nunc torquent neque. Senectus vehicula tincidunt parturient fringilla id amet urna libero pharetra.
+
+Faucibus netus tincidunt et viverra augue ligula est quis. Ipsum tempus vehicula tortor dis tortor ad. Ex tincidunt torquent eleifend aenean urna commodo. Quam nullam imperdiet volutpat vel condimentum cubilia sociosqu. Etiam tempor sapien mattis, venenatis aptent id risus. Efficitur luctus vel; nam ut commodo sociosqu hendrerit. Quisque placerat gravida rhoncus blandit vitae. Himenaeos id risus est mollis aliquet nam curabitur.
+
+Habitasse sed est fames quis lobortis leo mattis. Nisl cursus tincidunt cursus felis porttitor. Ante integer turpis non class lobortis suscipit. Condimentum velit vulputate quis sapien, lacus magna adipiscing nec primis. Blandit consequat ipsum nostra dignissim; tincidunt torquent fames. Ac faucibus elit iaculis duis lobortis. Euismod facilisi massa turpis mus neque. Class vulputate quisque elementum suscipit nostra tempus adipiscing. Malesuada himenaeos finibus ad inceptos volutpat scelerisque inceptos.
+
+Natoque platea at feugiat cras tellus facilisi suspendisse lacinia maximus. Duis vestibulum eget molestie turpis risus dapibus dignissim torquent? Nulla nibh aptent fringilla scelerisque euismod mauris ornare. Orci finibus taciti habitasse fringilla laoreet convallis. Class sed fringilla eget quisque sit auctor. Id cursus mauris praesent maecenas iaculis. Ullamcorper luctus habitant ultrices pharetra etiam mattis morbi fringilla lorem.
+
+Pharetra porta orci ridiculus inceptos eleifend sem ante quis. Molestie velit penatibus libero per sem litora congue. Porta quis egestas vivamus vitae potenti ornare. Elit molestie nullam vitae quam viverra. Nisl fringilla massa ridiculus donec ridiculus sed magnis. Cursus ad enim consequat ultricies tortor rhoncus pellentesque augue. Netus facilisis tempor elementum interdum at sagittis habitasse. Pretium imperdiet duis diam ullamcorper donec at suscipit. Id per inceptos ac luctus massa imperdiet tempor. Parturient libero suscipit non tempor ligula ullamcorper placerat varius.
+
+Libero duis suspendisse cubilia rhoncus scelerisque faucibus mattis. Leo fusce urna at per inceptos vel lobortis. Quisque ex duis euismod dictum hac nibh eros. Penatibus eleifend tellus donec elit primis phasellus habitant dictum. Imperdiet consequat facilisi massa, lacus gravida sodales id sapien. Ornare sapien sit convallis suscipit nunc enim. Tempus at vitae class sollicitudin proin. Dolor aenean felis netus consectetur mattis phasellus vestibulum. Orci fringilla sodales montes sed himenaeos ex massa natoque porttitor.
+
+Mus condimentum dui mollis dolor accumsan ligula pretium? Est phasellus platea iaculis vehicula et eros vel rutrum placerat. Nulla laoreet faucibus; congue netus magna senectus lectus dictum. Sodales aliquam eget himenaeos adipiscing, tempor feugiat. Lorem pellentesque iaculis fames lectus cubilia ornare sagittis rhoncus? Bibendum viverra tellus libero congue dignissim metus tellus aenean ultrices. Sollicitudin cras sollicitudin mattis lacus facilisis fermentum scelerisque porttitor rutrum.
+
+Sapien aptent fames curae, consectetur dapibus mauris sollicitudin tellus. Laoreet etiam dignissim, suscipit platea libero vitae taciti eu nec. Donec lobortis metus nisi; est enim himenaeos molestie tellus sapien. Sapien tellus rhoncus blandit fusce hendrerit feugiat. Maximus sit hendrerit tincidunt nec imperdiet hendrerit semper suscipit. Quam augue proin netus rutrum et sem. Neque penatibus cubilia nec metus porta. Ornare pulvinar quam auctor, elit curae ad donec dis. Egestas aptent non tortor potenti morbi mauris.
+
+Montes dui in pharetra primis consequat ante integer. Vulputate libero gravida rutrum tortor suscipit massa! Netus rhoncus platea torquent dapibus consectetur suspendisse etiam sociosqu. Quis placerat mauris et quam nascetur. Dictumst mi rutrum justo vitae ultricies feugiat nulla faucibus morbi. Consectetur nec condimentum euismod sodales nisi purus; finibus elementum facilisi.
+
+Senectus mus faucibus ut morbi eu maximus. Turpis tincidunt sodales sociosqu lorem amet pulvinar laoreet faucibus. Mus bibendum vulputate hendrerit sollicitudin eu ridiculus posuere augue leo? Cubilia nostra consequat; fusce egestas himenaeos class ornare nec. Est montes tortor vivamus congue inceptos erat mi eget pellentesque. Amet vulputate fringilla aliquet fames tristique. Rutrum malesuada dapibus vehicula risus nunc torquent habitant turpis habitant. Ipsum proin viverra adipiscing cras et augue hendrerit. Efficitur euismod aliquam habitant; sit nisl potenti.
+
+Conubia dignissim metus phasellus tristique augue, nullam quam finibus. Dignissim vel enim mattis praesent penatibus. Sapien pharetra curae torquent turpis fermentum feugiat facilisis nisi. Lacinia justo ante mauris finibus vitae ante efficitur dis. Urna gravida conubia amet rhoncus felis ut lorem placerat. Quisque fermentum suscipit aenean nisi suscipit ac? Quis ornare faucibus amet conubia justo maximus hendrerit phasellus aenean. Ex vivamus vulputate in mollis mauris praesent vehicula erat neque.
+
+Orci nullam commodo habitant volutpat per tincidunt mus sit. Nisi cubilia fringilla viverra at orci magnis massa nam orci. Duis iaculis sapien nulla nascetur elit porta fermentum. Amus libero vivamus vel finibus magnis placerat himenaeos. Integer posuere suscipit non vulputate enim. Conubia id lobortis habitasse luctus odio maecenas enim conubia non. Mus egestas massa platea nullam sociosqu, magnis cras. Quam placerat nisi dui gravida ultricies, facilisis eu pharetra vivamus.
+
+Fusce maecenas dis finibus senectus nascetur tortor. Nec rhoncus pretium vivamus donec vel ligula curabitur. Velit dis laoreet aenean, fusce metus blandit erat. Ligula purus natoque, arcu finibus tincidunt efficitur dolor curabitur. Ac risus et ipsum; consequat integer phasellus diam. Praesent ipsum gravida placerat porta volutpat tincidunt maximus sapien. Phasellus gravida orci enim velit condimentum.
+
+Dui id laoreet penatibus orci sit a. Iaculis dis porttitor luctus; lacus dignissim quam commodo lorem. Nullam dictum quisque accumsan porttitor tortor fusce aenean. Aliquet quisque ultricies malesuada auctor facilisi tristique. Dolor nulla conubia ultricies odio ad. Nunc consectetur venenatis consequat nisi habitant. Praesent accumsan scelerisque morbi aliquam sociosqu auctor, nostra aenean.
+
+Mauris amet conubia egestas eu posuere nullam. Est neque dictum in, lacus aliquam ultrices vestibulum. Dapibus dis habitasse cras conubia felis nibh. Egestas nisl iaculis nostra neque enim, ridiculus praesent. Consectetur eleifend eu mus; elit sed pellentesque fringilla. Ullamcorper hendrerit nibh aptent per congue libero ultrices eget. Mollis velit ad tortor lobortis ipsum.
+
+Tristique neque justo potenti himenaeos; pellentesque nam vehicula. Maximus etiam ut nullam semper; fames curabitur quam ad morbi. Interdum curabitur platea augue porttitor a gravida. Leo imperdiet id aenean sit; habitasse quam tempus pellentesque? Nostra leo aenean amet lectus ultricies ridiculus nascetur ullamcorper. Taciti in iaculis quam nascetur proin varius eget vehicula.
+
+Mattis hendrerit tempus interdum diam elementum primis augue phasellus sociosqu. Imperdiet pulvinar imperdiet lacinia posuere class magnis. Montes viverra scelerisque laoreet sociosqu proin lacus. Nam id justo praesent curabitur nam accumsan imperdiet commodo. Sociosqu netus sapien proin interdum ac. Dapibus tempor et sodales, natoque consequat torquent.
+
+Lectus ultricies amet bibendum blandit finibus erat pellentesque. Nam quis ultrices curae; lorem gravida malesuada velit taciti enim. Facilisis fermentum suspendisse leo tristique litora dapibus rhoncus convallis. Netus iaculis eleifend viverra urna, vulputate ac convallis. Faucibus torquent dictum, nisl sed parturient libero. Ornare class habitant per consequat adipiscing rhoncus feugiat.
+
+Proin molestie nullam eros parturient parturient curabitur aliquet. Rhoncus mus aenean sem aliquet sem finibus neque rutrum commodo. Efficitur litora lobortis nascetur adipiscing curae faucibus? Bibendum leo velit augue; potenti primis malesuada lacus ipsum. Facilisi potenti facilisis nam tempor consequat. Magnis suspendisse primis duis quam; suscipit quis fermentum phasellus. Massa ridiculus habitasse ipsum arcu sit maecenas gravida nisi? Dolor egestas lacinia lacinia libero nam curae suspendisse purus. Tristique inceptos curae netus scelerisque magna hendrerit commodo quis parturient. Eget accumsan erat sociosqu vestibulum platea turpis habitasse.
+
+Maximus dignissim sed conubia a ipsum nullam condimentum dictumst. Suspendisse congue phasellus congue lacus sollicitudin senectus curae. Consequat sagittis in fringilla suscipit scelerisque suscipit. Rhoncus pharetra sodales malesuada sollicitudin lectus. Est primis pretium finibus felis pharetra nulla sapien lacinia. Nunc lorem aptent tristique quisque etiam posuere non ullamcorper. Potenti mus sed mus; non id eleifend pellentesque magnis.
+
+Iaculis morbi mattis; ornare tincidunt neque mus egestas consectetur ultrices. Porta dapibus pretium, vulputate dis amet neque. Posuere auctor lacinia maecenas ridiculus ullamcorper tempus egestas cubilia nec. Cursus nulla lacinia mi facilisi, nisl tempor. Tempus elementum laoreet magnis neque morbi felis per. Suspendisse lectus vitae nunc amet himenaeos euismod aliquam. Quisque integer dictum aenean fermentum dictumst torquent.
+
+Sociosqu per suspendisse augue phasellus velit dapibus parturient. At sit eu finibus posuere tincidunt. Phasellus duis scelerisque scelerisque taciti est venenatis. Arcu habitant augue amet eget maximus torquent. Eget gravida ut quisque ligula vel mus. Erat quis himenaeos; velit eget varius viverra interdum. Neque dapibus malesuada est a gravida libero integer aptent. Semper eleifend per at magnis, laoreet nibh orci vel ligula.
+
+Odio purus finibus inceptos malesuada duis. Neque magnis est laoreet nibh gravida sagittis ullamcorper sodales. Parturient ultricies mattis lacus risus laoreet praesent. Tincidunt eleifend quis sagittis id nascetur. Nam scelerisque varius feugiat phasellus enim mauris nam. Tortor iaculis et cras; blandit sollicitudin pellentesque justo. Nam lacinia volutpat fusce nibh mollis; himenaeos iaculis. Vulputate dictum mattis sollicitudin accumsan at hendrerit.
+
+Ipsum augue faucibus senectus porta dapibus metus. Netus sem amet nullam fermentum in dolor bibendum. Lacus quis enim vivamus enim risus elit suspendisse arcu. Penatibus proin pellentesque consequat nibh turpis fusce. Potenti sociosqu nunc tempor amet torquent. Aliquet porttitor adipiscing parturient curabitur hac? Condimentum morbi netus erat class hendrerit aptent. Placerat viverra molestie at eget donec quisque. Varius sem erat dolor, urna nunc ac duis inceptos maximus.
+
+Nostra adipiscing dapibus eros vivamus accumsan elementum curae dignissim dignissim. Iaculis quisque fusce at conubia est habitant ipsum. Porttitor libero lobortis lobortis habitasse quis quisque nunc euismod aenean. Bibendum nullam volutpat quam vitae felis sit. Mauris bibendum nulla litora nec id, elit lacinia. Orci odio nunc est ante commodo dis quis diam convallis? Mattis a per cras amet egestas ex pellentesque nascetur augue. Egestas per massa per non metus hendrerit feugiat eu?
+
+Praesent habitasse est elementum mattis potenti. Fermentum interdum enim orci dui faucibus sodales nisi mus. Tortor facilisi nunc potenti; dignissim magna varius! Risus cursus ornare tincidunt a feugiat massa cubilia. Sociosqu quis pharetra efficitur lorem ornare sapien arcu euismod. Elementum donec maecenas praesent scelerisque viverra mi natoque. Lacinia nibh eu commodo ut class blandit magnis.
+
+Ullamcorper himenaeos mollis nostra placerat quam pellentesque nibh. Curae posuere cras dis senectus fringilla congue ipsum sit. Eros maecenas duis morbi consequat himenaeos ridiculus purus erat. Nascetur maximus massa eros class phasellus integer sed gravida. Vel donec lacinia donec curabitur penatibus integer ornare. Varius quam lectus magna per a mauris.
+
+Imperdiet tempus malesuada ultrices egestas taciti nibh elit lacus. Nunc tempus tellus vitae duis rhoncus leo facilisis. Sapien nec mi lacus mi aliquet. Diam convallis fringilla libero duis integer integer dictum vel. Dolor montes nibh sapien dapibus ultrices praesent. Aeuismod phasellus taciti elit vehicula sit sociosqu. Lobortis neque urna dignissim penatibus felis vulputate. Primis magnis placerat, ligula massa facilisis nec.
+
+Duis interdum himenaeos dis nisl et tortor condimentum accumsan. Laoreet amet fusce dis malesuada iaculis maximus fringilla. Conubia mus nibh felis vestibulum ad convallis mollis. Metus vivamus lobortis habitasse id nam. Egestas pretium eu penatibus consectetur malesuada congue tempus fusce. Rutrum neque pulvinar duis ligula fermentum malesuada. Tincidunt mollis molestie imperdiet ridiculus pharetra maximus sodales curabitur.
+
+Sem nec integer fusce neque sagittis. Rutrum ipsum ante; urna enim primis consectetur nulla. Arcu ligula lectus varius magna ipsum, et dictum. Pharetra dignissim inceptos tristique natoque tempor volutpat. Luctus tristique himenaeos duis orci maecenas vel morbi. Habitasse a lacinia dignissim commodo elementum maecenas eu mollis. Fermentum tellus sem condimentum mattis elit lectus. Platea fusce arcu cras varius natoque? Volutpat tincidunt ridiculus mus massa ante dis sem ornare magna. Bibendum ornare ultrices proin efficitur; nascetur risus arcu.
+
+Orci erat orci amet mollis venenatis. Feugiat torquent ex mattis, inceptos etiam integer. Class senectus aptent vivamus, semper dolor nisi at pretium volutpat. Natoque semper enim enim primis ultricies, pharetra pulvinar. Natoque litora tortor accumsan ridiculus lacinia integer; aliquet penatibus ridiculus. Placerat vestibulum justo tristique sapien senectus, et interdum et ridiculus. Urna aenean vel himenaeos; finibus a est efficitur donec. Dictum egestas quis fusce arcu; sapien himenaeos pretium congue. Semper et sapien nisi nascetur venenatis eros integer blandit.
+
+Arcu per phasellus vehicula ad molestie? Eget arcu eget inceptos, eu ullamcorper diam. Gravida placerat elit ut hendrerit odio. Est lobortis imperdiet venenatis primis a. Facilisis integer maecenas adipiscing metus, rutrum curabitur. Dolor adipiscing himenaeos senectus tempus faucibus cras.
+
+Massa torquent torquent ullamcorper erat nisl parturient primis eu pulvinar! Ridiculus sollicitudin dis eu, laoreet praesent hendrerit platea euismod. Lacinia dignissim suspendisse sagittis eu rutrum himenaeos curae massa diam. Platea ornare ridiculus consequat curabitur augue vestibulum ridiculus. Vel consectetur vivamus accumsan risus elementum? Imperdiet nascetur efficitur aliquam habitasse nascetur. Hendrerit quisque magnis in lacinia quis mauris.
+
+Molestie fermentum blandit, viverra condimentum purus himenaeos. Fermentum congue a suspendisse ornare semper laoreet. Pharetra lacus non, iaculis ad taciti varius. Etiam nam risus vestibulum curabitur facilisis mattis, lorem hac id. Dignissim nibh tempor quam porta lectus nunc tincidunt aliquet. Tortor maximus maximus natoque nam magna torquent nec lectus mus. Vel fermentum semper vulputate penatibus vel purus.
+
+Fermentum tincidunt penatibus platea himenaeos etiam sodales ad erat posuere. Vehicula vulputate sem blandit nullam sem. Condimentum eget lacus ad malesuada augue dui justo. Lobortis quis mauris pellentesque quam interdum sagittis. Nulla ullamcorper aptent hendrerit fusce hendrerit, cras cras magna. Ex quam torquent, congue dis est vulputate lacinia. Dignissim proin lacinia platea tortor elementum nullam. Purus natoque scelerisque habitant vestibulum; metus dui neque ipsum. Pellentesque augue montes fringilla et, maecenas habitant a.
+
+Quam sapien eu scelerisque tristique, integer in rutrum gravida. Egestas lacinia nisi praesent turpis lacus maximus mus gravida. Dolor eget ultrices rhoncus velit; mollis id. Mi vulputate sed blandit nullam parturient venenatis. Neque vulputate iaculis nascetur felis fames ipsum adipiscing nullam? Vitae faucibus elit congue himenaeos orci volutpat nam. Magna tempus convallis vivamus eu semper. Egestas curabitur integer quis habitasse id taciti hac sociosqu morbi. Duis felis cursus potenti blandit cras dolor pharetra.
+
+Ultricies vel primis nec mus malesuada congue? Habitasse semper mus ultricies; fermentum himenaeos placerat sodales. Platea sapien malesuada dignissim suscipit dis cras. Etiam odio pharetra metus donec odio natoque. Cras diam curae dapibus accumsan tortor mi laoreet. Ex mollis massa inceptos inceptos adipiscing. Cras rhoncus natoque accumsan augue enim. Parturient porttitor habitant semper platea elementum dictum ornare? Sociosqu blandit nullam vivamus elementum semper himenaeos.
+
+Orci elit aliquam luctus habitant interdum. Tellus sollicitudin aliquam donec potenti praesent augue magnis auctor. Mattis faucibus iaculis etiam imperdiet lectus ad habitasse sollicitudin ac. Consequat maecenas quam dis adipiscing neque sociosqu. Ullamcorper in praesent himenaeos purus blandit nibh. Dignissim platea amet urna laoreet sociosqu lacinia accumsan consectetur risus. Adipiscing nullam arcu lobortis mi scelerisque feugiat non. Accumsan lacinia urna sit urna tincidunt nam pulvinar urna. Tellus cursus ac himenaeos sed aptent phasellus.
+
+Scelerisque curabitur eget morbi leo phasellus morbi magnis. Elit nunc non vulputate eget at. Viverra efficitur dignissim fames ut condimentum tincidunt elementum lacus egestas. Dictum phasellus leo auctor dui diam. Sollicitudin placerat elit vehicula vulputate et at eleifend ullamcorper. Primis diam hac class leo justo etiam magnis. Justo maximus venenatis facilisis egestas hendrerit aptent arcu tortor consectetur. Consequat mus curabitur nisl; blandit enim at bibendum tempor bibendum. Ad nam arcu vehicula himenaeos sociosqu eu faucibus accumsan.
+
+Maximus malesuada faucibus phasellus donec ligula. Rutrum pellentesque ultricies nullam; aenean scelerisque elementum. Porta luctus consectetur pharetra consequat varius. Ut dapibus senectus venenatis scelerisque fames ligula congue. Magna hendrerit faucibus ultricies tincidunt phasellus pellentesque, maecenas consequat! Malesuada senectus praesent sed condimentum aenean mi. Interdum sollicitudin mattis, purus vitae netus gravida. Nullam magna risus leo sit urna aenean.
+
+Ut lacinia potenti vel varius habitant mus nullam adipiscing. Commodo potenti conubia hendrerit enim massa ad blandit. Nisl a massa nunc risus, condimentum enim. Hac aenean massa lacinia lobortis ad dolor sem. Nisl ex interdum blandit pulvinar pellentesque lorem. Sapien proin malesuada netus parturient pulvinar nec. Ex semper amet sem maximus blandit cras felis. Donec tellus auctor eleifend placerat natoque. Rutrum maecenas sollicitudin nisl consectetur in nulla rhoncus. Id rhoncus nec mi non lacinia leo efficitur nisi.
+
+Dolor non phasellus id nascetur id nisi litora cubilia interdum. Lectus dolor sodales eu nulla porttitor placerat vulputate. Praesent ullamcorper consequat nulla torquent facilisis nunc. Rhoncus augue eleifend mauris erat duis varius felis. Dignissim nunc pulvinar vehicula dignissim maximus elit metus senectus. Venenatis conubia pulvinar commodo dui montes cubilia.
+
+Cursus velit lacus aenean elit conubia. Velit in inceptos enim, elit lobortis est facilisis. Suscipit cursus dictum enim libero neque dolor himenaeos eu. Porta in integer praesent quisque quis sit. Primis velit tempus sit curae vehicula porttitor. Scelerisque nisi diam vehicula mi fusce dictum. Tincidunt mus eleifend commodo ridiculus adipiscing.
+
+Pellentesque quis dignissim euismod in fermentum quam lobortis porta. Dis euismod ultricies montes odio sapien condimentum integer per. Torquent nascetur ante ante; diam ultrices nec habitant. Augue congue a conubia commodo ultricies tortor. Quis ridiculus netus vivamus dictumst efficitur parturient hendrerit. Facilisis ultrices suspendisse elit sodales eleifend maecenas tempor. Habitasse platea congue ac, pretium augue odio interdum netus. Mattis odio mi leo integer nisi diam phasellus elementum. Tortor himenaeos curabitur enim sit ac mi dictumst faucibus sociosqu.
+
+Duis ex viverra auctor praesent elit ac. Sit ex at cubilia aenean scelerisque finibus ridiculus. Hendrerit imperdiet potenti erat risus commodo. Sit donec ullamcorper facilisi neque varius, suscipit malesuada hac. Nulla lacinia pulvinar non volutpat pellentesque lobortis ultrices dis. Faucibus luctus fusce, aliquam magnis pharetra sed dui nulla viverra. Lectus hendrerit eu pellentesque nostra mauris suspendisse himenaeos. Lectus bibendum inceptos commodo nulla magnis proin.`;
+
+const searchValue = `In Congress, July 4, 1776
+
+The unanimous Declaration of the thirteen united States of America, When in the Course of human events, it becomes necessary for one people to dissolve the political bands which have connected them with another, and to assume among the powers of the earth, the separate and equal station to which the Laws of Nature and of Nature's God entitle them, a decent respect to the opinions of mankind requires that they should declare the causes which impel them to the separation.
+
+We hold these truths to be self-evident, that all men are created equal, that they are endowed by their Creator with certain unalienable Rights, that among these are Life, Liberty and the pursuit of Happiness.--That to secure these rights, Governments are instituted among Men, deriving their just powers from the consent of the governed, --That whenever any Form of Government becomes destructive of these ends, it is the Right of the People to alter or to abolish it, and to institute new Government, laying its foundation on such principles and organizing its powers in such form, as to them shall seem most likely to effect their Safety and Happiness. Prudence, indeed, will dictate that Governments long established should not be changed for light and transient causes; and accordingly all experience hath shewn, that mankind are more disposed to suffer, while evils are sufferable, than to right themselves by abolishing the forms to which they are accustomed. But when a long train of abuses and usurpations, pursuing invariably the same Object evinces a design to reduce them under absolute Despotism, it is their right, it is their duty, to throw off such Government, and to provide new Guards for their future security.--Such has been the patient sufferance of these Colonies; and such is now the necessity which constrains them to alter their former Systems of Government. The history of the present King of Great Britain is a history of repeated injuries and usurpations, all having in direct object the establishment of an absolute Tyranny over these States. To prove this, let Facts be submitted to a candid world.
+
+He has refused his Assent to Laws, the most wholesome and necessary for the public good.
+
+He has forbidden his Governors to pass Laws of immediate and pressing importance, unless suspended in their operation till his Assent should be obtained; and when so suspended, he has utterly neglected to attend to them.
+
+He has refused to pass other Laws for the accommodation of large districts of people, unless those people would relinquish the right of Representation in the Legislature, a right inestimable to them and formidable to tyrants only.
+
+He has called together legislative bodies at places unusual, uncomfortable, and distant from the depository of their public Records, for the sole purpose of fatiguing them into compliance with his measures.
+
+He has dissolved Representative Houses repeatedly, for opposing with manly firmness his invasions on the rights of the people.
+
+He has refused for a long time, after such dissolutions, to cause others to be elected; whereby the Legislative powers, incapable of Annihilation, have returned to the People at large for their exercise; the State remaining in the mean time exposed to all the dangers of invasion from without, and convulsions within.
+
+He has endeavoured to prevent the population of these States; for that purpose obstructing the Laws for Naturalization of Foreigners; refusing to pass others to encourage their migrations hither, and raising the conditions of new Appropriations of Lands.
+
+He has obstructed the Administration of Justice, by refusing his Assent to Laws for establishing Judiciary powers.
+
+He has made Judges dependent on his Will alone, for the tenure of their offices, and the amount and payment of their salaries.
+
+He has erected a multitude of New Offices, and sent hither swarms of Officers to harrass our people, and eat out their substance.
+
+He has kept among us, in times of peace, Standing Armies without the Consent of our legislatures.
+
+He has affected to render the Military independent of and superior to the Civil power.
+
+He has combined with others to subject us to a jurisdiction foreign to our constitution, and unacknowledged by our laws; giving his Assent to their Acts of pretended Legislation:
+
+For Quartering large bodies of armed troops among us:
+
+For protecting them, by a mock Trial, from punishment for any Murders which they should commit on the Inhabitants of these States:
+
+For cutting off our Trade with all parts of the world:
+
+For imposing Taxes on us without our Consent:
+
+For depriving us in many cases, of the benefits of Trial by Jury:
+
+For transporting us beyond Seas to be tried for pretended offences:
+
+For abolishing the free System of English Laws in a neighbouring Province, establishing therein an Arbitrary government, and enlarging its Boundaries so as to render it at once an example and fit instrument for introducing the same absolute rule into these Colonies:
+
+For taking away our Charters, abolishing our most valuable Laws, and altering fundamentally the Forms of our Governments:
+
+For suspending our own Legislatures, and declaring themselves invested with power to legislate for us in all cases whatsoever.
+
+He has abdicated Government here, by declaring us out of his Protection and waging War against us.
+
+He has plundered our seas, ravaged our Coasts, burnt our towns, and destroyed the lives of our people.
+
+He is at this time transporting large Armies of foreign Mercenaries to compleat the works of death, desolation and tyranny, already begun with circumstances of Cruelty & perfidy scarcely paralleled in the most barbarous ages, and totally unworthy the Head of a civilized nation.
+
+He has constrained our fellow Citizens taken Captive on the high Seas to bear Arms against their Country, to become the executioners of their friends and Brethren, or to fall themselves by their Hands.
+
+He has excited domestic insurrections amongst us, and has endeavoured to bring on the inhabitants of our frontiers, the merciless Indian Savages, whose known rule of warfare, is an undistinguished destruction of all ages, sexes and conditions.
+
+In every stage of these Oppressions We have Petitioned for Redress in the most humble terms: Our repeated Petitions have been answered only by repeated injury. A Prince, whose character is thus marked by every act which may define a Tyrant, is unfit to be the ruler of a free people.
+
+Nor have We been wanting in attentions to our Brittish brethren. We have warned them from time to time of attempts by their legislature to extend an unwarrantable jurisdiction over us. We have reminded them of the circumstances of our emigration and settlement here. We have appealed to their native justice and magnanimity, and we have conjured them by the ties of our common kindred to disavow these usurpations, which, would inevitably interrupt our connections and correspondence. They too have been deaf to the voice of justice and of consanguinity. We must, therefore, acquiesce in the necessity, which denounces our Separation, and hold them, as we hold the rest of mankind, Enemies in War, in Peace Friends.
+
+We, therefore, the Representatives of the united States of America, in General Congress, Assembled, appealing to the Supreme Judge of the world for the rectitude of our intentions, do, in the Name, and by Authority of the good People of these Colonies, solemnly publish and declare, That these United Colonies are, and of Right ought to be Free and Independent States; that they are Absolved from all Allegiance to the British Crown, and that all political connection between them and the State of Great Britain, is and ought to be totally dissolved; and that as Free and Independent States, they have full Power to levy War, conclude Peace, contract Alliances, establish Commerce, and to do all other Acts and Things which Independent States may of right do. And for the support of this Declaration, with a firm reliance on the protection of divine Providence, we mutually pledge to each other our Lives, our Fortunes and our sacred Honor.`;