external-consumers

External Consumers

Other repos consume APIs from this monorepo's extensions. Some are private.

• Exported extension APIs = public contracts
• Remove/change field, method, behavior = breaking
• Add field = non-breaking
• Cannot grep this monorepo alone — must check external repos
• Consumers version-gate (semver.satisfies) — major bump alone insufficient

On-demand validation via gh CLI

# search specific repo
gh api -X GET "search/code?q=SYMBOL+repo:forcedotcom/REPO&per_page=20" \
  --jq '.items[] | "\(.path)"'

# read file from private repo
gh api repos/forcedotcom/REPO/contents/PATH --jq '.content' | base64 -d

search all forcedotcom repos

gh api -X GET "search/code?q=SYMBOL+org:forcedotcom&per_page=30"
--jq '.items[] | "(.repository.name): (.path)"'

search salesforcecli org too

gh api -X GET "search/code?q=SYMBOL+org:salesforcecli&per_page=30"
--jq '.items[] | "(.repository.name): (.path)"'

Rate limit ~30 req/min on search API. Use contents API for targeted reads.

### ⚠️ Code search only indexes the DEFAULT branch

`search/code` never sees non-default branches ([GitHub docs](https://docs.github.com/en/search-github/github-code-search/about-github-code-search)). A repo whose shipping extension lives on a release branch (see einstein-gpt below) returns **zero hits** even when it heavily consumes core. Zero search hits ≠ no consumer. Confirm a repo's shipping branch (check `.github/workflows/*release*.yml` for the `ref:` it checks out), then walk that branch's tree + read files directly:

```bash
# find the ref the release workflow builds from
gh api repos/forcedotcom/REPO/contents/.github/workflows --jq '.[].name'
gh api "repos/forcedotcom/REPO/contents/.github/workflows/RELEASE.yml" --jq '.content' | base64 -d | grep -n 'ref:'

# list a non-default branch's files, then read the ones you care about
gh api "repos/forcedotcom/REPO/git/trees/BRANCH?recursive=1" --jq '.tree[].path'
gh api "repos/forcedotcom/REPO/contents/PATH?ref=BRANCH" --jq '.content' | base64 -d

Direct core API consumers (SalesforceVSCodeCoreApi)

Via vscode.extensions.getExtension('salesforce.salesforcedx-vscode-core').exports:

Repo	Visibility	Consumed
vscode-agents	Public	services.{ChannelService,TelemetryService,WorkspaceContext}
metadata-visualizer	Private	services.TelemetryService
code-analyzer	Public	services.WorkspaceContext (direct), telemetry via service-provider
einstein-gpt (Agentforce Vibes Autocomplete — see note)	Private	services.{ChannelService,WorkspaceContext,CommandEventDispatcher}, workspaceContextUtils.getOrgShape; reads optional SalesforceProjectConfig but has no production caller

einstein-gpt ships from a non-default branch. The published extension salesforce.agentforce-vibes-autocomplete is built from afv-v3.0-iac, not main; main:.github/workflows/iac-release.yml checks out that branch. It hard-depends on core and throws at activation when CommandEventDispatcher is absent. SalesforceProjectConfig differs: CoreExtensionService reads and stores it, accepts its absence, and only its unit test calls getSalesforceProjectConfig(). It is not a behavioral contract. Do not restore services.SalesforceProjectConfig to core based on this reference. Code search skips non-default branches; inspect afv-v3.0-iac directly.

Direct services API consumers (SalesforceVSCodeServicesApi)

Via vscode.extensions.getExtension('salesforce.salesforcedx-vscode-services'):

Repo	Visibility	Consumed
einstein-gpt	Private	services.ConnectionService.getConnection, services.TargetOrgRef, services.prebuiltServicesDependencies

einstein-gpt directly consumes the services extension API (separate from its core dependency and its @salesforce/vscode-service-provider telemetry use). packages/extension/src/services/auth/org-service.ts (on the actively-shipping main branch, which now builds afv-v4 via release.yml) resolves salesforce.salesforcedx-vscode-services, duplicates a local SalesforceVSCodeServicesApi type, and calls api.services.ConnectionService.getConnection(), api.services.TargetOrgRef(), and reads api.services.prebuiltServicesDependencies. Check changes to ConnectionService.getConnection, TargetOrgRef, or prebuiltServicesDependencies against this consumer — breaking any of them is a breaking change even though code search on main may not surface the duplicated type.

@salesforce/vscode-service-provider consumers

Repo (public) — abstraction bridging to core services. Still depends on core being active.

Repo	Service
code-analyzer	ServiceType.Telemetry
einstein-gpt	ServiceType.Telemetry

extensionDependency-only (no API consumption)

Repo	Visibility	Notes
ui-preview	Private	Activation ordering only. Uses bundled WorkspaceContextUtil from utils-vscode.

No current core dependency

Repo	Notes
slds	No extensionDep, no getExtension. In same extension pack.
apex-language-support	Experimental. String refs only in tests/comments.
apex-oas (in-repo)	extensionDependency = salesforcedx-vscode-apex + salesforcedx-vscode-services; no core dep. Reads project/registry/fs via services-extension api.services.*. Only cross-extension .exports use is apex's .languageClientManager.

In-repo consumers

IMPORTANT: In-repo packages access core API via TWO patterns:

1. Wrapper functions in coreExtensionUtils.ts (easy to grep)
2. Direct .exports.MEMBER() calls scattered across source files (easy to miss)

Always grep for \.exports\.\w+ across the full monorepo, not just coreExtensionUtils.ts.

Package	Files	Members accessed
apex-debugger	coreExtensionUtils.ts, index.ts	.telemetryService
apex-replay-debugger	index.ts, checkpointService.ts, quickLaunch.ts, debugConfigurationProvider.ts	.services.WorkspaceContext, .getUserId
utils-vscode	workspaceContextUtil.ts, telemetryUtils.ts	.getSharedTelemetryUserId (phantom — not on API type)

Keeping current

Verified 2026-07-21. Before asserting "nobody uses X":

1. Grep monorepo for \.exports\.MEMBER — catches direct access outside wrapper files
2. Search org:forcedotcom and org:salesforcecli via gh api
3. Read private repos via contents API
4. For repos that ship from a non-default branch (e.g. einstein-gpt → afv-v3.0-iac), inspect that branch directly — code search misses it (see the ⚠️ above)
5. Check extensionPack in salesforcedx-vscode and salesforcedx-vscode-expanded for new extensions