Atlas SDK
atlas_sdk is a TypeSafe MongoDB Atlas Data API SDK for Deno & Deno Deploy
Links
Import
Replace LATEST_VERSION
with
current latest version
import {
MongoClient,
ObjectId,
} from "https://deno.land/x/atlas_sdk@LATEST_VERSION/mod.ts";
Connect
const client = new MongoClient({
appId: "YOUR_APP_ID", // e.g. "data-omosm"
dataSource: "YOUR_CLUSTER_NAME", // e.g. "Cluster0"
apiKey: "YOUR_API_KEY",
});
Access Collection
// Defining schema interface
interface UserSchema {
_id: ObjectId;
username: string;
password: string;
}
const db = client.database("test");
const users = db.collection<UserSchema>("users");
Insert
const insertId = await users.insertOne({
username: "user1",
password: "pass1",
});
const insertIds = await users.insertMany([
{
username: "user1",
password: "pass1",
},
{
username: "user2",
password: "pass2",
},
]);
Find
const user1 = await users.findOne({ _id: insertId });
const all_users = await users.find({ username: { $ne: null } });
// find by ObjectId
const user1_id = await users.findOne({
_id: new ObjectId("SOME OBJECTID STRING"),
});
Count
const count = await users.countDocuments({ username: { $ne: null } });
const estimatedCount = await users.estimatedDocumentCount({
username: { $ne: null },
});
Aggregation
const docs = await users.aggregate([
{ $match: { username: "many" } },
{ $group: { _id: "$username", total: { $sum: 1 } } },
]);
Update
const { matchedCount, modifiedCount, upsertedId } = await users.updateOne(
{ username: { $ne: null } },
{ $set: { username: "USERNAME" } },
);
const { matchedCount, modifiedCount, upsertedId } = await users.updateMany(
{ username: { $ne: null } },
{ $set: { username: "USERNAME" } },
);
Replace
const { matchedCount, modifiedCount, upsertedId } = await users.replaceOne(
{ username: "a" },
{
username: "user1",
password: "pass1",
}, // new document
);
Delete
const deleteCount = await users.deleteOne({ _id: insertId });
const deleteCount2 = await users.deleteMany({ username: "test" });