@sprucelabs/data-stores 22.1.0 → 22.3.0

package/README.md

@@ -15,6 +15,7 @@ Spruce XP Documentation
 </p>
 
 <br />
+
 <p align="center">
 <a href="https://developer.spruce.ai/#/"><img width="250" src="https://raw.githubusercontent.com/sprucelabsai/data-stores/master/docs/images/read-full-docs.png" /></a>
 </p>

package/build/.spruce/errors/dataStores/notImplemented.schema.d.ts

@@ -0,0 +1,3 @@
+import { SpruceErrors } from '../errors.types';
+declare const notImplementedSchema: SpruceErrors.DataStores.NotImplementedSchema;
+export default notImplementedSchema;

package/build/.spruce/errors/dataStores/notImplemented.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+const notImplementedSchema = {
+    id: 'notImplemented',
+    namespace: 'DataStores',
+    name: 'Not implemented',
+    fields: {}
+};
+schema_1.SchemaRegistry.getInstance().trackSchema(notImplementedSchema);
+exports.default = notImplementedSchema;

package/build/.spruce/errors/errors.types.d.ts

@@ -134,6 +134,17 @@ export declare namespace SpruceErrors.DataStores {
     }
     type RecordNotFoundEntity = SchemaEntity<SpruceErrors.DataStores.RecordNotFoundSchema>;
 }
+export declare namespace SpruceErrors.DataStores {
+    interface NotImplemented {
+    }
+    interface NotImplementedSchema extends SpruceSchema.Schema {
+        id: 'notImplemented';
+        namespace: 'DataStores';
+        name: 'Not implemented';
+        fields: {};
+    }
+    type NotImplementedEntity = SchemaEntity<SpruceErrors.DataStores.NotImplementedSchema>;
+}
 export declare namespace SpruceErrors.DataStores {
     interface MongoIdMappingError {
     }

package/build/.spruce/errors/options.types.d.ts

@@ -18,6 +18,9 @@ export interface ScrambleNotConfiguredErrorOptions extends SpruceErrors.DataStor
 export interface RecordNotFoundErrorOptions extends SpruceErrors.DataStores.RecordNotFound, ISpruceErrorOptions {
     code: 'RECORD_NOT_FOUND';
 }
+export interface NotImplementedErrorOptions extends SpruceErrors.DataStores.NotImplemented, ISpruceErrorOptions {
+    code: 'NOT_IMPLEMENTED';
+}
 export interface MongoIdMappingErrorErrorOptions extends SpruceErrors.DataStores.MongoIdMappingError, ISpruceErrorOptions {
     code: 'MONGO_ID_MAPPING_ERROR';
 }
@@ -57,5 +60,5 @@ export interface DuplicateKeyErrorOptions extends SpruceErrors.DataStores.Duplic
 export interface DatabaseNotConnectedErrorOptions extends SpruceErrors.DataStores.DatabaseNotConnected, ISpruceErrorOptions {
     code: 'DATABASE_NOT_CONNECTED';
 }
-type ErrorOptions = UnknownStoreErrorErrorOptions | UnknownErrorErrorOptions | UnknownDatabaseErrorErrorOptions | UnableToConnectToDbErrorOptions | ScrambleNotConfiguredErrorOptions | RecordNotFoundErrorOptions | MongoIdMappingErrorErrorOptions | InvalidStoreNameErrorOptions | InvalidStoreErrorOptions | InvalidDbConnectionStringErrorOptions | InvalidDatabaseNameErrorOptions | InvalidConnectionStringSchemeErrorOptions | IndexNotFoundErrorOptions | IndexExistsErrorOptions | FailedToLoadStoresErrorOptions | FailedToLoadStoreErrorOptions | DuplicateRecordErrorOptions | DuplicateKeyErrorOptions | DatabaseNotConnectedErrorOptions;
+type ErrorOptions = UnknownStoreErrorErrorOptions | UnknownErrorErrorOptions | UnknownDatabaseErrorErrorOptions | UnableToConnectToDbErrorOptions | ScrambleNotConfiguredErrorOptions | RecordNotFoundErrorOptions | NotImplementedErrorOptions | MongoIdMappingErrorErrorOptions | InvalidStoreNameErrorOptions | InvalidStoreErrorOptions | InvalidDbConnectionStringErrorOptions | InvalidDatabaseNameErrorOptions | InvalidConnectionStringSchemeErrorOptions | IndexNotFoundErrorOptions | IndexExistsErrorOptions | FailedToLoadStoresErrorOptions | FailedToLoadStoreErrorOptions | DuplicateRecordErrorOptions | DuplicateKeyErrorOptions | DatabaseNotConnectedErrorOptions;
 export default ErrorOptions;

package/build/databases/MongoDatabase.d.ts

@@ -39,4 +39,5 @@ export default class MongoDatabase implements Database {
     updateOne(collection: string, query: Record<string, any>, updates: Record<string, any>): Promise<Record<string, any>>;
     upsertOne(collection: string, query: Record<string, any>, updates: Record<string, any>): Promise<Record<string, any>>;
     private generateDuplicateFieldsForError;
+    query<T>(): Promise<T>;
 }

package/build/databases/MongoDatabase.js

@@ -441,5 +441,10 @@ class MongoDatabase {
             duplicateValues,
         };
     }
+    async query() {
+        throw new SpruceError_1.default({
+            code: 'NOT_IMPLEMENTED',
+        });
+    }
 }
 exports.default = MongoDatabase;

package/build/databases/NeDbDatabase.d.ts

@@ -38,4 +38,5 @@ export default class NeDbDatabase extends AbstractMutexer implements Database {
     createIndex(collection: string, fields: string[]): Promise<void>;
     syncUniqueIndexes(collectionName: string, indexes: string[][]): Promise<void>;
     syncIndexes(collectionName: string, indexes: string[][]): Promise<void>;
+    query<T>(): Promise<T>;
 }

package/build/databases/NeDbDatabase.js

@@ -451,5 +451,10 @@ class NeDbDatabase extends AbstractMutexer_1.default {
             await this.dropIndex(collectionName, extra);
         }
     }
+    async query() {
+        throw new SpruceError_1.default({
+            code: 'NOT_IMPLEMENTED',
+        });
+    }
 }
 exports.default = NeDbDatabase;

package/build/errors/SpruceError.js

@@ -99,6 +99,9 @@ If you are on a mac, using brew is recommended: https://brew.sh`;
             case 'INVALID_CONNECTION_STRING_SCHEME':
                 message = `There is no database adapter setup for: ${options.connectionString.split('://')[0]}`;
                 break;
+            case 'NOT_IMPLEMENTED':
+                message = 'A Not implemented just happened!';
+                break;
             default:
                 message = super.friendlyMessage();
         }

package/build/errors/notImplemented.builder.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {};
+};
+export default _default;

package/build/errors/notImplemented.builder.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("@sprucelabs/schema");
+exports.default = (0, schema_1.buildErrorSchema)({
+    id: 'notImplemented',
+    name: 'Not implemented',
+    fields: {},
+});

package/build/esm/.spruce/errors/errors.types.d.ts

@@ -134,6 +134,17 @@ export declare namespace SpruceErrors.DataStores {
     }
     type RecordNotFoundEntity = SchemaEntity<SpruceErrors.DataStores.RecordNotFoundSchema>;
 }
+export declare namespace SpruceErrors.DataStores {
+    interface NotImplemented {
+    }
+    interface NotImplementedSchema extends SpruceSchema.Schema {
+        id: 'notImplemented';
+        namespace: 'DataStores';
+        name: 'Not implemented';
+        fields: {};
+    }
+    type NotImplementedEntity = SchemaEntity<SpruceErrors.DataStores.NotImplementedSchema>;
+}
 export declare namespace SpruceErrors.DataStores {
     interface MongoIdMappingError {
     }

package/build/esm/.spruce/errors/options.types.d.ts

@@ -18,6 +18,9 @@ export interface ScrambleNotConfiguredErrorOptions extends SpruceErrors.DataStor
 export interface RecordNotFoundErrorOptions extends SpruceErrors.DataStores.RecordNotFound, ISpruceErrorOptions {
     code: 'RECORD_NOT_FOUND';
 }
+export interface NotImplementedErrorOptions extends SpruceErrors.DataStores.NotImplemented, ISpruceErrorOptions {
+    code: 'NOT_IMPLEMENTED';
+}
 export interface MongoIdMappingErrorErrorOptions extends SpruceErrors.DataStores.MongoIdMappingError, ISpruceErrorOptions {
     code: 'MONGO_ID_MAPPING_ERROR';
 }
@@ -57,5 +60,5 @@ export interface DuplicateKeyErrorOptions extends SpruceErrors.DataStores.Duplic
 export interface DatabaseNotConnectedErrorOptions extends SpruceErrors.DataStores.DatabaseNotConnected, ISpruceErrorOptions {
     code: 'DATABASE_NOT_CONNECTED';
 }
-type ErrorOptions = UnknownStoreErrorErrorOptions | UnknownErrorErrorOptions | UnknownDatabaseErrorErrorOptions | UnableToConnectToDbErrorOptions | ScrambleNotConfiguredErrorOptions | RecordNotFoundErrorOptions | MongoIdMappingErrorErrorOptions | InvalidStoreNameErrorOptions | InvalidStoreErrorOptions | InvalidDbConnectionStringErrorOptions | InvalidDatabaseNameErrorOptions | InvalidConnectionStringSchemeErrorOptions | IndexNotFoundErrorOptions | IndexExistsErrorOptions | FailedToLoadStoresErrorOptions | FailedToLoadStoreErrorOptions | DuplicateRecordErrorOptions | DuplicateKeyErrorOptions | DatabaseNotConnectedErrorOptions;
+type ErrorOptions = UnknownStoreErrorErrorOptions | UnknownErrorErrorOptions | UnknownDatabaseErrorErrorOptions | UnableToConnectToDbErrorOptions | ScrambleNotConfiguredErrorOptions | RecordNotFoundErrorOptions | NotImplementedErrorOptions | MongoIdMappingErrorErrorOptions | InvalidStoreNameErrorOptions | InvalidStoreErrorOptions | InvalidDbConnectionStringErrorOptions | InvalidDatabaseNameErrorOptions | InvalidConnectionStringSchemeErrorOptions | IndexNotFoundErrorOptions | IndexExistsErrorOptions | FailedToLoadStoresErrorOptions | FailedToLoadStoreErrorOptions | DuplicateRecordErrorOptions | DuplicateKeyErrorOptions | DatabaseNotConnectedErrorOptions;
 export default ErrorOptions;

package/build/esm/databases/MongoDatabase.d.ts

@@ -39,4 +39,5 @@ export default class MongoDatabase implements Database {
     updateOne(collection: string, query: Record<string, any>, updates: Record<string, any>): Promise<Record<string, any>>;
     upsertOne(collection: string, query: Record<string, any>, updates: Record<string, any>): Promise<Record<string, any>>;
     private generateDuplicateFieldsForError;
+    query<T>(): Promise<T>;
 }

package/build/esm/databases/MongoDatabase.js

@@ -486,4 +486,11 @@ export default class MongoDatabase {
             duplicateValues,
         };
     }
+    query() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new SpruceError({
+                code: 'NOT_IMPLEMENTED',
+            });
+        });
+    }
 }

package/build/esm/databases/NeDbDatabase.d.ts

@@ -38,4 +38,5 @@ export default class NeDbDatabase extends AbstractMutexer implements Database {
     createIndex(collection: string, fields: string[]): Promise<void>;
     syncUniqueIndexes(collectionName: string, indexes: string[][]): Promise<void>;
     syncIndexes(collectionName: string, indexes: string[][]): Promise<void>;
+    query<T>(): Promise<T>;
 }

package/build/esm/databases/NeDbDatabase.js

@@ -501,4 +501,11 @@ export default class NeDbDatabase extends AbstractMutexer {
             }
         });
     }
+    query() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new SpruceError({
+                code: 'NOT_IMPLEMENTED',
+            });
+        });
+    }
 }

package/build/esm/errors/SpruceError.js

@@ -94,6 +94,9 @@ If you are on a mac, using brew is recommended: https://brew.sh`;
             case 'INVALID_CONNECTION_STRING_SCHEME':
                 message = `There is no database adapter setup for: ${options.connectionString.split('://')[0]}`;
                 break;
+            case 'NOT_IMPLEMENTED':
+                message = 'A Not implemented just happened!';
+                break;
             default:
                 message = super.friendlyMessage();
         }

package/build/esm/errors/notImplemented.builder.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    id: string;
+    name: string;
+    fields: {};
+};
+export default _default;

package/build/esm/errors/notImplemented.builder.js

@@ -0,0 +1,6 @@
+import { buildErrorSchema } from '@sprucelabs/schema';
+export default buildErrorSchema({
+    id: 'notImplemented',
+    name: 'Not implemented',
+    fields: {},
+});

package/build/esm/tests/databaseAssertUtil.d.ts

@@ -53,7 +53,7 @@ declare const databaseAssertUtil: {
     assertThrowsWithInvalidConnectionString(connect: TestConnect): Promise<void>;
     assertKnowsIfConnectionClosed(connect: TestConnect): Promise<void>;
     assertCanQueryPathWithDotSyntax(connect: TestConnect): Promise<void>;
-    assertCanQueryByGtLtGteLte(connect: TestConnect): Promise<void>;
+    assertCanQueryByGtLtGteLteNe(connect: TestConnect): Promise<void>;
     assertCanFindWithNe(connect: TestConnect): Promise<void>;
     assertCanFindWithIn(connect: TestConnect): Promise<void>;
     assertCanFindWithBooleanField(connect: TestConnect): Promise<void>;

package/build/esm/tests/databaseAssertUtil.js

@@ -55,7 +55,7 @@ const databaseAssertUtil = {
                 'assertCanLimitResults',
                 'assertCanLimitResultsToZero',
                 'assertCanFindWithBooleanField',
-                'assertCanQueryByGtLtGteLte',
+                'assertCanQueryByGtLtGteLteNe',
                 'assertCanQueryPathWithDotSyntax',
                 'assertCanReturnOnlySelectFields',
                 'assertCanSearchByRegex',
@@ -1162,25 +1162,29 @@ const databaseAssertUtil = {
             yield this.shutdown(db);
         });
     },
-    assertCanQueryByGtLtGteLte(connect) {
+    assertCanQueryByGtLtGteLteNe(connect) {
         return __awaiter(this, void 0, void 0, function* () {
             const db = yield connectToDabatase(connect);
             const created = yield db.create(this.collectionName, [
                 {
                     number: 1,
                     name: generateId(),
+                    someField: null,
                 },
                 {
                     number: 2,
                     name: generateId(),
+                    someField: 'test',
                 },
                 {
                     number: 3,
                     name: generateId(),
+                    someField: 'test',
                 },
                 {
                     number: 4,
                     name: generateId(),
+                    someField: 'test',
                 },
             ]);
             const gtMatches = yield db.find(this.collectionName, {
@@ -1207,6 +1211,19 @@ const databaseAssertUtil = {
             assert.isEqual(lteMatches[0].number, 1);
             assert.isEqual(lteMatches[1].number, 2);
             assert.isEqual(lteMatches[2].number, 3);
+            const notMatches = yield db.find(this.collectionName, {
+                id: {
+                    $ne: created[0].id,
+                },
+            });
+            assert.isNotEqual(notMatches[0].id, created[0].id);
+            assert.isLength(notMatches, created.length - 1);
+            const notNull = yield db.find(this.collectionName, {
+                someField: {
+                    $ne: null,
+                },
+            });
+            assert.isLength(notNull, created.length - 1);
             yield this.shutdown(db);
         });
     },

package/build/esm/tests/pluckAssertionMethods.d.ts

@@ -1,2 +1,2 @@
 import databaseAssertUtil from './databaseAssertUtil';
-export default function pluckAssertionMethods(util: typeof databaseAssertUtil): ("collectionName" | "assertThrowsWithInvalidConnectionString" | "assertThrowsWhenCantConnect" | "assertThrowsWithBadDatabaseName" | "assertEmptyDatabaseReturnsEmptyArray" | "assertKnowsIfConnectionClosed" | "assertFindOneOnEmptyDatabaseReturnsNull" | "assertCanSortDesc" | "assertCanSortAsc" | "assertCanSortById" | "assertCanQueryWithOr" | "generateIdDifferentEachTime" | "assertInsertingGeneratesId" | "assertCanCreateMany" | "assertCanLimitResults" | "assertCanCreateWithObjectField" | "assertCanCountOnId" | "assertCanCount" | "assertThrowsWhenUpdatingRecordNotFound" | "assertCanUpdate" | "assertCanUpdateMany" | "assertCanPushOntoArrayValue" | "canUpdateWithObjectField" | "canUpdateFieldInObjectFieldWithTargettedWhere" | "assertCanSaveAndGetNullAndUndefined" | "assertCanUpsertOne" | "assertCanUpsertNull" | "assertCanPushToArrayOnUpsert" | "assertCanLimitResultsToZero" | "assertCanFindWithBooleanField" | "assertCanQueryByGtLtGteLte" | "assertCanQueryPathWithDotSyntax" | "assertCanReturnOnlySelectFields" | "assertCanSearchByRegex" | "assertCanFindWithNe" | "assertCanFindWithIn" | "assertCanDeleteRecord" | "assertCanDeleteOne" | "assertHasNoUniqueIndexToStart" | "assertCanCreateUniqueIndex" | "assertCanCreateMultiFieldUniqueIndex" | "assertCantCreateUniqueIndexTwice" | "assertCanDropUniqueIndex" | "assertCanDropCompoundUniqueIndex" | "assertCantDropUniqueIndexThatDoesntExist" | "assertCantDropIndexWhenNoIndexExists" | "assertCantDropCompoundUniqueIndexThatDoesntExist" | "assertSyncingUniqueIndexsAddsMissingIndexes" | "assertSyncingUniqueIndexsSkipsExistingIndexs" | "assertSyncingUniqueIndexesRemovesExtraIndexes" | "assertSyncingUniqueIndexesIsRaceProof" | "assertSyncingIndexesDoesNotAddAndRemove" | "assertUniqueIndexBlocksDuplicates" | "assertDuplicateKeyThrowsOnInsert" | "assertSettingUniqueIndexViolationThrowsSpruceError" | "assertCanCreateUniqueIndexOnNestedField" | "assertUpsertWithUniqueIndex" | "assertNestedFieldIndexUpdates" | "assertHasNoIndexToStart" | "assertCanCreateIndex" | "assertCantCreateSameIndexTwice" | "assertCanCreateMultiFieldIndex" | "assertCanDropIndex" | "assertCanDropCompoundIndex" | "assertCantDropCompoundIndexThatDoesNotExist" | "assertSyncIndexesSkipsExisting" | "assertSyncIndexesRemovesExtraIndexes" | "assertSyncIndexesHandlesRaceConditions" | "assertSyncIndexesDoesNotRemoveExisting" | "assertDuplicateFieldsWithMultipleUniqueIndexesWorkAsExpected" | "runSuite" | "_getFilteredIndexes" | "_filterIdIndex" | "_assertUpdateUpdatedRightNumberOfRecords" | "shutdown" | "_assertThrowsExpectedNotFoundOnUpdateOne" | "_assert$orReturnsExpectedTotalRecords" | "_assertCanCreateMultiFieldIndex")[];
+export default function pluckAssertionMethods(util: typeof databaseAssertUtil): ("collectionName" | "assertThrowsWithInvalidConnectionString" | "assertThrowsWhenCantConnect" | "assertThrowsWithBadDatabaseName" | "assertEmptyDatabaseReturnsEmptyArray" | "assertKnowsIfConnectionClosed" | "assertFindOneOnEmptyDatabaseReturnsNull" | "assertCanSortDesc" | "assertCanSortAsc" | "assertCanSortById" | "assertCanQueryWithOr" | "generateIdDifferentEachTime" | "assertInsertingGeneratesId" | "assertCanCreateMany" | "assertCanLimitResults" | "assertCanCreateWithObjectField" | "assertCanCountOnId" | "assertCanCount" | "assertThrowsWhenUpdatingRecordNotFound" | "assertCanUpdate" | "assertCanUpdateMany" | "assertCanPushOntoArrayValue" | "canUpdateWithObjectField" | "canUpdateFieldInObjectFieldWithTargettedWhere" | "assertCanSaveAndGetNullAndUndefined" | "assertCanUpsertOne" | "assertCanUpsertNull" | "assertCanPushToArrayOnUpsert" | "assertCanLimitResultsToZero" | "assertCanFindWithBooleanField" | "assertCanQueryByGtLtGteLteNe" | "assertCanQueryPathWithDotSyntax" | "assertCanReturnOnlySelectFields" | "assertCanSearchByRegex" | "assertCanFindWithNe" | "assertCanFindWithIn" | "assertCanDeleteRecord" | "assertCanDeleteOne" | "assertHasNoUniqueIndexToStart" | "assertCanCreateUniqueIndex" | "assertCanCreateMultiFieldUniqueIndex" | "assertCantCreateUniqueIndexTwice" | "assertCanDropUniqueIndex" | "assertCanDropCompoundUniqueIndex" | "assertCantDropUniqueIndexThatDoesntExist" | "assertCantDropIndexWhenNoIndexExists" | "assertCantDropCompoundUniqueIndexThatDoesntExist" | "assertSyncingUniqueIndexsAddsMissingIndexes" | "assertSyncingUniqueIndexsSkipsExistingIndexs" | "assertSyncingUniqueIndexesRemovesExtraIndexes" | "assertSyncingUniqueIndexesIsRaceProof" | "assertSyncingIndexesDoesNotAddAndRemove" | "assertUniqueIndexBlocksDuplicates" | "assertDuplicateKeyThrowsOnInsert" | "assertSettingUniqueIndexViolationThrowsSpruceError" | "assertCanCreateUniqueIndexOnNestedField" | "assertUpsertWithUniqueIndex" | "assertNestedFieldIndexUpdates" | "assertHasNoIndexToStart" | "assertCanCreateIndex" | "assertCantCreateSameIndexTwice" | "assertCanCreateMultiFieldIndex" | "assertCanDropIndex" | "assertCanDropCompoundIndex" | "assertCantDropCompoundIndexThatDoesNotExist" | "assertSyncIndexesSkipsExisting" | "assertSyncIndexesRemovesExtraIndexes" | "assertSyncIndexesHandlesRaceConditions" | "assertSyncIndexesDoesNotRemoveExisting" | "assertDuplicateFieldsWithMultipleUniqueIndexesWorkAsExpected" | "runSuite" | "_getFilteredIndexes" | "_filterIdIndex" | "_assertUpdateUpdatedRightNumberOfRecords" | "shutdown" | "_assertThrowsExpectedNotFoundOnUpdateOne" | "_assert$orReturnsExpectedTotalRecords" | "_assertCanCreateMultiFieldIndex")[];

package/build/esm/types/database.types.d.ts

@@ -27,6 +27,7 @@ export interface Database {
     count(collection: string, query?: Record<string, any>): Promise<number>;
     createUniqueIndex(collection: string, fields: UniqueIndex): Promise<void>;
     createIndex(collection: string, fields: Index): Promise<void>;
+    query<T>(query: string): Promise<T>;
 }
 export interface DatabaseOptions {
     dbName?: string;

package/build/tests/databaseAssertUtil.d.ts

@@ -53,7 +53,7 @@ declare const databaseAssertUtil: {
     assertThrowsWithInvalidConnectionString(connect: TestConnect): Promise<void>;
     assertKnowsIfConnectionClosed(connect: TestConnect): Promise<void>;
     assertCanQueryPathWithDotSyntax(connect: TestConnect): Promise<void>;
-    assertCanQueryByGtLtGteLte(connect: TestConnect): Promise<void>;
+    assertCanQueryByGtLtGteLteNe(connect: TestConnect): Promise<void>;
     assertCanFindWithNe(connect: TestConnect): Promise<void>;
     assertCanFindWithIn(connect: TestConnect): Promise<void>;
     assertCanFindWithBooleanField(connect: TestConnect): Promise<void>;

package/build/tests/databaseAssertUtil.js

@@ -50,7 +50,7 @@ const databaseAssertUtil = {
             'assertCanLimitResults',
             'assertCanLimitResultsToZero',
             'assertCanFindWithBooleanField',
-            'assertCanQueryByGtLtGteLte',
+            'assertCanQueryByGtLtGteLteNe',
             'assertCanQueryPathWithDotSyntax',
             'assertCanReturnOnlySelectFields',
             'assertCanSearchByRegex',
@@ -1056,24 +1056,28 @@ const databaseAssertUtil = {
         test_utils_1.assert.isEqual(secondMatch.name, 'second');
         await this.shutdown(db);
     },
-    async assertCanQueryByGtLtGteLte(connect) {
+    async assertCanQueryByGtLtGteLteNe(connect) {
         const db = await connectToDabatase(connect);
         const created = await db.create(this.collectionName, [
             {
                 number: 1,
                 name: (0, generateId_1.default)(),
+                someField: null,
             },
             {
                 number: 2,
                 name: (0, generateId_1.default)(),
+                someField: 'test',
             },
             {
                 number: 3,
                 name: (0, generateId_1.default)(),
+                someField: 'test',
             },
             {
                 number: 4,
                 name: (0, generateId_1.default)(),
+                someField: 'test',
             },
         ]);
         const gtMatches = await db.find(this.collectionName, {
@@ -1100,6 +1104,19 @@ const databaseAssertUtil = {
         test_utils_1.assert.isEqual(lteMatches[0].number, 1);
         test_utils_1.assert.isEqual(lteMatches[1].number, 2);
         test_utils_1.assert.isEqual(lteMatches[2].number, 3);
+        const notMatches = await db.find(this.collectionName, {
+            id: {
+                $ne: created[0].id,
+            },
+        });
+        test_utils_1.assert.isNotEqual(notMatches[0].id, created[0].id);
+        test_utils_1.assert.isLength(notMatches, created.length - 1);
+        const notNull = await db.find(this.collectionName, {
+            someField: {
+                $ne: null,
+            },
+        });
+        test_utils_1.assert.isLength(notNull, created.length - 1);
         await this.shutdown(db);
     },
     async assertCanFindWithNe(connect) {

package/build/tests/pluckAssertionMethods.d.ts

@@ -1,2 +1,2 @@
 import databaseAssertUtil from './databaseAssertUtil';
-export default function pluckAssertionMethods(util: typeof databaseAssertUtil): ("collectionName" | "assertThrowsWithInvalidConnectionString" | "assertThrowsWhenCantConnect" | "assertThrowsWithBadDatabaseName" | "assertEmptyDatabaseReturnsEmptyArray" | "assertKnowsIfConnectionClosed" | "assertFindOneOnEmptyDatabaseReturnsNull" | "assertCanSortDesc" | "assertCanSortAsc" | "assertCanSortById" | "assertCanQueryWithOr" | "generateIdDifferentEachTime" | "assertInsertingGeneratesId" | "assertCanCreateMany" | "assertCanLimitResults" | "assertCanCreateWithObjectField" | "assertCanCountOnId" | "assertCanCount" | "assertThrowsWhenUpdatingRecordNotFound" | "assertCanUpdate" | "assertCanUpdateMany" | "assertCanPushOntoArrayValue" | "canUpdateWithObjectField" | "canUpdateFieldInObjectFieldWithTargettedWhere" | "assertCanSaveAndGetNullAndUndefined" | "assertCanUpsertOne" | "assertCanUpsertNull" | "assertCanPushToArrayOnUpsert" | "assertCanLimitResultsToZero" | "assertCanFindWithBooleanField" | "assertCanQueryByGtLtGteLte" | "assertCanQueryPathWithDotSyntax" | "assertCanReturnOnlySelectFields" | "assertCanSearchByRegex" | "assertCanFindWithNe" | "assertCanFindWithIn" | "assertCanDeleteRecord" | "assertCanDeleteOne" | "assertHasNoUniqueIndexToStart" | "assertCanCreateUniqueIndex" | "assertCanCreateMultiFieldUniqueIndex" | "assertCantCreateUniqueIndexTwice" | "assertCanDropUniqueIndex" | "assertCanDropCompoundUniqueIndex" | "assertCantDropUniqueIndexThatDoesntExist" | "assertCantDropIndexWhenNoIndexExists" | "assertCantDropCompoundUniqueIndexThatDoesntExist" | "assertSyncingUniqueIndexsAddsMissingIndexes" | "assertSyncingUniqueIndexsSkipsExistingIndexs" | "assertSyncingUniqueIndexesRemovesExtraIndexes" | "assertSyncingUniqueIndexesIsRaceProof" | "assertSyncingIndexesDoesNotAddAndRemove" | "assertUniqueIndexBlocksDuplicates" | "assertDuplicateKeyThrowsOnInsert" | "assertSettingUniqueIndexViolationThrowsSpruceError" | "assertCanCreateUniqueIndexOnNestedField" | "assertUpsertWithUniqueIndex" | "assertNestedFieldIndexUpdates" | "assertHasNoIndexToStart" | "assertCanCreateIndex" | "assertCantCreateSameIndexTwice" | "assertCanCreateMultiFieldIndex" | "assertCanDropIndex" | "assertCanDropCompoundIndex" | "assertCantDropCompoundIndexThatDoesNotExist" | "assertSyncIndexesSkipsExisting" | "assertSyncIndexesRemovesExtraIndexes" | "assertSyncIndexesHandlesRaceConditions" | "assertSyncIndexesDoesNotRemoveExisting" | "assertDuplicateFieldsWithMultipleUniqueIndexesWorkAsExpected" | "runSuite" | "_getFilteredIndexes" | "_filterIdIndex" | "_assertUpdateUpdatedRightNumberOfRecords" | "shutdown" | "_assertThrowsExpectedNotFoundOnUpdateOne" | "_assert$orReturnsExpectedTotalRecords" | "_assertCanCreateMultiFieldIndex")[];
+export default function pluckAssertionMethods(util: typeof databaseAssertUtil): ("collectionName" | "assertThrowsWithInvalidConnectionString" | "assertThrowsWhenCantConnect" | "assertThrowsWithBadDatabaseName" | "assertEmptyDatabaseReturnsEmptyArray" | "assertKnowsIfConnectionClosed" | "assertFindOneOnEmptyDatabaseReturnsNull" | "assertCanSortDesc" | "assertCanSortAsc" | "assertCanSortById" | "assertCanQueryWithOr" | "generateIdDifferentEachTime" | "assertInsertingGeneratesId" | "assertCanCreateMany" | "assertCanLimitResults" | "assertCanCreateWithObjectField" | "assertCanCountOnId" | "assertCanCount" | "assertThrowsWhenUpdatingRecordNotFound" | "assertCanUpdate" | "assertCanUpdateMany" | "assertCanPushOntoArrayValue" | "canUpdateWithObjectField" | "canUpdateFieldInObjectFieldWithTargettedWhere" | "assertCanSaveAndGetNullAndUndefined" | "assertCanUpsertOne" | "assertCanUpsertNull" | "assertCanPushToArrayOnUpsert" | "assertCanLimitResultsToZero" | "assertCanFindWithBooleanField" | "assertCanQueryByGtLtGteLteNe" | "assertCanQueryPathWithDotSyntax" | "assertCanReturnOnlySelectFields" | "assertCanSearchByRegex" | "assertCanFindWithNe" | "assertCanFindWithIn" | "assertCanDeleteRecord" | "assertCanDeleteOne" | "assertHasNoUniqueIndexToStart" | "assertCanCreateUniqueIndex" | "assertCanCreateMultiFieldUniqueIndex" | "assertCantCreateUniqueIndexTwice" | "assertCanDropUniqueIndex" | "assertCanDropCompoundUniqueIndex" | "assertCantDropUniqueIndexThatDoesntExist" | "assertCantDropIndexWhenNoIndexExists" | "assertCantDropCompoundUniqueIndexThatDoesntExist" | "assertSyncingUniqueIndexsAddsMissingIndexes" | "assertSyncingUniqueIndexsSkipsExistingIndexs" | "assertSyncingUniqueIndexesRemovesExtraIndexes" | "assertSyncingUniqueIndexesIsRaceProof" | "assertSyncingIndexesDoesNotAddAndRemove" | "assertUniqueIndexBlocksDuplicates" | "assertDuplicateKeyThrowsOnInsert" | "assertSettingUniqueIndexViolationThrowsSpruceError" | "assertCanCreateUniqueIndexOnNestedField" | "assertUpsertWithUniqueIndex" | "assertNestedFieldIndexUpdates" | "assertHasNoIndexToStart" | "assertCanCreateIndex" | "assertCantCreateSameIndexTwice" | "assertCanCreateMultiFieldIndex" | "assertCanDropIndex" | "assertCanDropCompoundIndex" | "assertCantDropCompoundIndexThatDoesNotExist" | "assertSyncIndexesSkipsExisting" | "assertSyncIndexesRemovesExtraIndexes" | "assertSyncIndexesHandlesRaceConditions" | "assertSyncIndexesDoesNotRemoveExisting" | "assertDuplicateFieldsWithMultipleUniqueIndexesWorkAsExpected" | "runSuite" | "_getFilteredIndexes" | "_filterIdIndex" | "_assertUpdateUpdatedRightNumberOfRecords" | "shutdown" | "_assertThrowsExpectedNotFoundOnUpdateOne" | "_assert$orReturnsExpectedTotalRecords" | "_assertCanCreateMultiFieldIndex")[];

package/build/types/database.types.d.ts

@@ -27,6 +27,7 @@ export interface Database {
     count(collection: string, query?: Record<string, any>): Promise<number>;
     createUniqueIndex(collection: string, fields: UniqueIndex): Promise<void>;
     createIndex(collection: string, fields: Index): Promise<void>;
+    query<T>(query: string): Promise<T>;
 }
 export interface DatabaseOptions {
     dbName?: string;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "22.1.0",
+  "version": "22.3.0",
   "files": [
     "build/**/*",
     "!build/__tests__",