Validate DocumentIdentifier arguments in API

[Copilot]

Invalid DocumentIdentifier objects produced an internal path.js error instead of identifying the malformed argument.

Changes

• Validate identifiers in resolveFileName and report their received shape.
• Accept DocumentIdentifier consistently in transpile-from-file and source-file metadata APIs.
• Cover invalid objects and URI identifiers in sync and async API tests.

Expected a string or { uri } for the document, received an object with keys: fileName

• Fixes [API] An invalid DocumentIdentifier fails with a TypeError from path.js rather than a message naming the argument #64068

[Copilot]

Pull request overview

Adds clear runtime validation for malformed DocumentIdentifier values and expands URI support across file-based APIs.

Changes:

• Validate identifier shape in resolveFileName.
• Accept URI identifiers in transpilation and metadata APIs.
• Add synchronous and asynchronous regression coverage.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/typescript/src/api/proto.ts	Adds identifier validation and descriptive errors.
packages/typescript/src/api/async/api.ts	Adds URI support to file-based async APIs.
packages/typescript/src/api/sync/api.ts	Mirrors async API changes in generated sync APIs.
packages/typescript/test/async/api.test.ts	Tests async validation and URI handling.
packages/typescript/test/sync/api.test.ts	Mirrors coverage for synchronous APIs.

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.