Changelog • AutoDeskR

AutoDeskR 0.5.0

CRAN release: 2026-05-28

autodeskr_mcp_tools() — expose all AutoDeskR API functions to AI models via the Model Context Protocol (MCP); credentials are read from environment variables so no token argument is required. Requires ellmer and mcptools.
waitForPhotoscene() — poll checkPhotoscene() until a Reality Capture photoscene processing job completes.

pkgdown site added and deployed to GitHub Pages at https://paulgovan.github.io/AutoDeskR/ via a new GitHub Actions workflow.
inst/CITATION updated to reference the current companion book at https://paulgovan.github.io/AutoDeskR-Book/.
ellmer and mcptools added to Suggests.

translateSvf2() — translate design files to SVF2 format (~30% smaller than SVF, faster rendering in the Viewer).
createPhotoscene(), uploadImages(), processPhotoscene(), checkPhotoscene() — Reality Capture API for photogrammetry and 3D model generation from images.
waitForFile() — poll checkFile() until a Model Derivative translation completes.
waitForWorkItem() — poll checkPdf() until a Design Automation WorkItem completes.
is_expired() — check whether an aps_token has expired.
aps_error() — structured S3 error condition for APS API failures; catch with tryCatch(..., aps_error = function(e) ...).

getToken() now returns an aps_token object with expiry tracking ($expires_at, is_expired()). Existing code using resp$content$access_token continues to work unchanged.
All API functions now accept an aps_token object in place of a raw token string. Expired tokens trigger a warning.
API errors now include decoded JSON messages from APS rather than raw HTTP error text.
as_tibble() methods added for listBuckets and listObjects response objects (requires the tibble package).

Fixed <- arrow-assignment bugs in getData(), getObjectTree(), translateObj(), translateStl(), and getOutputUrn() roxygen examples.
Fixed unreachable vr template branch in viewerUI().

Updated viewer CDN URLs from deprecated viewingservice/v1/viewers/ to modelderivative/v2/viewers/7.*. Templates also modernized to use Autodesk.Viewing.GuiViewer3D and Document.load() (v7 API).
Added req_timeout(60) to all API requests.
Updated all remaining “AutoDesk Forge” terminology to “AutoDesk Platform Services (APS)” across README, vignettes, and HTML templates.

Added Config/testthat/edition: 3 for testthat 3rd-edition behavior.
Added print() S3 methods for all 18 response classes.
Expanded test coverage: NULL-token guards for all functions, DELETE mock fixtures, downloadFile JSON response path.

checkPdf(): The source and destination parameters are now deprecated. Pass the WorkItem id (from makePdf()$content$id) as the new id parameter instead. Using the old parameters issues a deprecation warning.

Migrated HTTP backend from httr to httr2. All HTTP errors now raise R errors rather than warnings.
Authentication updated from the deprecated v1 endpoint (/authentication/v1/authenticate, end-of-life May 2024) to the v2 endpoint (/authentication/v2/token).
Design Automation API updated from the retired AutoCAD.io v2 endpoint to the Design Automation v3 API (/da/us-east/v3/workitems).
downloadFile(): Added optional destfile parameter and correct handling of binary (non-JSON) responses.
Bug fix: viewerUI() viewerType validation logic was always evaluating to TRUE; corrected to properly reject invalid types.

Added a testthat + httptest2 test suite covering input validation and mocked API responses. No real AutoDesk credentials are required to run tests.

CRAN release: 2024-09-10

CRAN release: 2017-07-09