Merge pull request #86 from basehub-ai/changeset-release/main

Version Packages

Author: julianbenegas

.changeset/smooth-dots-greet.md

@@ -1,5 +1,57 @@
 # basehub
 
+## 4.0.0
+
+### Major Changes
+
+- 7a85095: # New `fragmentOn` helper to extract fragments
+
+  In this new major version, we're introducing `fragmentOn`, a simpler way to create fragments in the `basehub` SDK.
+
+  Previously, in order to reuse a fragment, you'd do something like this:
+
+  ```ts
+  // old way 👎
+  import {
+    LinkComponentGenqlSelection,
+    LinkComponent,
+    FieldsSelection,
+  } from "basehub";
+
+  const LinkFragment = {
+    href: true,
+    label: true,
+  } satisfies LinkComponentGenqlSelection;
+
+  // extract the type
+  type LinkFragment = FieldsSelection<LinkComponent, typeof LinkFragment>;
+  ```
+
+  Looks simple, but it's a bit hard to understand. You need to know that we're exposing a `LinkComponentGenqlSelection`, and that you should use the `satisfies` so the object's type is constrained but also can be more specific. Then, to extract the type, you'd get `FieldsSelection`, and finally, `LinkComponent`. A lot of types!
+
+  Moreover, if you needed to create another fragment, it'd be this same process, over and over again.
+
+  This is how it's done in the new version:
+
+  ```ts
+  // new way 👍
+  import { fragmentOn } from "basehub";
+
+  const LinkFragment = fragmentOn("LinkComponent", {
+    href: true,
+    label: true,
+  });
+
+  // extract the type
+  type LinkFragment = fragmentOn.infer<typeof LinkFragment>;
+  ```
+
+  Much simpler!
+
+  ## Why is this a breaking change
+
+  Before this version, we exposed a lot of the internal types from `'basehub'`. We now don't. Some applications might depend on this, and that's why this is a breaking change. If you need those types for some reason that wasn't discussed in this document, feel free to raise an issue and we can see to bring them back.
+
 ## 3.2.0
 
 ### Minor Changes

packages/basehub/CHANGELOG.md

@@ -2,7 +2,7 @@
   "name": "basehub",
   "description": "The first AI-native content hub.",
   "author": "JB <[email protected]>",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "license": "MIT",
   "repository": "basehub-ai/basehub",
   "bugs": "https://github.com/basehub-ai/basehub/issues",

packages/basehub/package.json

@@ -1,5 +1,60 @@
 # playground
 
+## 0.0.70
+
+### Patch Changes
+
+- 7a85095: # New `fragmentOn` helper to extract fragments
+
+  In this new major version, we're introducing `fragmentOn`, a simpler way to create fragments in the `basehub` SDK.
+
+  Previously, in order to reuse a fragment, you'd do something like this:
+
+  ```ts
+  // old way 👎
+  import {
+    LinkComponentGenqlSelection,
+    LinkComponent,
+    FieldsSelection,
+  } from "basehub";
+
+  const LinkFragment = {
+    href: true,
+    label: true,
+  } satisfies LinkComponentGenqlSelection;
+
+  // extract the type
+  type LinkFragment = FieldsSelection<LinkComponent, typeof LinkFragment>;
+  ```
+
+  Looks simple, but it's a bit hard to understand. You need to know that we're exposing a `LinkComponentGenqlSelection`, and that you should use the `satisfies` so the object's type is constrained but also can be more specific. Then, to extract the type, you'd get `FieldsSelection`, and finally, `LinkComponent`. A lot of types!
+
+  Moreover, if you needed to create another fragment, it'd be this same process, over and over again.
+
+  This is how it's done in the new version:
+
+  ```ts
+  // new way 👍
+  import { fragmentOn } from "basehub";
+
+  const LinkFragment = fragmentOn("LinkComponent", {
+    href: true,
+    label: true,
+  });
+
+  // extract the type
+  type LinkFragment = fragmentOn.infer<typeof LinkFragment>;
+  ```
+
+  Much simpler!
+
+  ## Why is this a breaking change
+
+  Before this version, we exposed a lot of the internal types from `'basehub'`. We now don't. Some applications might depend on this, and that's why this is a breaking change. If you need those types for some reason that wasn't discussed in this document, feel free to raise an issue and we can see to bring them back.
+
+- Updated dependencies [7a85095]
+  - [email protected]
+
 ## 0.0.69
 
 ### Patch Changes

playground/CHANGELOG.md

@@ -1,7 +1,7 @@
 {
   "name": "playground",
   "private": true,
-  "version": "0.0.69",
+  "version": "0.0.70",
   "scripts": {
     "dev": "basehub dev & next dev",
     "build": "next build",