Przejdź do treści
marcinnowak.me
← notatki
#npm#teams#dokumentacja

Pakiet wycofany wstecznie, a szablon dalej go generuje

npm pokazuje deprecated na całej historii wersji @microsoft/teams.dev, a oficjalne narzędzie Microsoftu nadal tworzy projekty, które go wymagają.

Sprawdzone na działającym kodzie: 6 września 2026

Budowałem bota do Teams i chciałem lokalne narzędzie do podglądu rozmowy. Dokumentacja mówi: @microsoft/teams.dev. Instalacja mówi co innego.

Pakiet ma znacznik deprecated na całej historii wersji, założony wstecznie — nie tylko na najnowszej. Zastępuje go Microsoft 365 Agents Playground. Tymczasem oficjalne CLI dalej generuje projekty, które tego pakietu wymagają.

Drugi problem: sztywny peer

@microsoft/teams.dev@2.0.12 wymaga @microsoft/teams.apps w wersji dokładnie 2.0.12 — nie ^2.0.12. A teams.apps jest już na 2.0.16.

Efekt: świeżo wygenerowany szablon, który w package.json ma "latest", nie przyjmie narzędzia z własnej dokumentacji. ERESOLVE.

Co z tego wynika

Sonda, którą robiłem przy tym samym odcinku, pokazała, że lokalne modele nie znają aktualnego SDK — pięć modeli, pięć nietrafień. Łatwo z tego zrobić wniosek „modele mają starą wiedzę, dokumentacja jest źródłem prawdy”.

Ten przypadek pokazuje, że to za proste. Zestarzała się dokumentacja producenta, a nie pamięć modelu. Sprawdzenie w rejestrze npm zajmuje jedno polecenie i jest jedynym miejscem, gdzie widać stan faktyczny:

npm view @microsoft/teams.dev

Odruch wart wyrobienia: zanim uwierzysz nazwie pakietu — obojętnie, czy podał ją model, czy dokumentacja — zapytaj rejestr.