[@types/google-apps-script] Autogenerated Types for Google Apps Script

[jpoehnelt]

Please use this space to discuss the plan for the Google team(me) to autogenerate @types/google-apps-script and the associated changes.

Key Changes

• Namespace Alignment: The types will match the runtime environment. Consequently, the GoogleAppsScript namespace will be removed. This change is intended to better enable JSDoc usage and support using tsc without TypeScript annotations.
• Source of Truth: Type definitions will match the Reference Documentation exactly.
  • Note: Signatures may be added or removed based on the official docs.
  • No Patching: We will not accept patches to this package. Developers will need to create local declaration files for any undocumented types they rely on.
• Null Handling: Consistent handling of null values to match the internal runtime behavior.
• Contribution Model: External contributions to the types will no longer be accepted.

Versioning & Roadmap

Warning

This transition will result in breaking changes. To accommodate this, we will release these changes in v3 while deprecating v2.

• Q1: Core Apps Script types.
• Q2: Advanced Services types.