Skip to content

Conversation

@tbeseda
Copy link
Member

@tbeseda tbeseda commented Feb 7, 2026

need to merge #69 first

use @expand to help inline/flatten docs. particularly for all definer functions
++ miscellaneous fixes and tuning

also "FUTURE example"s to show kitchen-sink+references. they may not work yet so they don't make it into the docs yet (/* vs /** )

bonus: upload generated HTML as an artifact of the PR. bummed I couldn't find a way to make it viewable in the browser yet. one day

@tbeseda tbeseda self-assigned this Feb 7, 2026
@github-actions
Copy link

github-actions bot commented Feb 7, 2026

Coverage Report

Status Category Percentage Covered / Total
🔵 Lines 98.42% 626 / 636
🔵 Statements 96.19% 682 / 709
🔵 Functions 100% 69 / 69
🔵 Branches 94.14% 595 / 632
File Coverage
File Stmts Branches Functions Lines Uncovered Lines
Changed Files
src/definers/blueprints.ts 100% 100% 100% 100%
src/definers/cors.ts 100% 100% 100% 100%
src/definers/datasets.ts 100% 100% 100% 100%
src/definers/functions.ts 97.95% 95% 100% 100% 293
src/definers/resources.ts 100% 100% 100% 100%
src/definers/robotTokens.ts 100% 100% 100% 100%
src/definers/roles.ts 100% 100% 100% 100%
src/definers/webhooks.ts 100% 50% 100% 100%
src/types/cors.ts 100% 100% 100% 100%
src/types/datasets.ts 100% 100% 100% 100%
src/types/functions.ts 100% 100% 100% 100%
src/types/resources.ts 100% 100% 100% 100%
src/types/robotTokens.ts 100% 100% 100% 100%
src/types/roles.ts 100% 100% 100% 100%
src/types/webhooks.ts 100% 100% 100% 100%
Generated in workflow #215 for commit a59da10 by the Vitest Coverage Report Action

@github-actions
Copy link

github-actions bot commented Feb 7, 2026

📚 TypeDoc Generation Result

TypeDoc generated successfully!

  • File size: 260K
  • Total exports: 187
  • Artifact: typedoc-0cf5725bc6f37eef42f63221976aabc8c543ddae
  • HTML docs preview: Download artifact

The TypeDoc JSON file has been generated and validated. All documentation scripts completed successfully.

@tbeseda tbeseda marked this pull request as ready for review February 7, 2026 23:14
@tbeseda tbeseda requested a review from a team February 7, 2026 23:14
* dayOfWeek: '*',
* },
* name: 'daily-cleanup',
* event: {expression: 'every day at 9am'},
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we have another example shows the cron expression as well?

defineScheduleFunction({
   name: 'daily-cleanup',
   event: {expression: '0 9 * * *'},
})

Copy link
Member Author

@tbeseda tbeseda Feb 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think so too. I will merge #69 into this and then move a couple examples around and see where we're at.

This function is still "@hidden" so there's opportunity to add more docs.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added!
Looks like this if it wasn't @hidden

image

@socket-security
Copy link

socket-security bot commented Feb 8, 2026

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updatednpm/​@​vitest/​coverage-v8@​4.0.17 ⏵ 4.0.18991006999 +1100
Updatednpm/​vitest@​4.0.17 ⏵ 4.0.1896 +110079 +199 +1100
Updatednpm/​@​biomejs/​biome@​2.3.11 ⏵ 2.3.14100 +110010099 +2100

View full report

@tbeseda tbeseda merged commit 692dd50 into main Feb 9, 2026
14 checks passed
@tbeseda tbeseda deleted the tb/fix/docs/expand-types branch February 9, 2026 15:17
@squiggler squiggler bot mentioned this pull request Feb 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants