@wictorwilen/cocogen 1.0.50 → 1.1.0-preview.2

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0-preview.2] - 2026-04-07
+
+### Fixed
+- `npm run update-graph-profile-schema` now refreshes the profile CSDL snapshot from the official `microsoftgraph/msgraph-metadata` raw schema files because the live Graph `$metadata` endpoints no longer return XML reliably for this workflow.
+
+### Changed
+- People connector metadata refresh and validation now recognize the five current beta-only labels documented for people connectors: `personEducationalActivities`, `personInterests`, `personLanguages`, `personPatents`, and `personPublications`.
+- `externalConnection.contentCategory` now resolves to Graph `v1.0` capability in the generator metadata, matching `principal` and `principalCollection`.
+- People profile source registration now resolves to Graph `v1.0` capability as well, so stable people schemas no longer require preview features unless they use beta-only labels.
+
+## [1.1.0-preview.1] - 2026-03-31
+
+### Changed
+- Principal helper templates for generated TS and .NET connectors are now derived from the live Graph `microsoft.graph.externalConnectors.principal` metadata during `prebuild`, with a checked-in snapshot used as a fallback when metadata refresh is unavailable.
+- Principal and principal-collection schema property types now resolve to `v1.0` Graph capability instead of being treated as beta-only.
+
+### Fixed
+- Generated .NET `PropertyTransformBase` files now indent multi-line people transform expressions consistently, including nested serializer calls and collection object initializers.
+
+### Changed
+- Generated TS and .NET connector CLIs now support `--batch-size` for bounded parallel ingestion, with a default of `1` and a maximum of `20` concurrent item PUT requests per batch.
+
+### Fixed
+- Generated TS and .NET Graph transport layers now retry transient 408/429/5xx responses with exponential backoff, jitter, and `Retry-After`/`x-ms-retry-after-ms` handling, including raw profile-source admin HTTP calls.
+- Generated TypeScript people connectors now reference official stable and beta Microsoft Graph type packages for Graph profile payload models instead of fully redefining those models in generated code.
+- Generated TypeScript people helpers no longer emit redundant field-by-field runtime validation for SDK-backed Graph profile models; they keep only minimal object and read-only checks and still fully validate locally derived helper shapes.
+- Generated TypeScript people payload and transform files now import official stable and beta Microsoft Graph profile types directly instead of routing them through re-exports from `src/core/people.ts`.
+- Generated TypeScript people label serializers now route SDK-backed Graph profile payloads through shared generic SDK serialization helpers instead of emitting per-type validation wrappers.
+- Generated TypeScript connector runtimes now send Graph requests through the official Microsoft Graph client instead of a custom fetch-based transport layer.
+- Generated .NET people property transforms now instantiate official Microsoft Graph SDK profile model types for SDK-backed people payload shapes instead of emitting local copies of those Graph models.
+- Generated .NET people helpers no longer emit duplicate local Graph enum declarations when the generated payloads already bind to the official Microsoft Graph SDK enum types.
+- Generated TS and .NET people helpers now bind Graph `itemBody` through the official Microsoft Graph SDK model types instead of treating it as a local string-like special case.
+- Generated TS and .NET people helpers now omit local model and enum boilerplate when a connector is fully SDK-backed and only needs shared people payload validation/serialization utilities.
+- Generated .NET people payloads now pass inline per-property serialization options into a generic shared people helper instead of relying on emitted label-definition dictionaries and payload-kind enums.
+- Generated .NET people transforms no longer wrap SDK model object initializers in redundant outer casts before serializing them.
+- Generated TypeScript people helpers no longer export the internal label-serialization options type, and generated TS item payloads now avoid importing `contentPropertyName` when the schema has no content field.
+- Generated TypeScript property-transform files now import only the datasource and validation helpers that their rendered transform expressions actually use.
+- Generated TS and .NET people collection transforms no longer emit local `getCollectionValue` helpers when the rendered object graph only needs scalar per-index lookups.
+
 ## [1.0.50] - 2026-03-26
 
 ### Fixed
@@ -306,6 +345,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Collection values no longer split on commas; use semicolons instead.
 
 [Unreleased]: https://github.com/wictorwilen/cocogen/compare/v1.0.16...HEAD
+[1.1.0-preview.2]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.2
+[1.1.0-preview.1]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.1
 [1.0.50]: https://github.com/wictorwilen/cocogen/compare/main...v1.0.50
 [1.0.49]: https://github.com/wictorwilen/cocogen/compare/main...v1.0.49
 [1.0.48]: https://github.com/wictorwilen/cocogen/compare/main...v1.0.48

package/README.md

@@ -120,7 +120,7 @@ cocogen --help
 | `emit` | Emit cocogen IR as JSON | `--tsp <path>`, `--out <path>`, `--use-preview-features` |
 
 Notes:
-- `--use-preview-features` is required for Graph beta schemas (for example people connectors).
+- `--use-preview-features` is required only when a schema uses Graph beta capabilities such as beta-only people labels.
 
 ### Create a starter TypeSpec file
 
@@ -136,7 +136,7 @@ npx @wictorwilen/cocogen@latest init --prompt
 npx @wictorwilen/cocogen@latest validate --tsp ./schema.tsp
 ```
 
-Use `--use-preview-features` for Graph beta schemas (for example people connectors).
+Use `--use-preview-features` when cocogen reports a Graph beta requirement.
 
 ### Generate a runnable project
 
@@ -146,7 +146,7 @@ npx @wictorwilen/cocogen@latest generate --tsp ./schema.tsp --out ./my-connector
 
 Notes:
 - `cocogen` will fail fast if the schema is invalid.
-- Beta features require `--use-preview-features`.
+- Graph beta features require `--use-preview-features`.
 - Use `--data-format custom` to emit a stub datasource for custom backends.
 
 ### Update generated code after changing TypeSpec