{"id":15419450,"url":"https://github.com/aacebo/teams-sdk-js","last_synced_at":"2025-03-02T02:32:11.852Z","repository":{"id":253170086,"uuid":"836461173","full_name":"aacebo/teams-sdk-js","owner":"aacebo","description":"a suite of packages used to build on the Teams Platform.","archived":false,"fork":false,"pushed_at":"2025-02-25T21:04:25.000Z","size":19441,"stargazers_count":4,"open_issues_count":10,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-25T21:33:23.948Z","etag":null,"topics":["ai","bots","chat","microsoft","microsoft-teams"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aacebo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-31T22:48:24.000Z","updated_at":"2025-02-20T20:36:05.000Z","dependencies_parsed_at":"2025-01-15T05:00:43.369Z","dependency_job_id":"0e1fd2f1-d49d-4bc4-aa23-f21ad37c9cd9","html_url":"https://github.com/aacebo/teams-sdk-js","commit_stats":{"total_commits":217,"total_committers":2,"mean_commits":108.5,"dds":0.01382488479262678,"last_synced_commit":"32b4d066e82154c54a99e85a0eda8d0e7baad223"},"previous_names":["aacebo/teams-sdk-js"],"tags_count":335,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aacebo%2Fteams-sdk-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aacebo%2Fteams-sdk-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aacebo%2Fteams-sdk-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aacebo%2Fteams-sdk-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aacebo","download_url":"https://codeload.github.com/aacebo/teams-sdk-js/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241191402,"owners_count":19925242,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","bots","chat","microsoft","microsoft-teams"],"created_at":"2024-10-01T17:25:06.411Z","updated_at":"2025-03-02T02:32:11.845Z","avatar_url":"https://github.com/aacebo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"./assets/icons/teams.png\" width=\"50px\" /\u003e Teams SDK: Javascript\n\n\u003ca href=\"#\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/package-json/v/aacebo/teams-sdk-js?label=npm\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/aacebo/teams-sdk-js/actions/workflows/pages/pages-build-deployment\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/aacebo/teams-sdk-js/pages/pages-build-deployment?label=documentation\" /\u003e\n\u003c/a\u003e\n\na suite of packages used to build on the Teams Platform.\n\n\u003ca href=\"https://aacebo.github.io/teams-sdk-js/2.getting-started/index.html\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge\" /\u003e\n\u003c/a\u003e\n\n\u003e ⚠️ **Warning**: this project is not supported or affiliated with Microsoft in any way!\n\n- [Documentation](https://aacebo.github.io/teams-sdk-js)\n- [Why?](#why)\n- [Design Philosophy](#design-philosophy)\n- [Scripts](#scripts)\n- [Packages](#packages)\n- [Samples](#samples)\n\n## Why?\n\nBuilding agents and bots for Microsoft Teams can often involve a lot of boilerplate code and managing numerous dependencies, which can be time-consuming and complex. Our new SDK aims to simplify this process by minimizing the boilerplate and dependencies required, while also providing helpful AI/Teams native abstractions. This allows developers to focus more on creating intelligent and effective bots, rather than getting bogged down in setup and configuration. By streamlining the development process, we hope to make it easier and faster to build powerful, AI-driven bots for Microsoft Teams.\n\n## Design Philosophy\n\nThese packages were designed with the following mentality to ensure longevity and sustainability.\n\n### Low Dependency\n\n[BotBuilder](https://github.com/microsoft/botbuilder-js) has struggled to support new LTS versions of node due to many dependencies being deprecated or requiring major version bumps (eg requires code changes to update).\n\nBy providing interfaces and default internal implementations, we mitigate this risk.\n\n\u003e ℹ️ **Note**: when necessary we will still use an external dependency, namely when an internal implementation is non-trivial.\n\n### Unopinionated\n\n[BotBuilder](https://github.com/microsoft/botbuilder-js) is a highly opinionated **Framework**, meaning it dictates many of the dos/don'ts of development with its packages.\n\nThis goal of this project is that they be a set of unopinionated packages that export simple abstractions for development in **Microsoft Teams**, leaving the app design descisions to the developer.\n\n## Scripts\n\n\u003e all scripts can be run for a particular workspace by appending `--workspace=${name}`\n\n### Build\n\n```bash\n$: npm run build\n```\n\n### Clean\n\n```bash\n$: npm run clean\n```\n\n### Format\n\n```bash\n$: npm run fmt\n```\n\n### Dev\n\n\u003e for apps/samples only\n\n```bash\n$: npm run dev\n```\n\n### Test\n\n\u003e for packages only\n\n```bash\n$: npm run test\n```\n\n## Packages\n\n- [`@teams.sdk/apps`](./packages/apps/README.md)\n- [`@teams.sdk/ai`](./packages/ai/README.md)\n- [`@teams.sdk/api`](./packages/api/README.md)\n- [`@teams.sdk/botbuilder`](./packages/botbuilder/README.md)\n- [`@teams.sdk/cards`](./packages/cards/README.md)\n- [`@teams.sdk/cli`](./packages/cli/README.md)\n- [`@teams.sdk/client`](./packages/client/README.md)\n- [`@teams.sdk/common`](./packages/common/README.md)\n- [`@teams.sdk/config`](./packages/config/README.md)\n- [`@teams.sdk/dev`](./packages/dev/README.md)\n- [`@teams.sdk/devtools`](./packages/devtools/README.md)\n- [`@teams.sdk/graph`](./packages/graph/README.md)\n- [`@teams.sdk/openai`](./packages/openai/README.md)\n\n## Samples\n\n- [`@samples/echo`](./samples/echo/README.md)\n- [`@samples/botbuilder`](./samples/botbuilder/README.md)\n- [`@samples/console`](./samples/console/README.md)\n- [`@samples/auth`](./samples/auth/README.md)\n- [`@samples/lights`](./samples/lights/README.md)\n- [`@samples/tab`](./samples/tab/README.md)\n\n## Links\n\n- [Teams Developer Portal: Apps](https://dev.teams.microsoft.com/apps)\n- [Teams Toolkit](https://www.npmjs.com/package/@microsoft/teamsapp-cli)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faacebo%2Fteams-sdk-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faacebo%2Fteams-sdk-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faacebo%2Fteams-sdk-js/lists"}