@sprucelabs/data-stores 25.2.3 → 25.3.0

package/README.md

@@ -12,7 +12,6 @@ Spruce XP Documentation
 <p align="center">
 <img align="center" width="80%" src="https://raw.githubusercontent.com/sprucelabsai/data-stores/master/docs/images/sprucebot-message.png">
 </p>
-
 <br />
 
 <p align="center">

package/build/cursors/BatchCursor.d.ts

@@ -6,8 +6,10 @@ export default class BatchCursorImpl<ResponseRecord> implements BatchCursor<Resp
     private store;
     private options?;
     private query?;
+    private nextResults?;
     private constructor();
     static Cursor<Response>(store: AbstractStore<Schema>, query?: Record<string, any>, options?: FindBatchOptions): BatchCursor<Response>;
+    setOnNextResults(cb: (results: ResponseRecord[]) => never[]): void;
     next(): Promise<ResponseRecord[] | null>;
     private bumpCursorPosition;
 }
@@ -15,5 +17,6 @@ export interface FindBatchOptions<IncludePrivateFields extends boolean = true, F
     batchSize?: number;
 }
 export interface BatchCursor<ResponseRecord> {
+    setOnNextResults(cb: (results: ResponseRecord[]) => never[]): void;
     next(): Promise<ResponseRecord[] | null>;
 }

package/build/cursors/BatchCursor.js

@@ -20,9 +20,16 @@ class BatchCursorImpl {
     static Cursor(store, query, options) {
         return new this(store, query, options);
     }
+    setOnNextResults(cb) {
+        this.nextResults = cb;
+    }
     async next() {
         var _a;
         const _b = (_a = this.options) !== null && _a !== void 0 ? _a : {}, { batchSize = 10 } = _b, rest = __rest(_b, ["batchSize"]);
+        if (this.nextResults) {
+            //@ts-ignore
+            return this.nextResults();
+        }
         const matches = await this.store.find(Object.assign({}, this.query), {
             limit: batchSize,
         }, Object.assign({}, rest));

package/build/esm/cursors/BatchCursor.d.ts

@@ -6,8 +6,10 @@ export default class BatchCursorImpl<ResponseRecord> implements BatchCursor<Resp
     private store;
     private options?;
     private query?;
+    private nextResults?;
     private constructor();
     static Cursor<Response>(store: AbstractStore<Schema>, query?: Record<string, any>, options?: FindBatchOptions): BatchCursor<Response>;
+    setOnNextResults(cb: (results: ResponseRecord[]) => never[]): void;
     next(): Promise<ResponseRecord[] | null>;
     private bumpCursorPosition;
 }
@@ -15,5 +17,6 @@ export interface FindBatchOptions<IncludePrivateFields extends boolean = true, F
     batchSize?: number;
 }
 export interface BatchCursor<ResponseRecord> {
+    setOnNextResults(cb: (results: ResponseRecord[]) => never[]): void;
     next(): Promise<ResponseRecord[] | null>;
 }

package/build/esm/cursors/BatchCursor.js

@@ -27,10 +27,17 @@ export default class BatchCursorImpl {
     static Cursor(store, query, options) {
         return new this(store, query, options);
     }
+    setOnNextResults(cb) {
+        this.nextResults = cb;
+    }
     next() {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const _b = (_a = this.options) !== null && _a !== void 0 ? _a : {}, { batchSize = 10 } = _b, rest = __rest(_b, ["batchSize"]);
+            if (this.nextResults) {
+                //@ts-ignore
+                return this.nextResults();
+            }
             const matches = yield this.store.find(Object.assign({}, this.query), {
                 limit: batchSize,
             }, Object.assign({}, rest));

package/build/esm/index.d.ts

@@ -20,6 +20,10 @@ export { default as CursorPager } from './cursors/CursorPager';
 export * from './cursors/CursorPager';
 export { default as CursorPagerFaker } from './cursors/CursorPagerFaker';
 export * from './cursors/CursorPager';
+/**
+ * @deprecated databaseAssertUtil -> databaseAssert
+ */
 export { default as databaseAssertUtil } from './tests/databaseAssertUtil';
+export { default as databaseAssert } from './tests/databaseAssertUtil';
 export { default as BatchCursor } from './cursors/BatchCursor';
 export * from './cursors/BatchCursor';

package/build/esm/index.js

@@ -20,6 +20,10 @@ export { default as CursorPager } from './cursors/CursorPager.js';
 export * from './cursors/CursorPager.js';
 export { default as CursorPagerFaker } from './cursors/CursorPagerFaker.js';
 export * from './cursors/CursorPager.js';
+/**
+ * @deprecated databaseAssertUtil -> databaseAssert
+ */
 export { default as databaseAssertUtil } from './tests/databaseAssertUtil.js';
+export { default as databaseAssert } from './tests/databaseAssertUtil.js';
 export { default as BatchCursor } from './cursors/BatchCursor.js';
 export * from './cursors/BatchCursor.js';

package/build/esm/stores/AbstractStore.d.ts

@@ -16,6 +16,7 @@ export default abstract class AbstractStore<FullSchema extends Schema, CreateSch
     protected scrambleFields?: string[];
     protected db: Database;
     protected primaryFieldNames: string[];
+    protected shouldMapLowerCaseToCamelCase: boolean;
     initialize?(): Promise<void>;
     protected prepareRecord?<IncludePrivateFields extends boolean, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>>(record: DatabaseRecord, options?: PrepareOptions<IncludePrivateFields, FullSchema, F>): Promise<PrepareResults<FullSchema, IncludePrivateFields>>;
     protected willCreate?(values: CreateRecord): Promise<Omit<DatabaseRecord, 'id'>>;
@@ -27,8 +28,10 @@ export default abstract class AbstractStore<FullSchema extends Schema, CreateSch
     }): Promise<Partial<DatabaseRecord>>;
     protected constructor(db: Database, collectionName?: string);
     protected setCollectionName(name: string): void;
+    getDb(): Database;
     getCollectionName(): string;
     protected prepareAndNormalizeRecord<IncludePrivateFields extends boolean = true, CreateEntityInstances extends boolean = false, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>, PF extends SchemaPublicFieldNames<FullSchema> = SchemaPublicFieldNames<FullSchema>>(record: any, options?: PrepareOptions<IncludePrivateFields, FullSchema, F>): Promise<Response<FullSchema, CreateEntityInstances, IncludePrivateFields, PF, F>>;
+    private mapCasing;
     create<IncludePrivateFields extends boolean = true, CreateEntityInstances extends boolean = false, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>, PF extends SchemaPublicFieldNames<FullSchema> = SchemaPublicFieldNames<FullSchema>>(values: CreateRecord[], options?: PrepareOptions<CreateEntityInstances, FullSchema, F>): Promise<Response<FullSchema, CreateEntityInstances, IncludePrivateFields, PF, F>[]>;
     createOne<CreateEntityInstances extends boolean, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>>(values: CreateRecord, options?: PrepareOptions<CreateEntityInstances, FullSchema, F>): Promise<SchemaValues<FullSchema, false, CreateEntityInstances, false, F, SchemaPublicFieldNames<FullSchema>>>;
     private get primaryFieldName();

package/build/esm/stores/AbstractStore.js

@@ -29,6 +29,7 @@ export default class AbstractStore extends AbstractMutexer {
     constructor(db, collectionName) {
         super();
         this.primaryFieldNames = ['id'];
+        this.shouldMapLowerCaseToCamelCase = false;
         this.db = db;
         if (collectionName) {
             this.setCollectionName(collectionName);
@@ -37,6 +38,9 @@ export default class AbstractStore extends AbstractMutexer {
     setCollectionName(name) {
         this.collectionName = name;
     }
+    getDb() {
+        return this.db;
+    }
     getCollectionName() {
         return this.collectionName;
     }
@@ -49,9 +53,23 @@ export default class AbstractStore extends AbstractMutexer {
             if (isScrambled) {
                 return preparedRecord;
             }
+            if (this.shouldMapLowerCaseToCamelCase) {
+                this.mapCasing(preparedRecord);
+            }
             return normalizeSchemaValues(this.fullSchema, preparedRecord, Object.assign(Object.assign({}, options), { fields: options.includeFields, shouldIncludePrivateFields: options.shouldIncludePrivateFields === true, shouldCreateEntityInstances: false, shouldIncludeNullAndUndefinedFields: false }));
         });
     }
+    mapCasing(preparedRecord) {
+        var _a;
+        const fields = (_a = this.fullSchema.fields) !== null && _a !== void 0 ? _a : {};
+        Object.keys(fields).forEach((f) => {
+            const lowerF = f.toLowerCase();
+            if (lowerF !== f && lowerF in preparedRecord) {
+                preparedRecord[f] = preparedRecord[lowerF];
+                delete preparedRecord[lowerF];
+            }
+        });
+    }
     create(values, options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {

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

@@ -1,3 +1,4 @@
+import AbstractStore from '../stores/AbstractStore';
 import { Database, Index, TestConnect, UniqueIndex } from '../types/database.types';
 declare const databaseAssertUtil: {
     collectionName: string;
@@ -78,5 +79,6 @@ declare const databaseAssertUtil: {
     _assertThrowsExpectedNotFoundOnUpdateOne(db: Database, query: Record<string, any>): Promise<void>;
     _assert$orReturnsExpectedTotalRecords(db: Database, $or: Record<string, any>[], expected: number): Promise<void>;
     _assertCanCreateMultiFieldIndex(connect: TestConnect, fields: string[]): Promise<void>;
+    assertHasLowerCaseToCamelCaseMappingEnabled(store: AbstractStore<any>): void;
 };
 export default databaseAssertUtil;

package/build/esm/tests/databaseAssertUtil.js

@@ -1696,6 +1696,11 @@ const databaseAssertUtil = {
             yield this.shutdown(db);
         });
     },
+    assertHasLowerCaseToCamelCaseMappingEnabled(store) {
+        assert.isTrue(
+        //@ts-ignore
+        store.shouldMapLowerCaseToCamelCase, `Your data store is not mapping lower case to camel case field names! To make that work, add protected shouldMapLowerCaseToCamelCase = true to your store.`);
+    },
 };
 export default databaseAssertUtil;
 function assertCantCreateUniqueIndexTwice(db, collectionName, fields, expectedTotalUniqueIndexes) {

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" | "assertCanUpdateWithObjectField" | "assertCanUpdateFieldInObjectFieldWithTargettedWhere" | "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")[];
+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" | "assertCanUpdateWithObjectField" | "assertCanUpdateFieldInObjectFieldWithTargettedWhere" | "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" | "assertHasLowerCaseToCamelCaseMappingEnabled")[];

package/build/index.d.ts

@@ -20,6 +20,10 @@ export { default as CursorPager } from './cursors/CursorPager';
 export * from './cursors/CursorPager';
 export { default as CursorPagerFaker } from './cursors/CursorPagerFaker';
 export * from './cursors/CursorPager';
+/**
+ * @deprecated databaseAssertUtil -> databaseAssert
+ */
 export { default as databaseAssertUtil } from './tests/databaseAssertUtil';
+export { default as databaseAssert } from './tests/databaseAssertUtil';
 export { default as BatchCursor } from './cursors/BatchCursor';
 export * from './cursors/BatchCursor';

package/build/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BatchCursor = exports.databaseAssertUtil = exports.CursorPagerFaker = exports.CursorPager = exports.generateId = exports.DataStoresError = exports.mongoUtil = exports.NeDbDatabase = exports.MongoDatabase = exports.StoreLoader = exports.DatabaseFactory = exports.StoreFactory = exports.AbstractStore = exports.DatabaseFixture = exports.AbstractDatabaseTest = void 0;
+exports.BatchCursor = exports.databaseAssert = exports.databaseAssertUtil = exports.CursorPagerFaker = exports.CursorPager = exports.generateId = exports.DataStoresError = exports.mongoUtil = exports.NeDbDatabase = exports.MongoDatabase = exports.StoreLoader = exports.DatabaseFactory = exports.StoreFactory = exports.AbstractStore = exports.DatabaseFixture = exports.AbstractDatabaseTest = void 0;
 var AbstractDatabaseTest_1 = require("./tests/AbstractDatabaseTest");
 Object.defineProperty(exports, "AbstractDatabaseTest", { enumerable: true, get: function () { return __importDefault(AbstractDatabaseTest_1).default; } });
 var DatabaseFixture_1 = require("./fixtures/DatabaseFixture");
@@ -53,8 +53,13 @@ __exportStar(require("./cursors/CursorPager"), exports);
 var CursorPagerFaker_1 = require("./cursors/CursorPagerFaker");
 Object.defineProperty(exports, "CursorPagerFaker", { enumerable: true, get: function () { return __importDefault(CursorPagerFaker_1).default; } });
 __exportStar(require("./cursors/CursorPager"), exports);
+/**
+ * @deprecated databaseAssertUtil -> databaseAssert
+ */
 var databaseAssertUtil_1 = require("./tests/databaseAssertUtil");
 Object.defineProperty(exports, "databaseAssertUtil", { enumerable: true, get: function () { return __importDefault(databaseAssertUtil_1).default; } });
+var databaseAssertUtil_2 = require("./tests/databaseAssertUtil");
+Object.defineProperty(exports, "databaseAssert", { enumerable: true, get: function () { return __importDefault(databaseAssertUtil_2).default; } });
 var BatchCursor_1 = require("./cursors/BatchCursor");
 Object.defineProperty(exports, "BatchCursor", { enumerable: true, get: function () { return __importDefault(BatchCursor_1).default; } });
 __exportStar(require("./cursors/BatchCursor"), exports);

package/build/stores/AbstractStore.d.ts

@@ -16,6 +16,7 @@ export default abstract class AbstractStore<FullSchema extends Schema, CreateSch
     protected scrambleFields?: string[];
     protected db: Database;
     protected primaryFieldNames: string[];
+    protected shouldMapLowerCaseToCamelCase: boolean;
     initialize?(): Promise<void>;
     protected prepareRecord?<IncludePrivateFields extends boolean, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>>(record: DatabaseRecord, options?: PrepareOptions<IncludePrivateFields, FullSchema, F>): Promise<PrepareResults<FullSchema, IncludePrivateFields>>;
     protected willCreate?(values: CreateRecord): Promise<Omit<DatabaseRecord, 'id'>>;
@@ -27,8 +28,10 @@ export default abstract class AbstractStore<FullSchema extends Schema, CreateSch
     }): Promise<Partial<DatabaseRecord>>;
     protected constructor(db: Database, collectionName?: string);
     protected setCollectionName(name: string): void;
+    getDb(): Database;
     getCollectionName(): string;
     protected prepareAndNormalizeRecord<IncludePrivateFields extends boolean = true, CreateEntityInstances extends boolean = false, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>, PF extends SchemaPublicFieldNames<FullSchema> = SchemaPublicFieldNames<FullSchema>>(record: any, options?: PrepareOptions<IncludePrivateFields, FullSchema, F>): Promise<Response<FullSchema, CreateEntityInstances, IncludePrivateFields, PF, F>>;
+    private mapCasing;
     create<IncludePrivateFields extends boolean = true, CreateEntityInstances extends boolean = false, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>, PF extends SchemaPublicFieldNames<FullSchema> = SchemaPublicFieldNames<FullSchema>>(values: CreateRecord[], options?: PrepareOptions<CreateEntityInstances, FullSchema, F>): Promise<Response<FullSchema, CreateEntityInstances, IncludePrivateFields, PF, F>[]>;
     createOne<CreateEntityInstances extends boolean, F extends SchemaFieldNames<FullSchema> = SchemaFieldNames<FullSchema>>(values: CreateRecord, options?: PrepareOptions<CreateEntityInstances, FullSchema, F>): Promise<SchemaValues<FullSchema, false, CreateEntityInstances, false, F, SchemaPublicFieldNames<FullSchema>>>;
     private get primaryFieldName();

package/build/stores/AbstractStore.js

@@ -48,6 +48,7 @@ class AbstractStore extends AbstractMutexer_1.default {
     constructor(db, collectionName) {
         super();
         this.primaryFieldNames = ['id'];
+        this.shouldMapLowerCaseToCamelCase = false;
         this.db = db;
         if (collectionName) {
             this.setCollectionName(collectionName);
@@ -56,6 +57,9 @@ class AbstractStore extends AbstractMutexer_1.default {
     setCollectionName(name) {
         this.collectionName = name;
     }
+    getDb() {
+        return this.db;
+    }
     getCollectionName() {
         return this.collectionName;
     }
@@ -67,8 +71,22 @@ class AbstractStore extends AbstractMutexer_1.default {
         if (isScrambled) {
             return preparedRecord;
         }
+        if (this.shouldMapLowerCaseToCamelCase) {
+            this.mapCasing(preparedRecord);
+        }
         return (0, schema_1.normalizeSchemaValues)(this.fullSchema, preparedRecord, Object.assign(Object.assign({}, options), { fields: options.includeFields, shouldIncludePrivateFields: options.shouldIncludePrivateFields === true, shouldCreateEntityInstances: false, shouldIncludeNullAndUndefinedFields: false }));
     }
+    mapCasing(preparedRecord) {
+        var _a;
+        const fields = (_a = this.fullSchema.fields) !== null && _a !== void 0 ? _a : {};
+        Object.keys(fields).forEach((f) => {
+            const lowerF = f.toLowerCase();
+            if (lowerF !== f && lowerF in preparedRecord) {
+                preparedRecord[f] = preparedRecord[lowerF];
+                delete preparedRecord[lowerF];
+            }
+        });
+    }
     async create(values, options) {
         try {
             //@ts-ignore

package/build/tests/databaseAssertUtil.d.ts

@@ -1,3 +1,4 @@
+import AbstractStore from '../stores/AbstractStore';
 import { Database, Index, TestConnect, UniqueIndex } from '../types/database.types';
 declare const databaseAssertUtil: {
     collectionName: string;
@@ -78,5 +79,6 @@ declare const databaseAssertUtil: {
     _assertThrowsExpectedNotFoundOnUpdateOne(db: Database, query: Record<string, any>): Promise<void>;
     _assert$orReturnsExpectedTotalRecords(db: Database, $or: Record<string, any>[], expected: number): Promise<void>;
     _assertCanCreateMultiFieldIndex(connect: TestConnect, fields: string[]): Promise<void>;
+    assertHasLowerCaseToCamelCaseMappingEnabled(store: AbstractStore<any>): void;
 };
 export default databaseAssertUtil;

package/build/tests/databaseAssertUtil.js

@@ -1540,6 +1540,11 @@ const databaseAssertUtil = {
         test_utils_1.assert.isEqualDeep(indexes[0].map((i) => i.toLowerCase()), fields.map((f) => f.toLowerCase()));
         await this.shutdown(db);
     },
+    assertHasLowerCaseToCamelCaseMappingEnabled(store) {
+        test_utils_1.assert.isTrue(
+        //@ts-ignore
+        store.shouldMapLowerCaseToCamelCase, `Your data store is not mapping lower case to camel case field names! To make that work, add protected shouldMapLowerCaseToCamelCase = true to your store.`);
+    },
 };
 exports.default = databaseAssertUtil;
 async function assertCantCreateUniqueIndexTwice(db, collectionName, fields, expectedTotalUniqueIndexes) {

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" | "assertCanUpdateWithObjectField" | "assertCanUpdateFieldInObjectFieldWithTargettedWhere" | "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")[];
+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" | "assertCanUpdateWithObjectField" | "assertCanUpdateFieldInObjectFieldWithTargettedWhere" | "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" | "assertHasLowerCaseToCamelCaseMappingEnabled")[];

package/package.json

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