cloudbase-document-database-web-sdk

Initialize CloudBase with cloudbase.init, get the database via app.database(), then use db.collection(name).where(conditions).get() with operators from db.command. Ensure the user is signed in if collection security rules require identity.

The created document ID is returned at the top level as result._id from db.collection(name).add(data). Do not look for it under result.id, result.data, or result.insertedId.

Use the Web SDK (@cloudbase/js-sdk with app.database()) for browser applications. Use wx.cloud.database() only inside WeChat Mini Programs, and use server-side SDKs for cloud functions or backend access.

Security rule changes are cached for 2-5 minutes before taking effect, so new CUSTOM rules may not apply immediately. Wait a few minutes, retry the write, and verify success by checking result fields like updated or code rather than trusting a resolved promise.

Yes, use db.collection(name).where(conditions).watch({ onChange, onError }) to receive live snapshots of added, updated, and deleted documents. Call watcher.close() when the component unmounts to release resources.

Geolocation queries require a geo index on the queried field, created in the CloudBase console before querying. Also verify coordinates use [longitude, latitude] order and polygons are closed with identical first and last points.