convex-functions

Define the query with the object syntax using a handler property, specify args with validators from convex/values like v.id("users"), and add a returns validator. Queries are read-only, cached, and reactive by default.

Queries are read-only, cached, and reactive for fetching data. Mutations are transactional for database writes. Actions can call external APIs but access the database only through runQuery and runMutation.

No, mutations and queries cannot call external APIs. Use an action to call the external service, then invoke runMutation to persist results. Add "use node" at the top of the file when the action needs Node.js APIs.

Use httpRouter in convex/http.ts and register routes with httpAction handlers. Inside the handler, verify signatures from request headers, then call runMutation or runQuery to interact with the database before returning a Response.

Use internalMutation, internalQuery, and internalAction for sensitive operations that should not be publicly callable, such as updating user credits. Internal functions can only be invoked from other Convex functions via the internal API object.

Convex actions run in a restricted runtime by default. Add the "use node" directive at the top of the file to enable the Node.js runtime, which is required for Node-specific APIs and many npm packages.