@wictorwilen/cocogen 1.0.50 → 1.1.0-preview.10

package/CHANGELOG.md

@@ -7,6 +7,78 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0-preview.10] - 2026-04-08
+
+## [1.1.0-preview.9] - 2026-04-08
+
+### Fixed
+- Restored `.NET` people payload serialization parity using final-stage label cleanup in `PeoplePayload.SerializeStringLabel(...)` and `PeoplePayload.SerializeCollectionLabel(...)`: collection `@odata.type` values now include the leading `#` (for example `#Collection(String)`), Kiota date objects are normalized back to `yyyy-MM-dd` strings, enum values are serialized as strings, and useful fields carried via `AdditionalData` are preserved instead of being dropped during normalization.
+- Updated generated `.NET` `FromRow.cs` assignments to use typed `TransformProperty<T>(...)` calls, removing nullable cast warnings (`CS8600`/`CS8601`) caused by the previous `object?` cast path.
+
+## [1.1.0-preview.8] - 2026-04-08
+
+### Changed
+- **For .NET people connectors with custom transforms:** The generated `PropertyTransformBase.cs` no longer embeds normalization logic in each serialization expression. Instead, hand-off to `PeoplePayload.SerializePeopleEntity(object)` which handles serialization + normalization (strips Kiota metadata, removes nulls, converts to camelCase) in one call. If you have custom `PropertyTransform.cs` overrides, they will automatically benefit from normalization; no code changes required. The method signature remains `protected virtual string? Transform<PropName>(object row)`.
+
+## [1.1.0-preview.7] - 2026-04-08
+
+## [1.1.0-preview.6] - 2026-04-07
+
+## [1.1.0-preview.5] - 2026-04-07
+
+### Changed
+- Generated people connector `provision` commands no longer auto-register the connection as a profile source; use the dedicated `register-profile-source` command instead.
+
+## [1.1.0-preview.4] - 2026-04-07
+
+### Fixed
+- Generated `.NET` people payload helpers no longer re-validate serialized JSON field names and read-only item facet fields at runtime; they now rely on schema validation and typed construction, while still enforcing collection limits.
+
+## [1.1.0-preview.3] - 2026-04-07
+
+### Fixed
+- `cocogen update` now refreshes generated `.NET` `Program.cs` files even without `--include-scaffold`, so schema-driven entrypoint changes do not stay stale after updates.
+- Validation now warns when people-label `@coco.source(..., to)` mappings reference unknown Graph target paths (for example `program.fieldOfStudy` instead of `program.fieldsOfStudy`) so fallback object generation is easier to diagnose.
+
+## [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 +378,16 @@ 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.10]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.10
+[1.1.0-preview.9]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.9
+[1.1.0-preview.8]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.8
+[1.1.0-preview.7]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.7
+[1.1.0-preview.6]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.6
+[1.1.0-preview.5]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.5
+[1.1.0-preview.4]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.4
+[1.1.0-preview.3]: https://github.com/wictorwilen/cocogen/compare/main...v1.1.0-preview.3
+[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

@@ -31,6 +31,7 @@
 ## What you can do with the generated project 🔧
 - ✅ Create or update an external connection
 - ✅ Patch schema changes
+- ✅ Register a people profile source with a dedicated command
 - ✅ Ingest items from CSV (or your own datasource)
 - ✅ Retry throttled requests with backoff + logging
 - ✅ Customize transforms without losing changes on update
@@ -120,7 +121,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 +137,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 +147,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
@@ -159,6 +160,8 @@ When you change the schema, regenerate only the TypeSpec-derived files:
 npx @wictorwilen/cocogen@latest update --out ./my-connector
 ```
 
+For generated .NET projects, `update` also refreshes `Program.cs` because it carries schema-derived wiring such as the item model and people-connector provisioning flow.
+
 Override the TypeSpec entrypoint (also updates `cocogen.json`):
 
 ```bash