[wixysam]

Fixes to the SDK reference JSDoc from a batch of support and customer feedback. Each claim was checked against apper main.

Changes

auth.types.ts

• updateMe(): Field-level security write rules on custom User fields apply. If the payload includes a field the user can't write, the call throws a permission error and nothing is saved (entity_crud.py checks FLS before entity.update()).
• register() turnstile_token and loginViaEmailPassword() turnstileToken: Now say the token has no effect. App-user auth never verifies Turnstile; only platform sign-in does (register_platform_auth.py).

entities.types.ts

• updateMany(): All update operators in a call apply to each record in a single write. Adds a "Save only if the record hasn't changed" example (id + version filter, $inc version, check updated === 0).
• delete() / deleteMany(): Replaced "Permanently removes" with "moves to the entity's trash", with links to Recently deleted and the restore / permanent-delete REST endpoints. Both SDK calls soft-delete.
• User entity: Service role can read and update any user, and remove any user except the app owner. A removed user stays in Recently deleted for 30 days and is then deleted permanently. Replaces "read, update, and delete any user".

Follow-up

• Regenerate the SDK reference into mintlify-docs after merge.
• For the devs: verify Turnstile for app users, or deprecate the parameter.

🤖 Generated with Claude Code

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.56-pr.352.b15ea38

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.56-pr.352.b15ea38"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.56-pr.352.b15ea38"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.56-pr.352.b15ea38
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}