Skip to content

chore(workers): eliminate 20 private-type-ref diagnostics from the published export surface #1655

Description

@rickylabs

Summary

The published @netscript/plugin-workers export set currently produces 20 private-type-ref
diagnostics under the repository's full-export documentation lint. Publication dry-run remains a
separate gate, but a clean JSR documentation claim is not honest while these public signatures
resolve through private implementation types.

This is the durable owner for the pre-existing baseline discovered while planning #1378/#1545.
That quality-rail leaf must not absorb an unrelated Workers public-surface rewrite; it may record a
strict no-increase baseline linked here until this issue removes it.

Baseline

Measured on main 01e0960494c95ce56eb35892c211a095eb13e6ed on 2026-08-13:

deno task doc:lint --root plugins/workers --pretty
totalErrors: 20
totalPrivateTypeRef: 20
totalMissingJSDoc: 0
totalOther: 0
exitCode: 1

The auto-discovered surface contains 13 export targets. Eight currently contribute diagnostics:

Export target private-type-ref
./bin/runtime.ts 9
./contracts/v1/mod.ts 7
./doctor.ts 1
./mod.ts 1
./services/src/main.ts 1
./streams/mod.ts 4
./streams/server.ts 7
./worker/mod.ts 3

Counts overlap because the same underlying private type can be reachable from multiple public
entrypoints; the repository reporter deduplicates the combined package total to 20.

Acceptance

Boundaries

Part of #1276. Discovered during 0.0.7 planning for #1378/#1545.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions