v0.5.1-rc.1

[github-actions[bot]]

v0.5.1-rc.1 - 2025-03-20

Bug Fixes

(gate) Skip unnecessary secret decryption step on `SYNC_FORCE_REMOVE` (#976)

Migration notes

None

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Introduced a secure, improved mechanism for downloading type graph
  data, enhancing the retrieval process and ensuring sensitive data is
  handled safely.

• Refactor

• Updated processes to consistently leverage the new download approach,
  streamlining functionality and reinforcing robust error handling.

(gate) Struct typecheck codegen (#983)

• Fixup for fix(typegraph): implement additional_props #980

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Enhanced object validation now accepts additional properties when
  allowed, offering more flexible data processing.

• Introduced a new REST endpoint that returns structured, stringified
  data based on provided input.

• Tests

• Added a test case to verify the functionality of the new REST endpoint
  and ensure robust input validation.

(metagen) Do not skip empty struct input (#989)

• Make sure to include empty struct input in manifest
• Update json schema
• Bump version to v0.5.1-rc.1

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• Chores
• Updated versions across packages, dependencies, container images, and
  configurations to v0.5.1-rc.1 for enhanced consistency.
• New Features
• Introduced a new configuration option allowing users to exclude client
  code generation.
• Added new type definitions in sample integrations to improve
  type-safety.

(test) Add lockfile for metagen test (#981)

• Fixes the build issue by adding a lockfile.

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

(typegraph) Implement `additional_props` (#980)

• Closes
  MET-843.

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Introduced a configurable flag in object definitions that controls
  whether extra, unspecified properties are allowed. This enhances schema
  validation and data conversion by permitting flexible input when
  enabled.

• Updated validation logic to conditionally bypass errors for additional
  properties when permitted.

• Tests

• Added new test cases and a helper function to verify input
  stringification and validation for both simple and nested structures.

Bad typenames and internal policy (#979)

• Fix bad duplicated typenames for duplicate materializers and
  predefined internal policy function.

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

Summary by CodeRabbit

• New Features
• Enhanced access control with stricter authorization checks and refined
  data exposure across different contexts.
• Introduced new type aliases for improved clarity in method return
  types.
  • Added a new internal policy for access control.
• Refactor
• Streamlined naming for inputs and outputs to ensure consistent
  labeling.
  • Adjusted evaluation logic to provide clearer security outcomes.
• Tests
• Expanded automated test scenarios to verify deduplication and
  authorization behavior.
  • Added new test cases to validate internal policy access control.

Features

(gate) Policies should affect visibility on introspection (#963) - BREAKING: policies should affect visibility on introspection (#963)

This ended up becoming a full rewrite of the introspection logic.
For context, the old implementation generated types dynamically but also
did a few parts statically (the __schema.types list). This worked as
long as we assume all object types fields are not context dependent.
Which resulted in a few bugs on injected fields.

In this new implementation, we "define" a type as required (it is added
into the __schema.types list), still recursively but this allows
emitting types with adhoc suffixes in demand depending on the policies
or injections. Then when the type is refered we simply give a reference
to it.

Migration notes

• There can be multiple empty object scalars (vs only one previously)
• Fields can be missing if not authorized
• Type names depends on its shape (e.g.Foo missing a field would have
  different name than Foo with all its field), this extends to unions
  (depends on the variant names with each following the same naming rule)

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

Summary by CodeRabbit

• New Features

• Enhanced GraphQL introspection now offers a more comprehensive and
  consistent schema view with refined field visibility controls.

• New introspection queries and fragments improve the introspection
  capabilities of the GraphQL API.

• Introduced new functions for managing type visibility and policies
  within the type graph context.

• Added new test functions to validate introspection queries and their
  structures.

• Refactor

• Improved runtime initialization and error handling lead to a smoother
  query engine performance and more robust schema generation.

• Code structure has been enhanced for better organization and clarity,
  particularly in type visibility management.

• Modifications to authorization checks and policy evaluations enhance
  granularity and processing efficiency.

• Tests

• Expanded test coverage validates the new introspection enhancements
  and policy enforcement, ensuring reliable operation.

• New tests focus on visibility checks and policy rule logic during
  introspection on complex and simple type graphs.

• Added tests for introspection functionalities and visibility policies
  in various scenarios, ensuring comprehensive validation.

(metagen) Hostcall transport (#982) - BREAKING: hostcall transport (#982)

• update docs
• HostcallTransport for fdk_rs/fdk_ts/fdk_py
• Reimpml fdk_py
• MET-815 QueryGraph method clash

Migration notes

• fdk_rs: transport construction is no longer a method on QueryGraph
  but a set of functions in th transports module.
• fdk_ts: transport construction is no longer a method on QueryGraph
  but instead a static method on Transports class.
• fdk_py now generates all code into fdk.py
  • Decorators now use the handler_{fn_name} pattern
  • Decorators now expect a second Ctx object.
• Ctx.gql method now takes typing.Mapping instead of raw JSON str
• Transport construction is no longer a method on QueryGraph but
  instead a static method on Transports class.

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

Summary by CodeRabbit

• New Features

• Introduced enhanced GraphQL client transports that support
  asynchronous host calls and refined query handling, enabling more robust
  queries, mutations, and file upload operations.

• Added new HostcallPump class for managing host calls and responses,
  improving the handling of asynchronous operations.

• Expanded functionality for handling selections and query construction,
  including new types and methods in the QueryGraph class.

• Updated Cargo.toml configurations to include workspace features for
  metagen-client, allowing for specific feature activation.

• Adjusted the typegraphUrl format in the hostcallCtx for improved
  communication protocols.

• Refactors & Chores

• Streamlined internal architecture by consolidating transport logic and
  improving type mapping and dependency management across modules.

• Removed legacy code and enhanced error handling and logging for
  increased stability.

• Adjusted paths and target architecture in build scripts for
  consistency with updated directory structures.

• Tests & Documentation

• Expanded and reorganized test suites to verify the new client and
  query graph functionality, with updated configuration options detailed
  in the documentation.

• Enhanced test cases for better coverage of new features and
  functionalities, including proxy primitives and selection handling.

• Updated test configurations to reflect new dependencies and structural
  changes in the codebase.

(sdk) Reusable import module (#970)

• Closes
  MET-819.

JSON RPC based typegraph (#877) - BREAKING: JSON RPC based typegraph (#877)

Tasks

Replace WASM in typegraph with a client/server architecture using JSON
RPC through stdin/stdout.

• Remove wit from typgraph-core
• Codegen system for the SDK types
• Rewrite the client SDKs
• Write the JSON RPC server in the CLI
• Update the build infrastructure
• Fix broken tests

Migration notes

...

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

---

Refactor

Break up the common crate into smaller ones (#977)

• Break up the common crate into a few smaller crates:
  • typegraph/schema
  • utils/grpc
  • utils/archive
  • typegate_api

Migration notes

---

• The change comes with new or modified tests
• Hard-to-understand functions have explanatory comments
• End-user documentation is updated to reflect the change

Summary by CodeRabbit

• New Features

• Exposed an updated public API with dedicated interfaces for
  authentication and node management.

• Refactor

• Streamlined dependency and workspace organization by replacing legacy
  naming with clearer, modern module references.

• Chores

• Updated package configurations to improve maintainability and set the
  stage for future enhancements.

These changes maintain all existing functionality while providing a more
cohesive architecture and clearer public interfaces for end-user
interactions.

---

This discussion was created from the release v0.5.1-rc.1.