@typegraph/sdk

Quick-start • Docs • Use cases • Community

Support us by starring ⭐ this repository, joining the community on discussions 💬,
subscribing to releases 🔔, requesting a feature 💡 or even making a contribution :octocat:.

Metatype • the declarative API development platform

Programming is like castle building And castle building is hard. Even the best teams can struggle to build according to the plans, especially with the ever evolving needs and the tech landscape complexities.
	Build reliable castle with typegraphs Typegraphs are programmable virtual graphs describing all the components of your stack. They enable you to compose APIs, storage and business logic in a type safe manner.
Build modulable castle with typegate Typegate is a GraphQL/REST composition engine that compiles, optimizes, runs and caches queries over typegraphs. It enforces authentication, authorization and security for you.
	Build reusable castle with Metatype Install third parties as dependencies and start reusing components. The Meta CLI offers you live reloading and one-command deployment to Metatype cloud or your self-hosted instance.

Browse the documentation or start directly building your first typegraph!

back to top ↑

Development status

Metatype is still in beta and some interfaces are being stabilized, yet most of the engine is close to production readiness. As such, minor versions can contain breaking changes, but we are committed to providing a smooth upgrade path and the changes will be detailed in the changelog of each release (watch/subscribe to this repository to be notified).

back to top ↑

Contributing

If you have an idea or a suggestion that would make this better, please fork the repository and follow the step below to create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the repository
2. Clone your fork and follow the developer setup
3. Create a feature branch: git checkout -b feature/awesome-x
4. Commit your changes using conventional commits: git commit -am 'feat: add awesome x'
5. Push to the branch: git push origin feature/awesome-x
6. Open a pull request

First-time contributors can find a list of friendly issues for them to get started and discover step by step the platform.

back to top ↑

License

Copyright © Metatype OÜ. Distributed under various licenses, see LICENSE for the details. Contributions are welcomed and subject to a Contributor License Agreement (CLA).

back to top ↑

Changelog

v0.4.9-rc1 - 2024-09-02

Features

<details > <summary> (docs) Post on `Durable Execution`. (<a href="https://github.com/metatypedev/metatype/pull/816">#816</a>) </summary> </details> <details > <summary> (metagen) Client_ts (<a href="https://github.com/metatypedev/metatype/pull/790">#790</a>) </summary>

• Implements client_ts as described in #777 .

Migration notes

...

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

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->

Summary by CodeRabbit

• Bug Fixes

• Improved error handling in the typegraph function to provide better error messages.

• Chores

• Updated Docker image references to use docker.io prefix for consistency.

  • Excluded unnecessary files from the VSCode settings.
  • Enhanced configurability of Docker commands in development tasks.

• Updated environment variable GHJK_VERSION to reflect a semantic versioning format.

• New Features

• Introduced modules and methods for TypeScript and Python code generation in the metagen library, enhancing client generation capabilities.

  • Added test_typegraph_3 function for improved testing capabilities.
  • Included metadata for the package manager in the project settings.

<!-- end of auto-generated comment: release notes by coderabbit.ai --> </details> <details > <summary> (sub) Sdk and typing (<a href="https://github.com/metatypedev/metatype/pull/811">#811</a>) </summary>

User side of substantial

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

</details> <details > <summary> Add caching to Secrets struct to improve performance (<a href="https://github.com/metatypedev/metatype/pull/813">#813</a>) </summary>

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

</details>

Refactor

<details > <summary> (docs, gate) Push for `meta dev` instead of `meta typegate` on docs (<a href="https://github.com/metatypedev/metatype/pull/822">#822</a>) </summary> <!-- Pull requests are squashed and merged using: - their title as the commit message - their description as the commit body Having a good title and description is important for the users to get readable changelog. --> <!-- 1. Explain WHAT the change is about -->

Ensure documentation is pushing for meta dev instead of meta typegate

• [x] add a warning that envs are not set.

<!-- 2. Explain WHY the change cannot be made simpler -->

MET-635

<!-- 3. Explain HOW users should update their code -->

Migration notes

No Migration Needed

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

</details> <details > <summary> Flatten deps and improve repo folder (<a href="https://github.com/metatypedev/metatype/pull/821">#821</a>) </summary>

• Renames libs/ to src/.
• Moves typegate/, meta-cli, typegraph/, meta-lsp/ to src/.
• Renames dev/ to tools/
• Moves website/ to docs/metatype.dev/
• Moves src/typegate/tests to tests/
• Moves src/typegraph/deno/dev to tools/jsr/
• Moves src/typegraph/deno/sdk to src/typegraph/deno/
• Renames src/deno to src/mt_deno
• Bumps deno to 1.46.1
• Bumps rust toolchain to 1.80.1
• Moves all rust dependencies to workspace section
• Moves tools/task-*.ts to tools/task/*.ts
• Moves cliff.toml, Cross.toml, ruff.toml to tools/
• Uses deno workspaces to organize src/typegraph/deno, src/typegate, tools/, tests/ and more.
• Closes MET-607
• Updates poetry to 1.8.3
• Bumps metatype to version 0.4.9-rc1
• [x] Update CONTRIBUTING.md
• [x] Fix CI workflows
• [x] Fix Dockerfile
• [x] Fix all tests

Migration notes

• No end user changes required

• [x] The change comes with new or modified tests

• [ ] Hard-to-understand functions have explanatory comments

• [ ] End-user documentation is updated to reflect the change

---

</details>