mongo.do 0.1.0

package/dist/types/mongodb.d.ts

@@ -0,0 +1,258 @@
+/**
+ * MongoDB-compatible type definitions
+ */
+/**
+ * A BSON document - the fundamental data structure in MongoDB
+ */
+export interface Document {
+    [key: string]: unknown;
+    _id?: string | ObjectId;
+}
+/**
+ * ObjectId type for document identifiers
+ */
+export interface ObjectId {
+    toString(): string;
+    toHexString(): string;
+    getTimestamp(): Date;
+}
+/**
+ * Filter query type for finding documents
+ */
+export type Filter<T = Document> = {
+    [P in keyof T]?: T[P] | FilterOperators<T[P]>;
+} & RootFilterOperators<T>;
+/**
+ * Filter operators like $eq, $gt, $lt, etc.
+ */
+export interface FilterOperators<T> {
+    $eq?: T;
+    $ne?: T;
+    $gt?: T;
+    $gte?: T;
+    $lt?: T;
+    $lte?: T;
+    $in?: T[];
+    $nin?: T[];
+    $exists?: boolean;
+    $type?: string | number;
+    $regex?: string | RegExp;
+    $options?: string;
+    $not?: FilterOperators<T>;
+    $elemMatch?: T extends (infer U)[] ? Filter<U & Document> : never;
+    $size?: number;
+}
+/**
+ * Root-level filter operators like $and, $or, $nor
+ */
+export interface RootFilterOperators<T> {
+    $and?: Filter<T & Document>[];
+    $or?: Filter<T & Document>[];
+    $nor?: Filter<T & Document>[];
+    $text?: {
+        $search: string;
+        $language?: string;
+        $caseSensitive?: boolean;
+        $diacriticSensitive?: boolean;
+    };
+    $where?: string | ((this: T) => boolean);
+}
+/**
+ * Update filter type for modifying documents
+ */
+export interface UpdateFilter<T extends Document = Document> {
+    $set?: Partial<T>;
+    $unset?: {
+        [P in keyof T]?: '' | 1 | true;
+    };
+    $inc?: {
+        [P in keyof T]?: number;
+    };
+    $mul?: {
+        [P in keyof T]?: number;
+    };
+    $min?: Partial<T>;
+    $max?: Partial<T>;
+    $rename?: {
+        [key: string]: string;
+    };
+    $push?: {
+        [P in keyof T]?: T[P] extends (infer U)[] ? U | ArrayUpdateOperators<U> : never;
+    };
+    $pull?: {
+        [P in keyof T]?: T[P] extends (infer U)[] ? U | Filter<U & Document> : never;
+    };
+    $addToSet?: {
+        [P in keyof T]?: T[P] extends (infer U)[] ? U | {
+            $each: U[];
+        } : never;
+    };
+    $pop?: {
+        [P in keyof T]?: 1 | -1;
+    };
+    $currentDate?: {
+        [P in keyof T]?: true | {
+            $type: 'date' | 'timestamp';
+        };
+    };
+}
+/**
+ * Array update operators for $push
+ */
+export interface ArrayUpdateOperators<T> {
+    $each?: T[];
+    $slice?: number;
+    $sort?: 1 | -1 | {
+        [key: string]: 1 | -1;
+    };
+    $position?: number;
+}
+/**
+ * Options for find operations
+ */
+export interface FindOptions<T extends Document = Document> {
+    projection?: {
+        [P in keyof T]?: 0 | 1 | boolean;
+    } | undefined;
+    sort?: {
+        [P in keyof T]?: 1 | -1;
+    } | [string, 1 | -1][] | undefined;
+    skip?: number | undefined;
+    limit?: number | undefined;
+    hint?: string | {
+        [key: string]: 1 | -1;
+    } | undefined;
+    maxTimeMS?: number | undefined;
+    readConcern?: {
+        level: 'local' | 'majority' | 'linearizable' | 'available' | 'snapshot';
+    } | undefined;
+}
+/**
+ * Result of insertOne operation
+ */
+export interface InsertOneResult {
+    acknowledged: boolean;
+    insertedId: string | ObjectId;
+}
+/**
+ * Result of insertMany operation
+ */
+export interface InsertManyResult {
+    acknowledged: boolean;
+    insertedCount: number;
+    insertedIds: {
+        [key: number]: string | ObjectId;
+    };
+}
+/**
+ * Result of update operations
+ */
+export interface UpdateResult {
+    acknowledged: boolean;
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedCount: number;
+    upsertedId?: string | ObjectId;
+}
+/**
+ * Result of delete operations
+ */
+export interface DeleteResult {
+    acknowledged: boolean;
+    deletedCount: number;
+}
+/**
+ * Options for aggregation pipeline
+ */
+export interface AggregateOptions {
+    allowDiskUse?: boolean | undefined;
+    maxTimeMS?: number | undefined;
+    bypassDocumentValidation?: boolean | undefined;
+    readConcern?: {
+        level: string;
+    } | undefined;
+    collation?: CollationOptions | undefined;
+    hint?: string | Document | undefined;
+    comment?: string | undefined;
+    let?: Document | undefined;
+}
+/**
+ * Collation options for string comparison
+ */
+export interface CollationOptions {
+    locale: string;
+    caseLevel?: boolean;
+    caseFirst?: 'upper' | 'lower' | 'off';
+    strength?: 1 | 2 | 3 | 4 | 5;
+    numericOrdering?: boolean;
+    alternate?: 'non-ignorable' | 'shifted';
+    maxVariable?: 'punct' | 'space';
+    backwards?: boolean;
+}
+/**
+ * Index specification for createIndex
+ */
+export interface IndexSpecification {
+    key: {
+        [key: string]: 1 | -1 | 'text' | '2dsphere' | '2d' | 'hashed';
+    };
+    name?: string;
+    unique?: boolean;
+    sparse?: boolean;
+    background?: boolean;
+    expireAfterSeconds?: number;
+    partialFilterExpression?: Filter;
+    collation?: CollationOptions;
+}
+/**
+ * Aggregation pipeline stage types
+ */
+export type AggregationStage = {
+    $match: Filter;
+} | {
+    $project: Document;
+} | {
+    $group: {
+        _id: unknown;
+        [key: string]: unknown;
+    };
+} | {
+    $sort: {
+        [key: string]: 1 | -1;
+    };
+} | {
+    $limit: number;
+} | {
+    $skip: number;
+} | {
+    $unwind: string | {
+        path: string;
+        preserveNullAndEmptyArrays?: boolean;
+    };
+} | {
+    $lookup: LookupStage;
+} | {
+    $addFields: Document;
+} | {
+    $replaceRoot: {
+        newRoot: string | Document;
+    };
+} | {
+    $count: string;
+} | {
+    $facet: {
+        [key: string]: AggregationStage[];
+    };
+};
+/**
+ * $lookup stage configuration
+ */
+export interface LookupStage {
+    from: string;
+    localField?: string;
+    foreignField?: string;
+    as: string;
+    let?: Document;
+    pipeline?: AggregationStage[];
+}
+//# sourceMappingURL=mongodb.d.ts.map

package/dist/types/mongodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.d.ts","sourceRoot":"","sources":["../../src/types/mongodb.ts"],"names":[],"mappings":"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"}

package/dist/types/mongodb.js

@@ -0,0 +1,5 @@
+/**
+ * MongoDB-compatible type definitions
+ */
+export {};
+//# sourceMappingURL=mongodb.js.map

package/dist/types/mongodb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb.js","sourceRoot":"","sources":["../../src/types/mongodb.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/objectid.d.ts

@@ -0,0 +1,130 @@
+/**
+ * ObjectId - MongoDB-compatible 12-byte unique identifier
+ *
+ * Structure (12 bytes = 24 hex characters):
+ * - 4 bytes: Unix timestamp (seconds since epoch)
+ * - 5 bytes: Random value (generated once per process)
+ * - 3 bytes: Incrementing counter (initialized to random value)
+ *
+ * Compatible with MongoDB BSON ObjectId specification.
+ */
+/**
+ * Type guard for ObjectId-like values
+ */
+export type ObjectIdLike = ObjectId | string | Uint8Array;
+/**
+ * Input types accepted by ObjectId constructor
+ */
+export type ObjectIdInput = ObjectIdLike | null | undefined;
+/**
+ * ObjectId class - MongoDB-compatible unique identifier
+ *
+ * @example
+ * ```typescript
+ * // Generate new ObjectId
+ * const id = new ObjectId()
+ *
+ * // Create from hex string
+ * const id2 = ObjectId.createFromHexString('507f1f77bcf86cd799439011')
+ *
+ * // Get timestamp
+ * const timestamp = id.getTimestamp()
+ *
+ * // Compare ObjectIds
+ * id.equals(id2) // false
+ * ```
+ */
+export declare class ObjectId {
+    /** BSON type identifier for serialization compatibility */
+    readonly _bsontype: "ObjectId";
+    /** The raw 12-byte buffer containing the ObjectId data */
+    readonly id: Uint8Array;
+    /** Cached hex string representation (computed lazily) */
+    private _hexString;
+    /**
+     * Create a new ObjectId
+     *
+     * @param input - Optional: hex string, Uint8Array, or another ObjectId.
+     *                If omitted, generates a new unique ObjectId.
+     * @throws {TypeError} If input is invalid
+     */
+    constructor(input?: ObjectIdInput);
+    /**
+     * Generate a new 12-byte ObjectId buffer
+     * Structure: 4-byte timestamp | 5-byte random | 3-byte counter
+     */
+    private generate;
+    /**
+     * Get the timestamp component of this ObjectId as a Date
+     *
+     * @returns Date object representing when this ObjectId was generated
+     */
+    getTimestamp(): Date;
+    /**
+     * Get the generation time as Unix timestamp (seconds)
+     */
+    getGenerationTime(): number;
+    /**
+     * Return the ObjectId as a 24-character lowercase hex string
+     */
+    toHexString(): string;
+    /**
+     * String representation of the ObjectId (same as toHexString)
+     */
+    toString(): string;
+    /**
+     * JSON serialization - returns hex string
+     * This allows ObjectIds to serialize naturally in JSON.stringify()
+     */
+    toJSON(): string;
+    /**
+     * Compare this ObjectId to another value for equality
+     *
+     * @param other - ObjectId, hex string, or null/undefined to compare
+     * @returns true if the ObjectIds are equal, false otherwise
+     */
+    equals(other: ObjectId | string | null | undefined): boolean;
+    /**
+     * Primitive value conversion (returns hex string)
+     */
+    valueOf(): string;
+    /**
+     * Symbol.toStringTag for better debugging output
+     */
+    get [Symbol.toStringTag](): string;
+    /**
+     * Create an ObjectId from a 24-character hex string
+     *
+     * @param hexString - 24-character hex string
+     * @returns New ObjectId instance
+     * @throws {TypeError} If hexString is invalid
+     */
+    static createFromHexString(hexString: string): ObjectId;
+    /**
+     * Create an ObjectId with a specific timestamp
+     * Useful for range queries on _id fields
+     *
+     * @param time - Unix timestamp in seconds
+     * @returns New ObjectId with the given timestamp and zeroed remaining bytes
+     */
+    static createFromTime(time: number): ObjectId;
+    /**
+     * Generate a new ObjectId (factory method, equivalent to new ObjectId())
+     *
+     * @returns New unique ObjectId instance
+     */
+    static generate(): ObjectId;
+    /**
+     * Check if a value is a valid ObjectId or ObjectId hex string
+     *
+     * @param value - Value to check
+     * @returns true if valid ObjectId or 24-char hex string
+     */
+    static isValid(value: unknown): value is ObjectId | string;
+    /**
+     * Check if a string is a valid 24-character hex string
+     */
+    private static isValidHex;
+}
+export default ObjectId;
+//# sourceMappingURL=objectid.d.ts.map

package/dist/types/objectid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectid.d.ts","sourceRoot":"","sources":["../../src/types/objectid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuGH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,CAAA;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAG,UAAU,CAAS;IAExC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,UAAU,CAAsB;IAExC;;;;;;OAMG;gBACS,KAAK,CAAC,EAAE,aAAa;IA4BjC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,WAAW,IAAI,MAAM;IAOrB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAuB5D;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAaD;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ;IASvD;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAO7C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,GAAG,MAAM;IAU1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAK1B;AAED,eAAe,QAAQ,CAAA"}