added composable and readme example to it

Author: aexol

README.md

@@ -81,6 +81,28 @@ Zeus syntax ( type-safe 😋 )
 }
 ```
 
+## New! Composables
+```ts
+import {
+  Gql,
+  ComposableSelector,
+} from './zeus/index.js';
+
+const withComposable = <T extends ComposableSelector<'Card'>, Z extends T>(id: string, rest: Z | T) =>
+  Gql('query')({
+    cardById: [{ cardId: id }, rest],
+  });
+  const c1result = await withComposable('12', {
+    id: true,
+  });
+  const c2result = await withComposable('12', {
+    Defense: true,
+    Attack: true,
+  });
+```
+
+Both responses and inputs are safely typed
+
 ## Features
 ⚡️ Validates queries and selectors
 ⚡️ Types mapped from your schema <br/>
@@ -124,6 +146,8 @@ For a complete guide to contributing to GraphQL Zeus, see the [Contribution Guid
 4.  Push to the branch: git push origin my-new-feature
 5.  Submit a pull request
 
+
+
 ## License
 
 [MIT](https://opensource.org/licenses/MIT) 🕊

examples/typescript-node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typescript-node",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "",
   "private": true,
   "main": "index.js",

examples/typescript-node/src/index.ts

@@ -13,6 +13,7 @@ import {
   $,
   FromSelector,
   fields,
+  ComposableSelector,
 } from './zeus/index.js';
 import { typedGql } from './zeus/typedDocumentNode.js';
 
@@ -109,7 +110,18 @@ const run = async () => {
     { operationName: 'ZausCard' },
   );
   printQueryResult('ZeusCard', ZeusCard);
-
+  const withComposable = <T extends ComposableSelector<'Card'>, Z extends T>(id: string, rest: Z | T) =>
+    Gql('query')({
+      cardById: [{ cardId: id }, rest],
+    });
+  const c1result = await withComposable('12', {
+    id: true,
+  });
+  const c2result = await withComposable('12', {
+    Defense: true,
+    Attack: true,
+  });
+  printQueryResult('composables', `1. ${c1result.cardById?.id} 2. ${c2result.cardById?.Attack}`);
   const bbb = await Gql('query')({
     drawCard: {
       ...fields('Card'),

examples/typescript-node/src/zeus/index.ts

@@ -865,6 +865,8 @@ type OptionalKeys<T> = {
 
 export type WithOptionalNullables<T> = OptionalKeys<WithNullableKeys<T>> & WithNonNullableKeys<T>;
 
+export type ComposableSelector<T extends keyof ValueTypes> = ReturnType<SelectionFunction<ValueTypes[T]>>;
+
 export type Variable<T extends GraphQLVariableType, Name extends string> = {
   ' __zeus_name': Name;
   ' __zeus_type': T;

packages/graphql-zeus-core/TreeToTS/functions/generated.ts

@@ -824,6 +824,8 @@ type OptionalKeys<T> = {
 
 export type WithOptionalNullables<T> = OptionalKeys<WithNullableKeys<T>> & WithNonNullableKeys<T>;
 
+export type ComposableSelector<T extends keyof ValueTypes> = ReturnType<SelectionFunction<ValueTypes[T]>>;
+
 export type Variable<T extends GraphQLVariableType, Name extends string> = {
   ' __zeus_name': Name;
   ' __zeus_type': T;

packages/graphql-zeus-core/TreeToTS/functions/new/types.ts

@@ -1,4 +1,4 @@
-import { GraphQLTypes, ZEUS_VARIABLES, ZEUS_INTERFACES, ZEUS_UNIONS } from '@/TreeToTS/functions/new/mocks';
+import { GraphQLTypes, ZEUS_VARIABLES, ZEUS_INTERFACES, ZEUS_UNIONS, ValueTypes } from '@/TreeToTS/functions/new/mocks';
 import { Variable } from '@/TreeToTS/functions/new/variableExtract';
 
 export type UnwrapPromise<T> = T extends Promise<infer R> ? R : T;
@@ -148,3 +148,5 @@ type OptionalKeys<T> = {
 };
 
 export type WithOptionalNullables<T> = OptionalKeys<WithNullableKeys<T>> & WithNonNullableKeys<T>;
+
+export type ComposableSelector<T extends keyof ValueTypes> = ReturnType<SelectionFunction<ValueTypes[T]>>;

packages/graphql-zeus-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-zeus-core",
-  "version": "7.0.4",
+  "version": "7.0.5",
   "private": false,
   "main": "./lib/index.js",
   "author": "GraphQL Editor, Artur Czemiel",

packages/graphql-zeus-jsonschema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-zeus-jsonschema",
-  "version": "7.0.4",
+  "version": "7.0.5",
   "private": false,
   "main": "./lib/index.js",
   "author": "GraphQL Editor, Artur Czemiel",

packages/graphql-zeus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-zeus",
-  "version": "7.0.4",
+  "version": "7.0.5",
   "private": false,
   "scripts": {
     "start": "ttsc --watch",
@@ -26,8 +26,8 @@
   "dependencies": {
     "config-maker": "^0.0.6",
     "cross-fetch": "^3.0.4",
-    "graphql-zeus-core": "^7.0.4",
-    "graphql-zeus-jsonschema": "^7.0.4",
+    "graphql-zeus-core": "^7.0.5",
+    "graphql-zeus-jsonschema": "^7.0.5",
     "yargs": "^16.1.1"
   }
 }