Thanks @snapwich for the detailed explanation. We use typescript for all our ad tags we build and provide our own set of types for prebid.js.

Prebid.js will probably not be rewritten in typescript as that is a huge refactor.

Airbnb released an interesting tool that might make this more feasible.

https://github.com/airbnb/ts-migrate

OR we could maintain a separate types repo within definitelytyped or in the prebid organization.

I would heavily favor hosting this inside the prebid repository. This ties the types much closer to the actual releases

Bid adapters could be submitted as .ts files and we could update our webpack build to accommodate building both typescript or javascript files. This would be considered a backwards breaking change since it would break webpack builds outside of the prebid repo (such as people using prebid.js as an npm dependency) that assume all modules are javascript. Since it's backwards breaking we probably wouldn't do this until a major release down the line, which could take awhile if we choose to go this route

That would be amazing. We had quite a few bugs, because of different formats things can have, e.g.

• size definition: '300x250' or [300, 250] or [[300, 250]]`
• bid adapter parameters had types, invalid types, no examples

I doubt we'd ever start typing internal core code as there is much less value there and it would require a lot more effort.

I wouldn't say that. There are quite a few very complex modules with very complex data structures. I'm always having a hard time reading the code as the types are never clear nor have names. This makes it much harder for external publishers / advertisers to contribute.

So overall I think adapting typescript would be beneficial for

• external contributions
• bug rate
• documentation effort
• ease of adapter implementation
• reduce of unit testing ( half of the unit tests check that the things you put in are transformed into another thing)

@snapwich Hey Rich -- how's this initiative going? Worth discussing next steps in our next meeting?

@gglas It's not going right now, haha. I reverted my PoC and just submitted generated JS to get the adapter merged; but yes, it is worth discussing next steps I think. I still think there is value here that we could gain.

@nickjacob Patrick asked me to ping you in on this -- we'll be strategizing on our rollout of typescript over the next few months, would love additional help and input!

I wonder if #5001 would also be an option that can be discussed. If migrating prebid.js to typescript is a huge effort, then maybe this time is better spent setting up a "new" prebid with prebid right from the start, but with the features defined there.

Prebid.js will be around for quite sometime, but the shift to prebid server has started and a lot adapters and modules will be irrelevant as these are already (or hopefully will be) available on prebid server.

This is a wild suggestion, but regarding limited resources this maybe a good option.

@muuki88 i agree, if a re-write of prebid.js were to happen i'd propose that it should be written in typescript. however, the #5001 proposal is essentially for an adapter-less version of prebid.js where, i think, the most value for typings would reside: typing the prebid -> adapter interface. for that reason i think the discussion of introducing types to this version of prebid.js is still really important and needs to be considered.

@snapwich would this be a breaking change? if not, we can just prioritize in the feature queue and not having to wait for a new version.

Just wanted to chime in and say that we have partial types for Prebid, based off the documentation, and that can be seen as a WIP here

I would be happy to help bring some of these as *.d.ts files to provide types. It would be especially helpful for accessing window.pbjs methods safely. Currently we still have quite a few unknowns because we only aim to make these types useful for us.

The bidResponses could also be typed by individual modules, as we’ve done for XaxisBidResponse

potentially fixed by #5218

noting googletag types are here https://github.com/DefinitelyTyped/DefinitelyTyped/blob/f97b33075210e0c85a4b415025382c65959e4ff2/types/googletag/index.d.ts