Skip to content

feat(entities): add cursor pagination, count(), aggregate(), and upsert() - #308

Merged
wixysam merged 1 commit into
mainfrom
entity-new-apis-docs
Oct 6, 2026
Merged

wixysam merged 1 commit into
mainfrom
entity-new-apis-docs

Conversation

@wixysam

@wixysam wixysam commented Oct 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds JSDoc for four new entity APIs: cursor-based pagination on list()/filter(), count(), aggregate(), and upsert(), including all new types (EntityPage, EntityListOptions, EntityDistinctOptions, EntityAggregateSpec, EntityDateBucket, EntityAggregateResult, EntityUpsertOptions, EntityUpsertResult, EntityFilterQuery).
  • Adds scripts/mintlify-post-processing/overload-presentation.json, a new pipeline config driving intro blurbs and labeled sections for overloaded methods (list()/filter()), plus generator fixes in file-processing.js and the TypeDoc plugin to support depth-aware heading rewriting for overloads.
  • Updates method-order.json (adds aggregate/upsert/importEntities in their final positions, with upsert placed at the create/update transition) and types-to-expose.json / types-to-delete-after-processing.json / appended-articles.json for the new types.
  • Adds two new writing-style rules to the sdk-docs-writing skill (no colon as a sentence break, don't start a sentence with lowercase inline code).

Test plan

  • npm run test:types (packages/sdk) — passes
  • npm run build (packages/sdk) — passes
  • Reviewer: run npm run create-docs-local from packages/sdk and spot-check the generated entities.mdx page renders correctly in mintlify-docs

🤖 Generated with Claude Code

…rt()

Documents and tunes doc-generation for four new entity APIs: cursor-based
pagination on list()/filter(), count(), aggregate(), and upsert(). Includes
JSDoc for all new types and overloads, a new overload-presentation config
for the pipeline, method ordering, and type-exposure config updates.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

🚀 Package Preview Available!


Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.53-pr.308.2df7905

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.53-pr.308.2df7905"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.53-pr.308.2df7905"
  }
}

Preview published to npm registry — try new features instantly!

@github-actions github-actions Bot added the docs-draft PR has auto-drafted documentation suggestions label Oct 6, 2026
@wixysam
wixysam merged commit f458486 into main Oct 6, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-draft PR has auto-drafted documentation suggestions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants