Skip to content

ts(docs): Add typedoc to client hosted with GHPages - #648

Merged
dines-rl merged 36 commits into
mainfrom
dines/type-doc
Nov 18, 2025
Merged

ts(docs): Add typedoc to client hosted with GHPages#648
dines-rl merged 36 commits into
mainfrom
dines/type-doc

Conversation

@dines-rl

@dines-rl dines-rl commented Nov 11, 2025

Copy link
Copy Markdown
Contributor

V1 of Typedocs for the Client

  • Posts to GH pages
  • Examples for complicated pages
  • sdk.ts is now the root file of the project NOT index.ts
image

@codeant-ai

codeant-ai Bot commented Nov 11, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is reviewing your PR.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@codeant-ai

codeant-ai Bot commented Nov 11, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI finished reviewing your PR.

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@codeant-ai

codeant-ai Bot commented Nov 13, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is running Incremental review


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@codeant-ai codeant-ai Bot added the size:XXL This PR changes 1000+ lines, ignoring generated files label Nov 13, 2025
@codeant-ai

codeant-ai Bot commented Nov 13, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI Incremental review completed.

@codeant-ai

codeant-ai Bot commented Nov 14, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is running Incremental review


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@codeant-ai codeant-ai Bot added size:XXL This PR changes 1000+ lines, ignoring generated files and removed size:XXL This PR changes 1000+ lines, ignoring generated files labels Nov 14, 2025
@codeant-ai

codeant-ai Bot commented Nov 14, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI Incremental review completed.

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@dines-rl dines-rl changed the title [WIP] Add typedoc Add typedoc Nov 18, 2025
@dines-rl dines-rl changed the title Add typedoc ts(docs) Add typedoc to client hosted with GHPages Nov 18, 2025
@codeant-ai

codeant-ai Bot commented Nov 18, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is running Incremental review


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@dines-rl dines-rl changed the title ts(docs) Add typedoc to client hosted with GHPages ts(docs): Add typedoc to client hosted with GHPages Nov 18, 2025
@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@codeant-ai codeant-ai Bot added size:XXL This PR changes 1000+ lines, ignoring generated files and removed size:XXL This PR changes 1000+ lines, ignoring generated files labels Nov 18, 2025
@codeant-ai

codeant-ai Bot commented Nov 18, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI Incremental review completed.

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@sid-rl sid-rl left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good to me! Make sure to change all imports in test files to .../src/sdk/... instead of .../src/objects/...

@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 0% 100%
Lines 0% - ℹ️
Branches 0% - ℹ️
Statements 0% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 0% 100%
Lines 0% - ℹ️
Branches 0% - ℹ️
Statements 0% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 0% 100%
Lines 0% - ℹ️
Branches 0% - ℹ️
Statements 0% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 0% 100%
Lines 0% - ℹ️
Branches 0% - ℹ️
Statements 0% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@jrvb-rl jrvb-rl left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

A few minor questions.

I skimmed over the new internal docs - presumably there is a better way to look at those, so I can do that next and add more comments to the PR if I find any issues.

Comment on lines +19 to +22
- name: tar the existing docs
run: |
mkdir -p ./docs
tar -cvf documentation.tar ./docs

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

if there is no .docs dir, should we create an error rather than an empty tar file? I assume things would just fail if the tar command exits with nonzero status, so just taking out the mkdir would do the trick?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

this is within the GH page repo, so if it doesn't exist it makes an empty one if it does it tars it up

uses: actions/download-artifact@v3
with:
name: documentation
- run: tar -xf documentation.tar ./docs -C ./docs

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Is there a reason we want to only untar things that start with ./docs? (probably fine given how the archive is created, but maybe would be confusing if we add more dirs later and they don't show up?)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

this is just for GH pages so yeah just that one

uses: actions/download-artifact@v3
with:
name: newdocumentation
- run: tar -xf newdocumentation.tar ./docs -C ./docs

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

same comment here on the ./docs arg

Comment on lines +54 to +55
* - `success`: Boolean indicating if exit code is 0
* - `failed`: Boolean indicating if exit code is non-zero

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Do we really have both booleans? Why?

@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 99.07% 100%
Lines 86.98% - ℹ️
Branches 57.3% - ℹ️
Statements 86.45% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

❌ Object Smoke Tests Failed

Test Results

❌ Some smoke tests failed

Please fix the failing tests before checking coverage.

📋 View full test logs

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.27% - ℹ️
Branches 57.3% - ℹ️
Statements 86.74% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@dines-rl
dines-rl merged commit 851f5f1 into main Nov 18, 2025
8 checks passed
@dines-rl
dines-rl deleted the dines/type-doc branch November 18, 2025 22:01
@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.27% - ℹ️
Branches 57.3% - ℹ️
Statements 86.74% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL This PR changes 1000+ lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants