Skip to content

docs: add runtime services API reference chapter for services.{data,sharing,audit,queue,email,settings,storage} - #1347

Merged
hotlong merged 2 commits into
mainfrom
copilot/docs-add-services-api-reference
May 25, 2026
Merged

docs: add runtime services API reference chapter for services.{data,sharing,audit,queue,email,settings,storage}#1347
hotlong merged 2 commits into
mainfrom
copilot/docs-add-services-api-reference

Conversation

CopilotAI commented May 25, 2026

Copy link
Copy Markdown
Contributor

services.* runtime APIs were discoverable only by reading source, which created a DX gap for template/plugin authors. This PR adds a dedicated docs chapter covering signatures, params, returns, errors, examples, and API stability labeling for the requested service surfaces.

  • New chapter: Runtime Services API reference

    • Added content/docs/guides/runtime-services/ with per-service pages:
      • services.data
      • services.sharing
      • services.audit
      • services.queue
      • services.email
      • services.settings
      • services.storage
    • Added canonical source pointers on each page so docs map directly to TS contracts/runtime sources.
  • Examples added (M2 scope)

    • Added concrete examples page with:
      • reading related records in a flow custom node
      • checking sharing permissions in a hook
      • subscribing to kernel lifecycle/service events in a plugin
  • Versioning/stability (M3 scope)

    • Added dedicated versioning page with stable / experimental semantics.
    • Added current stability matrix for all documented runtime services.
    • Documented expectation to record breaking API changes in changelog + service page updates.
  • Docs IA + gap tracking updates

Example

constorder=awaitctx.services?.data?.get('sales_order',ctx.input.orderId);constlines=awaitctx.services?.data?.list('sales_order_line',{filter: {sales_order_id: order.id},sort: [{field: 'line_no',order: 'asc'}],top: 200,});

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • fastdl.mongodb.org
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./postinstall.js (dns block)
    • Triggering command: /opt/hostedtoolcache/node/24.15.0/x64/bin/node /opt/hostedtoolcache/node/24.15.0/x64/bin/node --experimental-import-meta-resolve --require /home/REDACTED/work/framework/framework/node_modules/.pnpm/vitest@4.1.7_@opentelemetry+api@1.9.1_@types+node@25.9.1_@vitest+coverage-v8@4.1.7_happ_72174171d7a0abbbb70f6d3c93d7d962/node_modules/vitest/suppress-warnings.cjs --conditions node --conditions development /home/REDACTED/work/framework/framework/node_modules/.pnpm/vitest@4.1.7_@opentelemetry+api@1.9.1_@types+node@25.9.1_@vitest+coverage-v8@4.1.7_happ_72174171d7a0abbbb70f6d3c93d7d962/node_modules/vitest/dist/workers/forks.js --global (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

@vercel

vercelBot commented May 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentMay 25, 2026 10:02am

Request Review

CopilotAI changed the title [WIP] Add documentation for services API methodsdocs: add runtime services API reference chapter for services.{data,sharing,audit,queue,email,settings,storage}May 25, 2026
CopilotAI requested a review from hotlongMay 25, 2026 10:01
@hotlong
hotlong marked this pull request as ready for review May 25, 2026 10:05
@hotlong
hotlong merged commit 5523c72 into mainMay 25, 2026
2 checks passed
Sign up for freeto 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.

[P3] docs: services.{data,sharing,audit,queue,email,settings,storage} APIs undocumented

2 participants

@hotlong