deno.land / x / mongoose@6.7.5 / lib / schema / SubdocumentPath.js
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368'use strict';
/*! * Module dependencies. */
const CastError = require('../error/cast');const EventEmitter = require('events').EventEmitter;const ObjectExpectedError = require('../error/objectExpected');const SchemaSubdocumentOptions = require('../options/SchemaSubdocumentOptions');const SchemaType = require('../schematype');const applyDefaults = require('../helpers/document/applyDefaults');const $exists = require('./operators/exists');const castToNumber = require('./operators/helpers').castToNumber;const discriminator = require('../helpers/model/discriminator');const geospatial = require('./operators/geospatial');const getConstructor = require('../helpers/discriminator/getConstructor');const handleIdOption = require('../helpers/schema/handleIdOption');const internalToObjectOptions = require('../options').internalToObjectOptions;const utils = require('../utils');
let Subdocument;
module.exports = SubdocumentPath;
/** * Single nested subdocument SchemaType constructor. * * @param {Schema} schema * @param {String} path * @param {Object} options * @inherits SchemaType * @api public */
function SubdocumentPath(schema, path, options) { const schemaTypeIdOption = SubdocumentPath.defaultOptions && SubdocumentPath.defaultOptions._id; if (schemaTypeIdOption != null) { options = options || {}; options._id = schemaTypeIdOption; }
schema = handleIdOption(schema, options);
this.caster = _createConstructor(schema); this.caster.path = path; this.caster.prototype.$basePath = path; this.schema = schema; this.$isSingleNested = true; this.base = schema.base; SchemaType.call(this, path, options, 'Embedded');}
/*! * ignore */
SubdocumentPath.prototype = Object.create(SchemaType.prototype);SubdocumentPath.prototype.constructor = SubdocumentPath;SubdocumentPath.prototype.OptionsConstructor = SchemaSubdocumentOptions;
/*! * ignore */
function _createConstructor(schema, baseClass) { // lazy load Subdocument || (Subdocument = require('../types/subdocument'));
const _embedded = function SingleNested(value, path, parent) { this.$__parent = parent; Subdocument.apply(this, arguments);
if (parent == null) { return; } this.$session(parent.$session()); };
schema._preCompile();
const proto = baseClass != null ? baseClass.prototype : Subdocument.prototype; _embedded.prototype = Object.create(proto); _embedded.prototype.$__setSchema(schema); _embedded.prototype.constructor = _embedded; _embedded.schema = schema; _embedded.$isSingleNested = true; _embedded.events = new EventEmitter(); _embedded.prototype.toBSON = function() { return this.toObject(internalToObjectOptions); };
// apply methods for (const i in schema.methods) { _embedded.prototype[i] = schema.methods[i]; }
// apply statics for (const i in schema.statics) { _embedded[i] = schema.statics[i]; }
for (const i in EventEmitter.prototype) { _embedded[i] = EventEmitter.prototype[i]; }
return _embedded;}
/** * Special case for when users use a common location schema to represent * locations for use with $geoWithin. * https://docs.mongodb.org/manual/reference/operator/query/geoWithin/ * * @param {Object} val * @api private */
SubdocumentPath.prototype.$conditionalHandlers.$geoWithin = function handle$geoWithin(val) { return { $geometry: this.castForQuery(val.$geometry) };};
/*! * ignore */
SubdocumentPath.prototype.$conditionalHandlers.$near =SubdocumentPath.prototype.$conditionalHandlers.$nearSphere = geospatial.cast$near;
SubdocumentPath.prototype.$conditionalHandlers.$within =SubdocumentPath.prototype.$conditionalHandlers.$geoWithin = geospatial.cast$within;
SubdocumentPath.prototype.$conditionalHandlers.$geoIntersects = geospatial.cast$geoIntersects;
SubdocumentPath.prototype.$conditionalHandlers.$minDistance = castToNumber;SubdocumentPath.prototype.$conditionalHandlers.$maxDistance = castToNumber;
SubdocumentPath.prototype.$conditionalHandlers.$exists = $exists;
/** * Casts contents * * @param {Object} value * @api private */
SubdocumentPath.prototype.cast = function(val, doc, init, priorVal, options) { if (val && val.$isSingleNested && val.parent === doc) { return val; }
if (val != null && (typeof val !== 'object' || Array.isArray(val))) { throw new ObjectExpectedError(this.path, val); }
const Constructor = getConstructor(this.caster, val);
let subdoc;
// Only pull relevant selected paths and pull out the base path const parentSelected = doc && doc.$__ && doc.$__.selected || {}; const path = this.path; const selected = Object.keys(parentSelected).reduce((obj, key) => { if (key.startsWith(path + '.')) { obj = obj || {}; obj[key.substring(path.length + 1)] = parentSelected[key]; } return obj; }, null); options = Object.assign({}, options, { priorDoc: priorVal }); if (init) { subdoc = new Constructor(void 0, selected, doc, false, { defaults: false }); delete subdoc.$__.defaults; subdoc.$init(val); applyDefaults(subdoc, selected); } else { if (Object.keys(val).length === 0) { return new Constructor({}, selected, doc, undefined, options); }
return new Constructor(val, selected, doc, undefined, options); }
return subdoc;};
/** * Casts contents for query * * @param {string} [$conditional] optional query operator (like `$eq` or `$in`) * @param {any} value * @api private */
SubdocumentPath.prototype.castForQuery = function($conditional, val, options) { let handler; if (arguments.length === 2) { handler = this.$conditionalHandlers[$conditional]; if (!handler) { throw new Error('Can\'t use ' + $conditional); } return handler.call(this, val); } val = $conditional; if (val == null) { return val; }
if (this.options.runSetters) { val = this._applySetters(val); }
const Constructor = getConstructor(this.caster, val); const overrideStrict = options != null && options.strict != null ? options.strict : void 0;
try { val = new Constructor(val, overrideStrict); } catch (error) { // Make sure we always wrap in a CastError (gh-6803) if (!(error instanceof CastError)) { throw new CastError('Embedded', val, this.path, error, this); } throw error; } return val;};
/** * Async validation on this single nested doc. * * @api private */
SubdocumentPath.prototype.doValidate = function(value, fn, scope, options) { const Constructor = getConstructor(this.caster, value);
if (value && !(value instanceof Constructor)) { value = new Constructor(value, null, (scope != null && scope.$__ != null) ? scope : null); }
if (options && options.skipSchemaValidators) { if (!value) { return fn(null); } return value.validate(fn); }
SchemaType.prototype.doValidate.call(this, value, function(error) { if (error) { return fn(error); } if (!value) { return fn(null); }
value.validate(fn); }, scope, options);};
/** * Synchronously validate this single nested doc * * @api private */
SubdocumentPath.prototype.doValidateSync = function(value, scope, options) { if (!options || !options.skipSchemaValidators) { const schemaTypeError = SchemaType.prototype.doValidateSync.call(this, value, scope); if (schemaTypeError) { return schemaTypeError; } } if (!value) { return; } return value.validateSync();};
/** * Adds a discriminator to this single nested subdocument. * * #### Example: * * const shapeSchema = Schema({ name: String }, { discriminatorKey: 'kind' }); * const schema = Schema({ shape: shapeSchema }); * * const singleNestedPath = parentSchema.path('shape'); * singleNestedPath.discriminator('Circle', Schema({ radius: Number })); * * @param {String} name * @param {Schema} schema fields to add to the schema for instances of this sub-class * @param {Object|string} [options] If string, same as `options.value`. * @param {String} [options.value] the string stored in the `discriminatorKey` property. If not specified, Mongoose uses the `name` parameter. * @param {Boolean} [options.clone=true] By default, `discriminator()` clones the given `schema`. Set to `false` to skip cloning. * @return {Function} the constructor Mongoose will use for creating instances of this discriminator model * @see discriminators /docs/discriminators.html * @api public */
SubdocumentPath.prototype.discriminator = function(name, schema, options) { options = options || {}; const value = utils.isPOJO(options) ? options.value : options; const clone = typeof options.clone === 'boolean' ? options.clone : true;
if (schema.instanceOfSchema && clone) { schema = schema.clone(); }
schema = discriminator(this.caster, name, schema, value);
this.caster.discriminators[name] = _createConstructor(schema, this.caster);
return this.caster.discriminators[name];};
/*! * ignore */
SubdocumentPath.defaultOptions = {};
/** * Sets a default option for all SubdocumentPath instances. * * #### Example: * * // Make all numbers have option `min` equal to 0. * mongoose.Schema.SubdocumentPath.set('required', true); * * @param {String} option The option you'd like to set the value for * @param {Any} value value for option * @return {void} * @function set * @static * @api public */
SubdocumentPath.set = SchemaType.set;
/*! * ignore */
SubdocumentPath.prototype.toJSON = function toJSON() { return { path: this.path, options: this.options };};
/*! * ignore */
SubdocumentPath.prototype.clone = function() { const options = Object.assign({}, this.options); const schematype = new this.constructor(this.schema, this.path, options); schematype.validators = this.validators.slice(); if (this.requiredValidator !== undefined) { schematype.requiredValidator = this.requiredValidator; } schematype.caster.discriminators = Object.assign({}, this.caster.discriminators); return schematype;};
Version Info