create-mern-omar 1.1.0 → 1.2.0

package/templates/node_modules/mongodb/src/operations/indexes.ts

@@ -1,418 +0,0 @@
-import type { Document } from '../bson';
-import { type Connection } from '../cmap/connection';
-import { CursorResponse, MongoDBResponse } from '../cmap/wire_protocol/responses';
-import type { Collection } from '../collection';
-import { type AbstractCursorOptions } from '../cursor/abstract_cursor';
-import { MongoCompatibilityError } from '../error';
-import { type OneOrMore } from '../mongo_types';
-import { isObject, maxWireVersion, type MongoDBNamespace } from '../utils';
-import {
-  type CollationOptions,
-  CommandOperation,
-  type CommandOperationOptions,
-  type OperationParent
-} from './command';
-import { Aspect, defineAspects } from './operation';
-
-const VALID_INDEX_OPTIONS = new Set([
-  'background',
-  'unique',
-  'name',
-  'partialFilterExpression',
-  'sparse',
-  'hidden',
-  'expireAfterSeconds',
-  'storageEngine',
-  'collation',
-  'version',
-
-  // text indexes
-  'weights',
-  'default_language',
-  'language_override',
-  'textIndexVersion',
-
-  // 2d-sphere indexes
-  '2dsphereIndexVersion',
-
-  // 2d indexes
-  'bits',
-  'min',
-  'max',
-
-  // geoHaystack Indexes
-  'bucketSize',
-
-  // wildcard indexes
-  'wildcardProjection'
-]);
-
-/** @public */
-export type IndexDirection =
-  | -1
-  | 1
-  | '2d'
-  | '2dsphere'
-  | 'text'
-  | 'geoHaystack'
-  | 'hashed'
-  | number;
-
-function isIndexDirection(x: unknown): x is IndexDirection {
-  return (
-    typeof x === 'number' || x === '2d' || x === '2dsphere' || x === 'text' || x === 'geoHaystack'
-  );
-}
-/** @public */
-export type IndexSpecification = OneOrMore<
-  | string
-  | [string, IndexDirection]
-  | { [key: string]: IndexDirection }
-  | Map<string, IndexDirection>
->;
-
-/** @public */
-export interface IndexInformationOptions extends ListIndexesOptions {
-  /**
-   * When `true`, an array of index descriptions is returned.
-   * When `false`, the driver returns an object that with keys corresponding to index names with values
-   * corresponding to the entries of the indexes' key.
-   *
-   * For example, the given the following indexes:
-   * ```
-   * [ { name: 'a_1', key: { a: 1 } }, { name: 'b_1_c_1' , key: { b: 1, c: 1 } }]
-   * ```
-   *
-   * When `full` is `true`, the above array is returned.  When `full` is `false`, the following is returned:
-   * ```
-   * {
-   *   'a_1': [['a', 1]],
-   *   'b_1_c_1': [['b', 1], ['c', 1]],
-   * }
-   * ```
-   */
-  full?: boolean;
-}
-
-/** @public */
-export interface IndexDescription
-  extends Pick<
-    CreateIndexesOptions,
-    | 'background'
-    | 'unique'
-    | 'partialFilterExpression'
-    | 'sparse'
-    | 'hidden'
-    | 'expireAfterSeconds'
-    | 'storageEngine'
-    | 'version'
-    | 'weights'
-    | 'default_language'
-    | 'language_override'
-    | 'textIndexVersion'
-    | '2dsphereIndexVersion'
-    | 'bits'
-    | 'min'
-    | 'max'
-    | 'bucketSize'
-    | 'wildcardProjection'
-  > {
-  collation?: CollationOptions;
-  name?: string;
-  key: { [key: string]: IndexDirection } | Map<string, IndexDirection>;
-}
-
-/** @public */
-export interface CreateIndexesOptions extends Omit<CommandOperationOptions, 'writeConcern'> {
-  /** Creates the index in the background, yielding whenever possible. */
-  background?: boolean;
-  /** Creates an unique index. */
-  unique?: boolean;
-  /** Override the autogenerated index name (useful if the resulting name is larger than 128 bytes) */
-  name?: string;
-  /** Creates a partial index based on the given filter object (MongoDB 3.2 or higher) */
-  partialFilterExpression?: Document;
-  /** Creates a sparse index. */
-  sparse?: boolean;
-  /** Allows you to expire data on indexes applied to a data (MongoDB 2.2 or higher) */
-  expireAfterSeconds?: number;
-  /** Allows users to configure the storage engine on a per-index basis when creating an index. (MongoDB 3.0 or higher) */
-  storageEngine?: Document;
-  /** (MongoDB 4.4. or higher) Specifies how many data-bearing members of a replica set, including the primary, must complete the index builds successfully before the primary marks the indexes as ready. This option accepts the same values for the "w" field in a write concern plus "votingMembers", which indicates all voting data-bearing nodes. */
-  commitQuorum?: number | string;
-  /** Specifies the index version number, either 0 or 1. */
-  version?: number;
-  // text indexes
-  weights?: Document;
-  default_language?: string;
-  language_override?: string;
-  textIndexVersion?: number;
-  // 2d-sphere indexes
-  '2dsphereIndexVersion'?: number;
-  // 2d indexes
-  bits?: number;
-  /** For geospatial indexes set the lower bound for the co-ordinates. */
-  min?: number;
-  /** For geospatial indexes set the high bound for the co-ordinates. */
-  max?: number;
-  // geoHaystack Indexes
-  bucketSize?: number;
-  // wildcard indexes
-  wildcardProjection?: Document;
-  /** Specifies that the index should exist on the target collection but should not be used by the query planner when executing operations. (MongoDB 4.4 or higher) */
-  hidden?: boolean;
-}
-
-function isSingleIndexTuple(t: unknown): t is [string, IndexDirection] {
-  return Array.isArray(t) && t.length === 2 && isIndexDirection(t[1]);
-}
-
-/**
- * Converts an `IndexSpecification`, which can be specified in multiple formats, into a
- * valid `key` for the createIndexes command.
- */
-function constructIndexDescriptionMap(indexSpec: IndexSpecification): Map<string, IndexDirection> {
-  const key: Map<string, IndexDirection> = new Map();
-
-  const indexSpecs =
-    !Array.isArray(indexSpec) || isSingleIndexTuple(indexSpec) ? [indexSpec] : indexSpec;
-
-  // Iterate through array and handle different types
-  for (const spec of indexSpecs) {
-    if (typeof spec === 'string') {
-      key.set(spec, 1);
-    } else if (Array.isArray(spec)) {
-      key.set(spec[0], spec[1] ?? 1);
-    } else if (spec instanceof Map) {
-      for (const [property, value] of spec) {
-        key.set(property, value);
-      }
-    } else if (isObject(spec)) {
-      for (const [property, value] of Object.entries(spec)) {
-        key.set(property, value);
-      }
-    }
-  }
-
-  return key;
-}
-
-/**
- * Receives an index description and returns a modified index description which has had invalid options removed
- * from the description and has mapped the `version` option to the `v` option.
- */
-function resolveIndexDescription(
-  description: IndexDescription
-): Omit<ResolvedIndexDescription, 'key'> {
-  const validProvidedOptions = Object.entries(description).filter(([optionName]) =>
-    VALID_INDEX_OPTIONS.has(optionName)
-  );
-
-  return Object.fromEntries(
-    // we support the `version` option, but the `createIndexes` command expects it to be the `v`
-    validProvidedOptions.map(([name, value]) => (name === 'version' ? ['v', value] : [name, value]))
-  );
-}
-
-/**
- * @public
- * The index information returned by the listIndexes command. https://www.mongodb.com/docs/manual/reference/command/listIndexes/#mongodb-dbcommand-dbcmd.listIndexes
- */
-export type IndexDescriptionInfo = Omit<IndexDescription, 'key' | 'version'> & {
-  key: { [key: string]: IndexDirection };
-  v?: IndexDescription['version'];
-} & Document;
-
-/** @public */
-export type IndexDescriptionCompact = Record<string, [name: string, direction: IndexDirection][]>;
-
-/**
- * @internal
- *
- * Internally, the driver represents index description keys with `Map`s to preserve key ordering.
- * We don't require users to specify maps, so we transform user provided descriptions into
- * "resolved" by converting the `key` into a JS `Map`, if it isn't already a map.
- *
- * Additionally, we support the `version` option, but the `createIndexes` command uses the field `v`
- * to specify the index version so we map the value of `version` to `v`, if provided.
- */
-type ResolvedIndexDescription = Omit<IndexDescription, 'key' | 'version'> & {
-  key: Map<string, IndexDirection>;
-  v?: IndexDescription['version'];
-};
-
-/** @internal */
-export class CreateIndexesOperation extends CommandOperation<string[]> {
-  override SERVER_COMMAND_RESPONSE_TYPE = MongoDBResponse;
-  override options: CreateIndexesOptions;
-  collectionName: string;
-  indexes: ReadonlyArray<ResolvedIndexDescription>;
-
-  private constructor(
-    parent: OperationParent,
-    collectionName: string,
-    indexes: IndexDescription[],
-    options?: CreateIndexesOptions
-  ) {
-    super(parent, options);
-
-    this.options = options ?? {};
-    // collation is set on each index, it should not be defined at the root
-    this.options.collation = undefined;
-    this.collectionName = collectionName;
-    this.indexes = indexes.map((userIndex: IndexDescription): ResolvedIndexDescription => {
-      // Ensure the key is a Map to preserve index key ordering
-      const key =
-        userIndex.key instanceof Map ? userIndex.key : new Map(Object.entries(userIndex.key));
-      const name = userIndex.name ?? Array.from(key).flat().join('_');
-      const validIndexOptions = resolveIndexDescription(userIndex);
-      return {
-        ...validIndexOptions,
-        name,
-        key
-      };
-    });
-    this.ns = parent.s.namespace;
-  }
-
-  static fromIndexDescriptionArray(
-    parent: OperationParent,
-    collectionName: string,
-    indexes: IndexDescription[],
-    options?: CreateIndexesOptions
-  ): CreateIndexesOperation {
-    return new CreateIndexesOperation(parent, collectionName, indexes, options);
-  }
-
-  static fromIndexSpecification(
-    parent: OperationParent,
-    collectionName: string,
-    indexSpec: IndexSpecification,
-    options: CreateIndexesOptions = {}
-  ): CreateIndexesOperation {
-    const key = constructIndexDescriptionMap(indexSpec);
-    const description: IndexDescription = { ...options, key };
-    return new CreateIndexesOperation(parent, collectionName, [description], options);
-  }
-
-  override get commandName() {
-    return 'createIndexes';
-  }
-
-  override buildCommandDocument(connection: Connection): Document {
-    const options = this.options;
-    const indexes = this.indexes;
-
-    const serverWireVersion = maxWireVersion(connection);
-
-    const cmd: Document = { createIndexes: this.collectionName, indexes };
-
-    if (options.commitQuorum != null) {
-      if (serverWireVersion < 9) {
-        throw new MongoCompatibilityError(
-          'Option `commitQuorum` for `createIndexes` not supported on servers < 4.4'
-        );
-      }
-      cmd.commitQuorum = options.commitQuorum;
-    }
-    return cmd;
-  }
-
-  override handleOk(_response: InstanceType<typeof this.SERVER_COMMAND_RESPONSE_TYPE>): string[] {
-    const indexNames = this.indexes.map(index => index.name || '');
-    return indexNames;
-  }
-}
-
-/** @public */
-export type DropIndexesOptions = CommandOperationOptions;
-
-/** @internal */
-export class DropIndexOperation extends CommandOperation<Document> {
-  override SERVER_COMMAND_RESPONSE_TYPE = MongoDBResponse;
-  override options: DropIndexesOptions;
-  collection: Collection;
-  indexName: string;
-
-  constructor(collection: Collection, indexName: string, options?: DropIndexesOptions) {
-    super(collection, options);
-
-    this.options = options ?? {};
-    this.collection = collection;
-    this.indexName = indexName;
-    this.ns = collection.fullNamespace;
-  }
-
-  override get commandName() {
-    return 'dropIndexes' as const;
-  }
-
-  override buildCommandDocument(_connection: Connection): Document {
-    return { dropIndexes: this.collection.collectionName, index: this.indexName };
-  }
-}
-
-/** @public */
-export type ListIndexesOptions = AbstractCursorOptions & {
-  /** @internal */
-  omitMaxTimeMS?: boolean;
-  /** @internal */
-  rawData?: boolean;
-};
-
-/** @internal */
-export class ListIndexesOperation extends CommandOperation<CursorResponse> {
-  override SERVER_COMMAND_RESPONSE_TYPE = CursorResponse;
-  /**
-   * @remarks WriteConcern can still be present on the options because
-   * we inherit options from the client/db/collection.  The
-   * key must be present on the options in order to delete it.
-   * This allows typescript to delete the key but will
-   * not allow a writeConcern to be assigned as a property on options.
-   */
-  override options: ListIndexesOptions & { writeConcern?: never };
-  collectionNamespace: MongoDBNamespace;
-
-  constructor(collection: Collection, options?: ListIndexesOptions) {
-    super(collection, options);
-
-    this.options = { ...options };
-    delete this.options.writeConcern;
-    this.collectionNamespace = collection.s.namespace;
-  }
-
-  override get commandName() {
-    return 'listIndexes' as const;
-  }
-
-  override buildCommandDocument(connection: Connection): Document {
-    const serverWireVersion = maxWireVersion(connection);
-
-    const cursor = this.options.batchSize ? { batchSize: this.options.batchSize } : {};
-
-    const command: Document = { listIndexes: this.collectionNamespace.collection, cursor };
-
-    // we check for undefined specifically here to allow falsy values
-    // eslint-disable-next-line no-restricted-syntax
-    if (serverWireVersion >= 9 && this.options.comment !== undefined) {
-      command.comment = this.options.comment;
-    }
-
-    return command;
-  }
-
-  override handleOk(
-    response: InstanceType<typeof this.SERVER_COMMAND_RESPONSE_TYPE>
-  ): CursorResponse {
-    return response;
-  }
-}
-
-defineAspects(ListIndexesOperation, [
-  Aspect.READ_OPERATION,
-  Aspect.RETRYABLE,
-  Aspect.CURSOR_CREATING,
-  Aspect.SUPPORTS_RAW_DATA
-]);
-defineAspects(CreateIndexesOperation, [Aspect.WRITE_OPERATION, Aspect.SUPPORTS_RAW_DATA]);
-defineAspects(DropIndexOperation, [Aspect.WRITE_OPERATION, Aspect.SUPPORTS_RAW_DATA]);

package/templates/node_modules/mongodb/src/operations/insert.ts

@@ -1,108 +0,0 @@
-import { type Connection } from '..';
-import type { Document } from '../bson';
-import type { BulkWriteOptions } from '../bulk/common';
-import { MongoDBResponse } from '../cmap/wire_protocol/responses';
-import type { Collection } from '../collection';
-import { MongoServerError } from '../error';
-import type { InferIdType } from '../mongo_types';
-import type { ClientSession } from '../sessions';
-import { maybeAddIdToDocuments, type MongoDBNamespace } from '../utils';
-import { CommandOperation, type CommandOperationOptions } from './command';
-import { Aspect, defineAspects } from './operation';
-/** @internal */
-export class InsertOperation extends CommandOperation<Document> {
-  override SERVER_COMMAND_RESPONSE_TYPE = MongoDBResponse;
-  override options: BulkWriteOptions;
-
-  documents: Document[];
-
-  constructor(ns: MongoDBNamespace, documents: Document[], options: BulkWriteOptions) {
-    super(undefined, options);
-    this.options = { ...options, checkKeys: options.checkKeys ?? false };
-    this.ns = ns;
-    this.documents = documents;
-  }
-
-  override get commandName() {
-    return 'insert' as const;
-  }
-
-  override buildCommandDocument(_connection: Connection, _session?: ClientSession): Document {
-    const options = this.options ?? {};
-    const ordered = typeof options.ordered === 'boolean' ? options.ordered : true;
-    const command: Document = {
-      insert: this.ns.collection,
-      documents: this.documents,
-      ordered
-    };
-
-    if (typeof options.bypassDocumentValidation === 'boolean') {
-      command.bypassDocumentValidation = options.bypassDocumentValidation;
-    }
-
-    // we check for undefined specifically here to allow falsy values
-    // eslint-disable-next-line no-restricted-syntax
-    if (options.comment !== undefined) {
-      command.comment = options.comment;
-    }
-
-    return command;
-  }
-}
-
-/** @public */
-export interface InsertOneOptions extends CommandOperationOptions {
-  /** Allow driver to bypass schema validation. */
-  bypassDocumentValidation?: boolean;
-  /** Force server to assign _id values instead of driver. */
-  forceServerObjectId?: boolean;
-}
-
-/** @public */
-export interface InsertOneResult<TSchema = Document> {
-  /** Indicates whether this write result was acknowledged. If not, then all other members of this result will be undefined */
-  acknowledged: boolean;
-  /** The identifier that was inserted. If the server generated the identifier, this value will be null as the driver does not have access to that data */
-  insertedId: InferIdType<TSchema>;
-}
-
-export class InsertOneOperation extends InsertOperation {
-  constructor(collection: Collection, doc: Document, options: InsertOneOptions) {
-    super(collection.s.namespace, [maybeAddIdToDocuments(collection, doc, options)], options);
-  }
-
-  override handleOk(response: InstanceType<typeof this.SERVER_COMMAND_RESPONSE_TYPE>): Document {
-    const res = super.handleOk(response);
-    if (res.code) throw new MongoServerError(res);
-    if (res.writeErrors) {
-      // This should be a WriteError but we can't change it now because of error hierarchy
-      throw new MongoServerError(res.writeErrors[0]);
-    }
-
-    return {
-      acknowledged: this.writeConcern?.w !== 0,
-      insertedId: this.documents[0]._id
-    };
-  }
-}
-
-/** @public */
-export interface InsertManyResult<TSchema = Document> {
-  /** Indicates whether this write result was acknowledged. If not, then all other members of this result will be undefined */
-  acknowledged: boolean;
-  /** The number of inserted documents for this operations */
-  insertedCount: number;
-  /** Map of the index of the inserted document to the id of the inserted document */
-  insertedIds: { [key: number]: InferIdType<TSchema> };
-}
-
-defineAspects(InsertOperation, [
-  Aspect.RETRYABLE,
-  Aspect.WRITE_OPERATION,
-  Aspect.SUPPORTS_RAW_DATA
-]);
-defineAspects(InsertOneOperation, [
-  Aspect.RETRYABLE,
-  Aspect.WRITE_OPERATION,
-  Aspect.SUPPORTS_RAW_DATA
-]);

package/templates/node_modules/mongodb/src/operations/kill_cursors.ts

@@ -1,64 +0,0 @@
-import type { Long } from '../bson';
-import { type Connection } from '../cmap/connection';
-import { MongoDBResponse } from '../cmap/wire_protocol/responses';
-import { type MongoError, MongoRuntimeError } from '../error';
-import type { Server, ServerCommandOptions } from '../sdam/server';
-import type { ClientSession } from '../sessions';
-import { type TimeoutContext } from '../timeout';
-import { type MongoDBNamespace } from '../utils';
-import { AbstractOperation, Aspect, defineAspects, type OperationOptions } from './operation';
-
-/**
- * https://www.mongodb.com/docs/manual/reference/command/killCursors/
- * @internal
- */
-interface KillCursorsCommand {
-  killCursors: string;
-  cursors: Long[];
-  comment?: unknown;
-}
-
-export class KillCursorsOperation extends AbstractOperation<void> {
-  override SERVER_COMMAND_RESPONSE_TYPE = MongoDBResponse;
-  cursorId: Long;
-
-  constructor(cursorId: Long, ns: MongoDBNamespace, server: Server, options: OperationOptions) {
-    super(options);
-    this.ns = ns;
-    this.cursorId = cursorId;
-    this.server = server;
-  }
-
-  override get commandName() {
-    return 'killCursors' as const;
-  }
-
-  override buildCommand(_connection: Connection, _session?: ClientSession): KillCursorsCommand {
-    const killCursors = this.ns.collection;
-    if (killCursors == null) {
-      // Cursors should have adopted the namespace returned by MongoDB
-      // which should always defined a collection name (even a pseudo one, ex. db.aggregate())
-      throw new MongoRuntimeError('A collection name must be determined before killCursors');
-    }
-
-    const killCursorsCommand: KillCursorsCommand = {
-      killCursors,
-      cursors: [this.cursorId]
-    };
-
-    return killCursorsCommand;
-  }
-
-  override buildOptions(timeoutContext: TimeoutContext): ServerCommandOptions {
-    return {
-      session: this.session,
-      timeoutContext
-    };
-  }
-
-  override handleError(_error: MongoError): void {
-    // The driver should never emit errors from killCursors, this is spec-ed behavior
-  }
-}
-
-defineAspects(KillCursorsOperation, [Aspect.MUST_SELECT_SAME_SERVER]);

package/templates/node_modules/mongodb/src/operations/list_collections.ts

@@ -1,108 +0,0 @@
-import { type Connection } from '..';
-import type { Binary, Document } from '../bson';
-import { CursorResponse, ExplainedCursorResponse } from '../cmap/wire_protocol/responses';
-import { type CursorTimeoutContext, type CursorTimeoutMode } from '../cursor/abstract_cursor';
-import type { Db } from '../db';
-import { type Abortable } from '../mongo_types';
-import { maxWireVersion } from '../utils';
-import { CommandOperation, type CommandOperationOptions } from './command';
-import { Aspect, defineAspects } from './operation';
-
-/** @public */
-export interface ListCollectionsOptions
-  extends Omit<CommandOperationOptions, 'writeConcern'>,
-    Abortable {
-  /** Since 4.0: If true, will only return the collection name in the response, and will omit additional info */
-  nameOnly?: boolean;
-  /** Since 4.0: If true and nameOnly is true, allows a user without the required privilege (i.e. listCollections action on the database) to run the command when access control is enforced. */
-  authorizedCollections?: boolean;
-  /** The batchSize for the returned command cursor or if pre 2.8 the systems batch collection */
-  batchSize?: number;
-  /** @internal */
-  timeoutMode?: CursorTimeoutMode;
-
-  /** @internal */
-  timeoutContext?: CursorTimeoutContext;
-}
-
-/** @internal */
-export class ListCollectionsOperation extends CommandOperation<CursorResponse> {
-  override SERVER_COMMAND_RESPONSE_TYPE = CursorResponse;
-  /**
-   * @remarks WriteConcern can still be present on the options because
-   * we inherit options from the client/db/collection.  The
-   * key must be present on the options in order to delete it.
-   * This allows typescript to delete the key but will
-   * not allow a writeConcern to be assigned as a property on options.
-   */
-  override options: ListCollectionsOptions & { writeConcern?: never };
-  db: Db;
-  filter: Document;
-  nameOnly: boolean;
-  authorizedCollections: boolean;
-  batchSize?: number;
-
-  constructor(db: Db, filter: Document, options?: ListCollectionsOptions) {
-    super(db, options);
-
-    this.options = { ...options };
-    delete this.options.writeConcern;
-    this.db = db;
-    this.filter = filter;
-    this.nameOnly = !!this.options.nameOnly;
-    this.authorizedCollections = !!this.options.authorizedCollections;
-
-    if (typeof this.options.batchSize === 'number') {
-      this.batchSize = this.options.batchSize;
-    }
-
-    this.SERVER_COMMAND_RESPONSE_TYPE = this.explain ? ExplainedCursorResponse : CursorResponse;
-  }
-
-  override get commandName() {
-    return 'listCollections' as const;
-  }
-
-  override buildCommandDocument(connection: Connection): Document {
-    const command: Document = {
-      listCollections: 1,
-      filter: this.filter,
-      cursor: this.batchSize ? { batchSize: this.batchSize } : {},
-      nameOnly: this.nameOnly,
-      authorizedCollections: this.authorizedCollections
-    };
-
-    // we check for undefined specifically here to allow falsy values
-    // eslint-disable-next-line no-restricted-syntax
-    if (maxWireVersion(connection) >= 9 && this.options.comment !== undefined) {
-      command.comment = this.options.comment;
-    }
-
-    return command;
-  }
-
-  override handleOk(
-    response: InstanceType<typeof this.SERVER_COMMAND_RESPONSE_TYPE>
-  ): CursorResponse {
-    return response;
-  }
-}
-
-/** @public */
-export interface CollectionInfo extends Document {
-  name: string;
-  type?: string;
-  options?: Document;
-  info?: {
-    readOnly?: false;
-    uuid?: Binary;
-  };
-  idIndex?: Document;
-}
-
-defineAspects(ListCollectionsOperation, [
-  Aspect.READ_OPERATION,
-  Aspect.RETRYABLE,
-  Aspect.CURSOR_CREATING,
-  Aspect.SUPPORTS_RAW_DATA
-]);