fancy-microsoft-teams 0.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- fancy_microsoft_teams-0.2.0/.gitignore +24 -0
- fancy_microsoft_teams-0.2.0/CHANGELOG.md +55 -0
- fancy_microsoft_teams-0.2.0/LICENSE +21 -0
- fancy_microsoft_teams-0.2.0/PKG-INFO +154 -0
- fancy_microsoft_teams-0.2.0/README.md +132 -0
- fancy_microsoft_teams-0.2.0/art/fancified.svg +26 -0
- fancy_microsoft_teams-0.2.0/pyproject.toml +87 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/__init__.py +41 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/_fake.py +170 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/_runtime.py +569 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/actions/__init__.py +18 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/actions/meeting_create.py +156 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/actions/meeting_get.py +86 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/actions/transcript_list.py +88 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/faker.py +163 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/py.typed +0 -0
- fancy_microsoft_teams-0.2.0/src/fancy_microsoft_teams/service.py +73 -0
- fancy_microsoft_teams-0.2.0/tests/test_faker.py +114 -0
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
node_modules/
|
|
2
|
+
dist/
|
|
3
|
+
vendor/
|
|
4
|
+
.venv/
|
|
5
|
+
__pycache__/
|
|
6
|
+
*.egg-info/
|
|
7
|
+
.pytest_cache/
|
|
8
|
+
.ruff_cache/
|
|
9
|
+
.mypy_cache/
|
|
10
|
+
|
|
11
|
+
# Lockfiles are NOT source of a generated repo.
|
|
12
|
+
#
|
|
13
|
+
# The generator cannot emit one -- a lockfile is the result of a network
|
|
14
|
+
# resolve -- and "a provider repo must be generated and re-generatable" is the
|
|
15
|
+
# constraint the whole estate rests on. At a few hundred repos, a committed
|
|
16
|
+
# lockfile each is a few hundred files nothing can regenerate and a few hundred
|
|
17
|
+
# Dependabot surfaces.
|
|
18
|
+
#
|
|
19
|
+
# The trade is real and worth stating: CI resolves fresh on every run, so an
|
|
20
|
+
# upstream release inside the declared range can break a build with no change
|
|
21
|
+
# here. That is early warning rather than a surprise at publish time, and the
|
|
22
|
+
# ranges are deliberately narrow (>=X <2.0, never a caret on a 0.x).
|
|
23
|
+
composer.lock
|
|
24
|
+
package-lock.json
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Changelog — Microsoft Teams
|
|
2
|
+
|
|
3
|
+
All four packages — `@particle-academy/microsoft-teams-ui`, `@particle-academy/microsoft-teams-js`,
|
|
4
|
+
`particle-academy/microsoft-teams-php` and `fancy-microsoft-teams` — are released together
|
|
5
|
+
under one version. They are generated from one `provider/` definition, so a
|
|
6
|
+
change to it changes all four, and separate version lines would only record
|
|
7
|
+
which of the four somebody remembered to bump.
|
|
8
|
+
|
|
9
|
+
**Write entries HERE**, in the weaver envelope at `providers/microsoft-teams/CHANGELOG.md`,
|
|
10
|
+
then regenerate. This file is the one thing in a release that cannot be
|
|
11
|
+
derived — somebody has to write what changed — but writing it in the
|
|
12
|
+
provider repo would be a hand-edit that `.weaver.json` flags and the next
|
|
13
|
+
sync destroys.
|
|
14
|
+
|
|
15
|
+
## [0.2.0] — 2026-11-08
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
|
|
19
|
+
- **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
|
|
20
|
+
through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
|
|
21
|
+
outside a Laravel app none of it loads.
|
|
22
|
+
- a service provider that merges `config/microsoft-teams.php` under
|
|
23
|
+
`connectors.microsoft-teams` (credentials from the environment, or per call for a
|
|
24
|
+
multi-account app);
|
|
25
|
+
- the `MicrosoftTeams` facade: `MicrosoftTeams::call('<operation>', [...])` runs any action;
|
|
26
|
+
- `MicrosoftTeams::fake()`, answered from the connector's faker, with
|
|
27
|
+
`assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
|
|
28
|
+
- its own Pest test of all of it against a booted Laravel app.
|
|
29
|
+
|
|
30
|
+
### Changed
|
|
31
|
+
|
|
32
|
+
- **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
|
|
33
|
+
dependency (the framework this package integrates with; nothing ships in
|
|
34
|
+
`require`).
|
|
35
|
+
|
|
36
|
+
## [0.1.0] — 2026-09-16
|
|
37
|
+
|
|
38
|
+
### Added
|
|
39
|
+
|
|
40
|
+
- **`meeting_create`** — create a Teams meeting on behalf of a user and get its join link (`POST /users/{userId}/onlineMeetings`, application permission `OnlineMeetings.ReadWrite.All`).
|
|
41
|
+
- **`meeting_get`** — read a meeting's current details (`GET /users/{userId}/onlineMeetings/{meetingId}`).
|
|
42
|
+
- **`transcript_list`** — a finished meeting's transcripts (`GET /users/{userId}/onlineMeetings/{meetingId}/transcripts`, application permission `OnlineMeetingTranscript.Read.All`). Only `transcriptContentUrl` is published, a raw-VTT download reached directly — unlike Google Meet, Graph exposes no structured per-utterance JSON here, so no text-extraction action was built, the same "bytes never pass through the connector" call Resend already made.
|
|
43
|
+
- OAuth2 at `login.microsoftonline.com`, reusing microsoft-outlook's already-verified `refreshTokenRotates: false` reasoning and M365 Developer Program sandbox note. Every operation additionally requires a tenant administrator to grant this app an application access policy naming the target user — consent alone is not enough.
|
|
44
|
+
|
|
45
|
+
**This is the THIRD and LAST connector prerequisite for Tynn #9 (MOIC's
|
|
46
|
+
meeting bot), after Zoom and Google Meet.** The BOT RUNTIME — a service that
|
|
47
|
+
actually joins a call and streams live media — is the owner's architecture
|
|
48
|
+
decision, not this connector's; Graph's own path there is an
|
|
49
|
+
application-hosted media bot (a .NET/Azure service), not a REST connector.
|
|
50
|
+
What ships here: create a meeting, read it back, and find a finished
|
|
51
|
+
meeting's transcript.
|
|
52
|
+
|
|
53
|
+
Verified against Microsoft Learn's own reference pages
|
|
54
|
+
(`application-post-onlinemeetings`, `onlinemeeting-get`,
|
|
55
|
+
`onlinemeeting-list-transcripts`) on 2026-09-16.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Particle Academy
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: fancy-microsoft-teams
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: Microsoft Teams for Python — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP; no vendor SDK.
|
|
5
|
+
Project-URL: Homepage, https://github.com/Fancy-Friends/microsoft-teams
|
|
6
|
+
Project-URL: Issues, https://github.com/Fancy-Friends/microsoft-teams/issues
|
|
7
|
+
Project-URL: Source, https://github.com/Fancy-Friends/microsoft-teams
|
|
8
|
+
Author: Particle Academy
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: api,connector,fancy-flow,messaging,microsoft_teams,particle-academy
|
|
12
|
+
Classifier: Development Status :: 3 - Alpha
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
18
|
+
Classifier: Topic :: Software Development :: Libraries
|
|
19
|
+
Classifier: Typing :: Typed
|
|
20
|
+
Requires-Python: >=3.11
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
|
|
23
|
+
# Microsoft Teams
|
|
24
|
+
|
|
25
|
+
[](https://particle.academy)
|
|
26
|
+
|
|
27
|
+
Microsoft Teams for [fancy-flow][flow] — as **four imported, versioned packages**, one
|
|
28
|
+
per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
|
|
29
|
+
change.
|
|
30
|
+
|
|
31
|
+
[flow]: https://github.com/Particle-Academy/fancy-flow
|
|
32
|
+
|
|
33
|
+
| Runtime | Package | Install |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| Authoring surface (every host) | `@particle-academy/microsoft-teams-ui` | `npm install @particle-academy/microsoft-teams-ui` |
|
|
36
|
+
| Node | `@particle-academy/microsoft-teams-js` | `npm install @particle-academy/microsoft-teams-js` |
|
|
37
|
+
| PHP 8.4+ | `particle-academy/microsoft-teams-php` | `composer require particle-academy/microsoft-teams-php` |
|
|
38
|
+
| Python 3.11+ | `fancy-microsoft-teams` | `pip install fancy-microsoft-teams` |
|
|
39
|
+
|
|
40
|
+
The `ui` package is the editor surface and is React on every host — a PHP or
|
|
41
|
+
Python project installs it *and* its own runtime package, and never the `js` one.
|
|
42
|
+
|
|
43
|
+
## What it costs you
|
|
44
|
+
|
|
45
|
+
One dependency: `@particle-academy/fancy-connector-core` (or
|
|
46
|
+
`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
|
|
47
|
+
packages pull in themselves. The Python package has **zero** runtime
|
|
48
|
+
dependencies.
|
|
49
|
+
|
|
50
|
+
**No Microsoft Teams SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
|
|
51
|
+
subject to the kit's full approval bar, and one per provider is hundreds of
|
|
52
|
+
dependencies nobody is tracking.
|
|
53
|
+
|
|
54
|
+
## Setting it up
|
|
55
|
+
|
|
56
|
+
Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
|
|
57
|
+
|
|
58
|
+
### On Microsoft Teams's side
|
|
59
|
+
|
|
60
|
+
1. **Register an app and add the OAuth redirect URL** — In the Microsoft Entra admin center, App registrations, register (or reuse) an app and add **your host's OAuth redirect URL** under Authentication as a Web redirect URI. Record the Application (client) ID and create a client secret. ([learn.microsoft.com](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app))
|
|
61
|
+
2. **Grant the app an application access policy naming the target user** — OAuth consent alone does not authorize meeting_create, meeting_get or transcript_list -- Microsoft Graph refuses every call with "No application access policy found for this app" until a tenant administrator runs New-CsApplicationAccessPolicy (with this app's client ID) and Grant-CsApplicationAccessPolicy naming the userId these operations will act on. Changes take up to 30 minutes to reach the Graph REST API. ([learn.microsoft.com](https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy))
|
|
62
|
+
|
|
63
|
+
### Credentials
|
|
64
|
+
|
|
65
|
+
A Microsoft Teams connection holds 4 values.
|
|
66
|
+
|
|
67
|
+
**Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
|
|
68
|
+
|
|
69
|
+
| Field | Scope | Secret | Where it comes from |
|
|
70
|
+
|---|---|---|---|
|
|
71
|
+
| **Application (client) ID** | per installation | not secret | From the Microsoft Entra admin center -> App registrations. ONE value for the whole installation, not per connected account. |
|
|
72
|
+
| **Client secret** | per installation | **secret** | A client secret of the same app registration. One value for the whole installation; Entra expires them, so record the expiry. |
|
|
73
|
+
| **Access token** | per connected account | **secret** | Per connected Microsoft account, and it expires after about ONE HOUR. The host refreshes it with the refresh token. |
|
|
74
|
+
| **Refresh token** *(optional)* | per connected account | **secret** | Per connected Microsoft account; issued only when the consent request includes offline_access. Every refresh answers with a NEW one -- persist it. |
|
|
75
|
+
|
|
76
|
+
### Authorising
|
|
77
|
+
|
|
78
|
+
Microsoft Teams uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
|
|
79
|
+
|
|
80
|
+
- **Authorize URL** — https://login.microsoftonline.com/common/oauth2/v2.0/authorize
|
|
81
|
+
- **Token URL** — https://login.microsoftonline.com/common/oauth2/v2.0/token
|
|
82
|
+
- **Scopes** — `OnlineMeetings.ReadWrite.All`, `OnlineMeetingTranscript.Read.All`, `offline_access`
|
|
83
|
+
- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
|
|
84
|
+
|
|
85
|
+
The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
|
|
86
|
+
|
|
87
|
+
### The estate
|
|
88
|
+
|
|
89
|
+
Microsoft Teams has a test estate on the same host, reached with credentials from a SEPARATE test account you register. Selecting sandbox mode uses those credentials.
|
|
90
|
+
|
|
91
|
+
> Microsoft's test estate is a Microsoft 365 Developer Program sandbox: a separate E5 tenant with its own users and its own OAuth consent, on the SAME host -- the same fact microsoft-outlook already verified for Graph generally. Eligibility is limited (Visual Studio Professional/Enterprise, ISV Success / MAICPP partners, or Premier/Unified Support) and the tenant expires after 90 days of no development activity. Without one, every call reaches a real tenant.
|
|
92
|
+
|
|
93
|
+
## What it can do
|
|
94
|
+
|
|
95
|
+
### Actions
|
|
96
|
+
|
|
97
|
+
#### `meeting_create` — Create meeting
|
|
98
|
+
|
|
99
|
+
Create a Teams meeting on behalf of a user and get its join link.
|
|
100
|
+
|
|
101
|
+
`POST /v1.0/users/{userId}/onlineMeetings` · **unsafe to replay** — a retried durable run does it TWICE
|
|
102
|
+
|
|
103
|
+
| Input | Required | What it is |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| `userId` | yes | The Microsoft Entra object id of the user the meeting is created on behalf of -- the one named in the application access policy a tenant admin granted this app. |
|
|
106
|
+
| `subject` | no | Subject |
|
|
107
|
+
| `startDateTime` | yes | ISO 8601 with an offset or Z, e.g. 2026-09-22T14:00:00Z. |
|
|
108
|
+
| `endDateTime` | yes | ISO 8601 with an offset or Z. |
|
|
109
|
+
| `passcodeRequired` | no | Passcodes are auto-generated by Teams; a custom one is not supported. Leave off for no passcode. |
|
|
110
|
+
|
|
111
|
+
#### `meeting_get` — Get meeting
|
|
112
|
+
|
|
113
|
+
Read a Teams meeting's current details.
|
|
114
|
+
|
|
115
|
+
`GET /v1.0/users/{userId}/onlineMeetings/{meetingId}` · reads only — safe to replay
|
|
116
|
+
|
|
117
|
+
| Input | Required | What it is |
|
|
118
|
+
|---|---|---|
|
|
119
|
+
| `userId` | yes | The meeting organizer's Microsoft Entra object id. |
|
|
120
|
+
| `meetingId` | yes | From meeting_create's data.id. |
|
|
121
|
+
|
|
122
|
+
#### `transcript_list` — List transcripts
|
|
123
|
+
|
|
124
|
+
List a finished meeting's transcripts and their download URLs.
|
|
125
|
+
|
|
126
|
+
`GET /v1.0/users/{userId}/onlineMeetings/{meetingId}/transcripts` · reads only — safe to replay
|
|
127
|
+
|
|
128
|
+
| Input | Required | What it is |
|
|
129
|
+
|---|---|---|
|
|
130
|
+
| `userId` | yes | The meeting organizer's Microsoft Entra object id. |
|
|
131
|
+
| `meetingId` | yes | From meeting_create's data.id. |
|
|
132
|
+
|
|
133
|
+
## Run it before you have credentials
|
|
134
|
+
|
|
135
|
+
Every operation ships a **faker**, whether or not Microsoft Teams has a sandbox. Set a
|
|
136
|
+
node's mode to `fake` and it returns the shape Microsoft Teams actually publishes — the
|
|
137
|
+
same field names, deterministically — so you can wire the downstream nodes before
|
|
138
|
+
touching an account, a key, or a network.
|
|
139
|
+
|
|
140
|
+
## This repository is generated
|
|
141
|
+
|
|
142
|
+
`provider/` is the source. Everything under `packages/` is emitted from it and
|
|
143
|
+
**must not be hand-edited** — CI regenerates and diffs on every push, and the
|
|
144
|
+
next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
|
|
145
|
+
|
|
146
|
+
## Two namespaces, which do not match on purpose
|
|
147
|
+
|
|
148
|
+
The repo is `github.com/Fancy-Friends/microsoft-teams`; the packages publish under
|
|
149
|
+
`particle-academy`. Nothing derives one from the other — the names come from
|
|
150
|
+
weaver's `friends.json` and nowhere else.
|
|
151
|
+
|
|
152
|
+
## Licence
|
|
153
|
+
|
|
154
|
+
MIT.
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# Microsoft Teams
|
|
2
|
+
|
|
3
|
+
[](https://particle.academy)
|
|
4
|
+
|
|
5
|
+
Microsoft Teams for [fancy-flow][flow] — as **four imported, versioned packages**, one
|
|
6
|
+
per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
|
|
7
|
+
change.
|
|
8
|
+
|
|
9
|
+
[flow]: https://github.com/Particle-Academy/fancy-flow
|
|
10
|
+
|
|
11
|
+
| Runtime | Package | Install |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| Authoring surface (every host) | `@particle-academy/microsoft-teams-ui` | `npm install @particle-academy/microsoft-teams-ui` |
|
|
14
|
+
| Node | `@particle-academy/microsoft-teams-js` | `npm install @particle-academy/microsoft-teams-js` |
|
|
15
|
+
| PHP 8.4+ | `particle-academy/microsoft-teams-php` | `composer require particle-academy/microsoft-teams-php` |
|
|
16
|
+
| Python 3.11+ | `fancy-microsoft-teams` | `pip install fancy-microsoft-teams` |
|
|
17
|
+
|
|
18
|
+
The `ui` package is the editor surface and is React on every host — a PHP or
|
|
19
|
+
Python project installs it *and* its own runtime package, and never the `js` one.
|
|
20
|
+
|
|
21
|
+
## What it costs you
|
|
22
|
+
|
|
23
|
+
One dependency: `@particle-academy/fancy-connector-core` (or
|
|
24
|
+
`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
|
|
25
|
+
packages pull in themselves. The Python package has **zero** runtime
|
|
26
|
+
dependencies.
|
|
27
|
+
|
|
28
|
+
**No Microsoft Teams SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
|
|
29
|
+
subject to the kit's full approval bar, and one per provider is hundreds of
|
|
30
|
+
dependencies nobody is tracking.
|
|
31
|
+
|
|
32
|
+
## Setting it up
|
|
33
|
+
|
|
34
|
+
Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
|
|
35
|
+
|
|
36
|
+
### On Microsoft Teams's side
|
|
37
|
+
|
|
38
|
+
1. **Register an app and add the OAuth redirect URL** — In the Microsoft Entra admin center, App registrations, register (or reuse) an app and add **your host's OAuth redirect URL** under Authentication as a Web redirect URI. Record the Application (client) ID and create a client secret. ([learn.microsoft.com](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app))
|
|
39
|
+
2. **Grant the app an application access policy naming the target user** — OAuth consent alone does not authorize meeting_create, meeting_get or transcript_list -- Microsoft Graph refuses every call with "No application access policy found for this app" until a tenant administrator runs New-CsApplicationAccessPolicy (with this app's client ID) and Grant-CsApplicationAccessPolicy naming the userId these operations will act on. Changes take up to 30 minutes to reach the Graph REST API. ([learn.microsoft.com](https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy))
|
|
40
|
+
|
|
41
|
+
### Credentials
|
|
42
|
+
|
|
43
|
+
A Microsoft Teams connection holds 4 values.
|
|
44
|
+
|
|
45
|
+
**Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
|
|
46
|
+
|
|
47
|
+
| Field | Scope | Secret | Where it comes from |
|
|
48
|
+
|---|---|---|---|
|
|
49
|
+
| **Application (client) ID** | per installation | not secret | From the Microsoft Entra admin center -> App registrations. ONE value for the whole installation, not per connected account. |
|
|
50
|
+
| **Client secret** | per installation | **secret** | A client secret of the same app registration. One value for the whole installation; Entra expires them, so record the expiry. |
|
|
51
|
+
| **Access token** | per connected account | **secret** | Per connected Microsoft account, and it expires after about ONE HOUR. The host refreshes it with the refresh token. |
|
|
52
|
+
| **Refresh token** *(optional)* | per connected account | **secret** | Per connected Microsoft account; issued only when the consent request includes offline_access. Every refresh answers with a NEW one -- persist it. |
|
|
53
|
+
|
|
54
|
+
### Authorising
|
|
55
|
+
|
|
56
|
+
Microsoft Teams uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
|
|
57
|
+
|
|
58
|
+
- **Authorize URL** — https://login.microsoftonline.com/common/oauth2/v2.0/authorize
|
|
59
|
+
- **Token URL** — https://login.microsoftonline.com/common/oauth2/v2.0/token
|
|
60
|
+
- **Scopes** — `OnlineMeetings.ReadWrite.All`, `OnlineMeetingTranscript.Read.All`, `offline_access`
|
|
61
|
+
- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
|
|
62
|
+
|
|
63
|
+
The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
|
|
64
|
+
|
|
65
|
+
### The estate
|
|
66
|
+
|
|
67
|
+
Microsoft Teams has a test estate on the same host, reached with credentials from a SEPARATE test account you register. Selecting sandbox mode uses those credentials.
|
|
68
|
+
|
|
69
|
+
> Microsoft's test estate is a Microsoft 365 Developer Program sandbox: a separate E5 tenant with its own users and its own OAuth consent, on the SAME host -- the same fact microsoft-outlook already verified for Graph generally. Eligibility is limited (Visual Studio Professional/Enterprise, ISV Success / MAICPP partners, or Premier/Unified Support) and the tenant expires after 90 days of no development activity. Without one, every call reaches a real tenant.
|
|
70
|
+
|
|
71
|
+
## What it can do
|
|
72
|
+
|
|
73
|
+
### Actions
|
|
74
|
+
|
|
75
|
+
#### `meeting_create` — Create meeting
|
|
76
|
+
|
|
77
|
+
Create a Teams meeting on behalf of a user and get its join link.
|
|
78
|
+
|
|
79
|
+
`POST /v1.0/users/{userId}/onlineMeetings` · **unsafe to replay** — a retried durable run does it TWICE
|
|
80
|
+
|
|
81
|
+
| Input | Required | What it is |
|
|
82
|
+
|---|---|---|
|
|
83
|
+
| `userId` | yes | The Microsoft Entra object id of the user the meeting is created on behalf of -- the one named in the application access policy a tenant admin granted this app. |
|
|
84
|
+
| `subject` | no | Subject |
|
|
85
|
+
| `startDateTime` | yes | ISO 8601 with an offset or Z, e.g. 2026-09-22T14:00:00Z. |
|
|
86
|
+
| `endDateTime` | yes | ISO 8601 with an offset or Z. |
|
|
87
|
+
| `passcodeRequired` | no | Passcodes are auto-generated by Teams; a custom one is not supported. Leave off for no passcode. |
|
|
88
|
+
|
|
89
|
+
#### `meeting_get` — Get meeting
|
|
90
|
+
|
|
91
|
+
Read a Teams meeting's current details.
|
|
92
|
+
|
|
93
|
+
`GET /v1.0/users/{userId}/onlineMeetings/{meetingId}` · reads only — safe to replay
|
|
94
|
+
|
|
95
|
+
| Input | Required | What it is |
|
|
96
|
+
|---|---|---|
|
|
97
|
+
| `userId` | yes | The meeting organizer's Microsoft Entra object id. |
|
|
98
|
+
| `meetingId` | yes | From meeting_create's data.id. |
|
|
99
|
+
|
|
100
|
+
#### `transcript_list` — List transcripts
|
|
101
|
+
|
|
102
|
+
List a finished meeting's transcripts and their download URLs.
|
|
103
|
+
|
|
104
|
+
`GET /v1.0/users/{userId}/onlineMeetings/{meetingId}/transcripts` · reads only — safe to replay
|
|
105
|
+
|
|
106
|
+
| Input | Required | What it is |
|
|
107
|
+
|---|---|---|
|
|
108
|
+
| `userId` | yes | The meeting organizer's Microsoft Entra object id. |
|
|
109
|
+
| `meetingId` | yes | From meeting_create's data.id. |
|
|
110
|
+
|
|
111
|
+
## Run it before you have credentials
|
|
112
|
+
|
|
113
|
+
Every operation ships a **faker**, whether or not Microsoft Teams has a sandbox. Set a
|
|
114
|
+
node's mode to `fake` and it returns the shape Microsoft Teams actually publishes — the
|
|
115
|
+
same field names, deterministically — so you can wire the downstream nodes before
|
|
116
|
+
touching an account, a key, or a network.
|
|
117
|
+
|
|
118
|
+
## This repository is generated
|
|
119
|
+
|
|
120
|
+
`provider/` is the source. Everything under `packages/` is emitted from it and
|
|
121
|
+
**must not be hand-edited** — CI regenerates and diffs on every push, and the
|
|
122
|
+
next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
|
|
123
|
+
|
|
124
|
+
## Two namespaces, which do not match on purpose
|
|
125
|
+
|
|
126
|
+
The repo is `github.com/Fancy-Friends/microsoft-teams`; the packages publish under
|
|
127
|
+
`particle-academy`. Nothing derives one from the other — the names come from
|
|
128
|
+
weaver's `friends.json` and nowhere else.
|
|
129
|
+
|
|
130
|
+
## Licence
|
|
131
|
+
|
|
132
|
+
MIT.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="28" role="img" aria-label="Fancified — built with Fancy UI">
|
|
2
|
+
<title>Fancified · built with Fancy UI</title>
|
|
3
|
+
<defs>
|
|
4
|
+
<linearGradient id="fcdBg" x1="0" y1="0" x2="1" y2="1">
|
|
5
|
+
<stop offset="0" stop-color="#6d28d9"/>
|
|
6
|
+
<stop offset=".5" stop-color="#9333ea"/>
|
|
7
|
+
<stop offset="1" stop-color="#d946ef"/>
|
|
8
|
+
</linearGradient>
|
|
9
|
+
<linearGradient id="fcdGloss" x1="0" y1="0" x2="0" y2="1">
|
|
10
|
+
<stop offset="0" stop-color="#ffffff" stop-opacity=".30"/>
|
|
11
|
+
<stop offset=".55" stop-color="#ffffff" stop-opacity="0"/>
|
|
12
|
+
</linearGradient>
|
|
13
|
+
<clipPath id="fcdClip"><rect width="128" height="28" rx="7"/></clipPath>
|
|
14
|
+
</defs>
|
|
15
|
+
<g clip-path="url(#fcdClip)">
|
|
16
|
+
<rect width="128" height="28" fill="url(#fcdBg)"/>
|
|
17
|
+
<rect width="34" height="28" fill="#3b0764" fill-opacity=".5"/>
|
|
18
|
+
<rect width="128" height="13" fill="url(#fcdGloss)"/>
|
|
19
|
+
<g fill="#fff">
|
|
20
|
+
<path transform="translate(17 14)" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
|
|
21
|
+
<path transform="translate(25.5 7.5) scale(.34)" fill-opacity=".85" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
|
|
22
|
+
</g>
|
|
23
|
+
<text x="81" y="18.5" fill="#ffffff" text-anchor="middle" font-family="'Segoe UI',Verdana,'DejaVu Sans',sans-serif" font-size="12" font-weight="700" letter-spacing=".3">Fancified</text>
|
|
24
|
+
</g>
|
|
25
|
+
<rect x=".5" y=".5" width="127" height="27" rx="6.5" fill="none" stroke="#ffffff" stroke-opacity=".22"/>
|
|
26
|
+
</svg>
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling>=1.27"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "fancy-microsoft-teams"
|
|
7
|
+
version = "0.2.0"
|
|
8
|
+
description = "Microsoft Teams for Python — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP; no vendor SDK."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
# 3.11 matches fancy-flow-py's floor: 3.10 reaches end of life on 2026-10-31,
|
|
11
|
+
# and a floor that dies before the package's second release is not a floor.
|
|
12
|
+
requires-python = ">=3.11"
|
|
13
|
+
license = "MIT"
|
|
14
|
+
license-files = ["LICENSE"]
|
|
15
|
+
authors = [{ name = "Particle Academy" }]
|
|
16
|
+
keywords = ["microsoft_teams", "messaging", "connector", "api", "fancy-flow", "particle-academy"]
|
|
17
|
+
classifiers = [
|
|
18
|
+
"Development Status :: 3 - Alpha",
|
|
19
|
+
"Intended Audience :: Developers",
|
|
20
|
+
"Programming Language :: Python :: 3",
|
|
21
|
+
"Programming Language :: Python :: 3.11",
|
|
22
|
+
"Programming Language :: Python :: 3.12",
|
|
23
|
+
"Programming Language :: Python :: 3.13",
|
|
24
|
+
"Topic :: Software Development :: Libraries",
|
|
25
|
+
"Typing :: Typed",
|
|
26
|
+
]
|
|
27
|
+
|
|
28
|
+
# ZERO runtime dependencies, and that is a design constraint rather than an
|
|
29
|
+
# accident. There is no Python twin of fancy-connector-core to depend on, and a
|
|
30
|
+
# vendor SDK is third-party code subject to the kit's full approval bar — one
|
|
31
|
+
# SDK per provider is hundreds of dependencies nobody is tracking. The HTTP is
|
|
32
|
+
# stdlib `urllib`; the HMAC is stdlib `hmac`.
|
|
33
|
+
dependencies = []
|
|
34
|
+
|
|
35
|
+
[project.urls]
|
|
36
|
+
Homepage = "https://github.com/Fancy-Friends/microsoft-teams"
|
|
37
|
+
Issues = "https://github.com/Fancy-Friends/microsoft-teams/issues"
|
|
38
|
+
Source = "https://github.com/Fancy-Friends/microsoft-teams"
|
|
39
|
+
|
|
40
|
+
[dependency-groups]
|
|
41
|
+
# Not optional. A package with no way to run its tests reports green by doing
|
|
42
|
+
# nothing, which is the one defect that hides itself.
|
|
43
|
+
test = ["pytest>=8.0"]
|
|
44
|
+
lint = ["ruff>=0.16"]
|
|
45
|
+
typecheck = ["mypy>=1.11"]
|
|
46
|
+
dev = [{ include-group = "test" }, { include-group = "lint" }, { include-group = "typecheck" }]
|
|
47
|
+
|
|
48
|
+
[tool.hatch.build.targets.wheel]
|
|
49
|
+
packages = ["src/fancy_microsoft_teams"]
|
|
50
|
+
|
|
51
|
+
[tool.hatch.build.targets.sdist]
|
|
52
|
+
include = ["/src", "/tests", "/art", "/README.md", "/CHANGELOG.md", "/LICENSE"]
|
|
53
|
+
|
|
54
|
+
[tool.pytest.ini_options]
|
|
55
|
+
testpaths = ["tests"]
|
|
56
|
+
# importlib mode pairs with src-layout: the working tree is never on sys.path,
|
|
57
|
+
# so the tests exercise the INSTALLED package. Under the default mode a missing
|
|
58
|
+
# py.typed or an unshipped file passes locally and breaks for every user.
|
|
59
|
+
addopts = "--import-mode=importlib -ra"
|
|
60
|
+
|
|
61
|
+
[tool.ruff]
|
|
62
|
+
line-length = 100
|
|
63
|
+
src = ["src", "tests"]
|
|
64
|
+
target-version = "py311"
|
|
65
|
+
|
|
66
|
+
[tool.ruff.lint]
|
|
67
|
+
# `S` — flake8-bandit — is ON, and it is the one addition worth arguing for: this
|
|
68
|
+
# package handles a credential, builds an HMAC, and opens a URL. Security lint
|
|
69
|
+
# belongs on exactly this code.
|
|
70
|
+
#
|
|
71
|
+
# It also makes the two `# noqa: S310` in _runtime.py MEANINGFUL. Without `S`
|
|
72
|
+
# selected, ruff reports them as unused directives (RUF100) and the obvious fix
|
|
73
|
+
# is to delete them — which quietly removes a security annotation because a
|
|
74
|
+
# linter was not looking for it.
|
|
75
|
+
select = ["E", "F", "I", "UP", "B", "SIM", "RUF", "N", "C4", "PT", "S"]
|
|
76
|
+
|
|
77
|
+
[tool.ruff.lint.per-file-ignores]
|
|
78
|
+
# pytest's whole idiom is bare `assert`. S101 would fail every test file.
|
|
79
|
+
"tests/*" = ["S101"]
|
|
80
|
+
|
|
81
|
+
[tool.mypy]
|
|
82
|
+
python_version = "3.11"
|
|
83
|
+
packages = ["fancy_microsoft_teams"]
|
|
84
|
+
mypy_path = "src"
|
|
85
|
+
strict = true
|
|
86
|
+
disallow_any_expr = false
|
|
87
|
+
disallow_any_explicit = false
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# GENERATED FILE — do not edit.
|
|
2
|
+
#
|
|
3
|
+
# Emitted from provider/manifest.json by weaver's generator.
|
|
4
|
+
# A hand-edit here is destroyed by the next protocol sync, which is worse than
|
|
5
|
+
# being rejected, because it works until it silently does not. Fix
|
|
6
|
+
# provider/manifest.json (or weaver's template/) and regenerate:
|
|
7
|
+
#
|
|
8
|
+
# npm run provider -- microsoft_teams
|
|
9
|
+
|
|
10
|
+
"""Microsoft Teams for Python.
|
|
11
|
+
|
|
12
|
+
The service descriptor, its faker, its delivery contract, and one function
|
|
13
|
+
per operation — plain HTTP on the stdlib, no vendor SDK and no runtime
|
|
14
|
+
dependency.
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
from __future__ import annotations
|
|
18
|
+
|
|
19
|
+
from ._fake import FakeValues
|
|
20
|
+
from .actions.meeting_create import meeting_create
|
|
21
|
+
from .actions.meeting_get import meeting_get
|
|
22
|
+
from .actions.transcript_list import transcript_list
|
|
23
|
+
from .faker import respond
|
|
24
|
+
from .service import BASE_URLS, CONNECTOR_API_VERSION, REQUIRES, SANDBOX, SERVICE, TITLE, descriptor
|
|
25
|
+
|
|
26
|
+
__version__ = "0.2.0"
|
|
27
|
+
|
|
28
|
+
__all__ = [
|
|
29
|
+
"BASE_URLS",
|
|
30
|
+
"CONNECTOR_API_VERSION",
|
|
31
|
+
"REQUIRES",
|
|
32
|
+
"SANDBOX",
|
|
33
|
+
"SERVICE",
|
|
34
|
+
"TITLE",
|
|
35
|
+
"FakeValues",
|
|
36
|
+
"descriptor",
|
|
37
|
+
"meeting_create",
|
|
38
|
+
"meeting_get",
|
|
39
|
+
"respond",
|
|
40
|
+
"transcript_list",
|
|
41
|
+
]
|