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.
@@ -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
+ [![Fancified](art/fancified.svg)](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
+ [![Fancified](art/fancified.svg)](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
+ ]