@commitspark/graphql-api 0.9.4 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.0] - 2024-08-17
+### Changed
+- Upgrade to `@commitspark/git-adapter` 0.13.0
+
+## [0.10.0] - 2024-06-15 
+### Added
+- Add referential integrity by tracking and validating references between entries
+- Add support of partial updates
+
+### Fixed
+- [#18](https://github.com/commitspark/graphql-api/issues/18), [#25](https://github.com/commitspark/graphql-api/issues/25)
+  Fix handling of entries that only have an `id` field
+
+### Changed
+- Return default data where possible when entry data is incomplete
+- Improve content retrieval performance
+
 ## [0.9.4] - 2023-11-14
 ### Fixed
 - Fix invalid schema built when running under Next.js 14

package/README.md

@@ -1,61 +1,31 @@
 # Introduction
 
-**This library dynamically generates a GraphQL API that allows reading and writing structured text content to and from a
-Git repository.**
+[Commitspark](https://commitspark.com) is a set of tools to manage structured data with Git through a GraphQL API.
 
-Queries and mutations offered by the generated API are determined by a vanilla GraphQL type definition file inside the
-Git repository.
+This library dynamically generates the GraphQL API that allows reading and writing structured data (entries) to and from
+a Git repository.
 
-Content is stored using plain YAML text files in the same Git repository. No other data store or configuration is
-needed.
+Queries and mutations offered by the generated API are determined by a standard GraphQL type definition file (schema)
+inside the Git repository.
 
----
+Entries (data) are stored using plain YAML text files in the same Git repository. No other data store is needed.
 
-*Commitspark is in tech-preview, i.e. it is not yet feature-complete, missing some error handling and tests, and may
-implement breaking changes before a first production-ready release.*
-
-# Usage
-
-Use this library to query structured content from a Git repository via GraphQL e.g. in order to fill frontends such as a
-Next.js-based website with content. The generated GraphQL API is similar to those offered by headless content management
-systems (CMS), only that content comes from a Git repository and not a proprietary storage or API.
-
-To edit content, either use the [Commitspark user interface](https://commitspark.com) or execute the library's generated
-GraphQL mutations yourself. (Or if you know what you're doing, you could even edit the YAML content files directly in a
-repository).
-
-To change the content model, simply modify the GraphQL type definition (schema) file. For details, see below.
-
-# Running the Commitspark library
+# Running the GraphQL API
 
 There are two common ways to run this library:
 
 1. By making GraphQL calls directly against the library as a code dependency in your own JavaScript / TypeScript /
    NodeJS application (NPM package name `@commitspark/graphql-api`)
-2. By making GraphQL calls over HTTP to the library wrapped in
-   a webserver or Lambda function of choice
-   ([NodeJS Express server example](https://github.com/commitspark/example-http-express),
+2. By making GraphQL calls over HTTP to the library wrapped in a webserver or Lambda function of choice
+   (see the [NodeJS Express server example](https://github.com/commitspark/example-http-express) or
    [Lambda function example](https://github.com/commitspark/example-code-serverless))
 
-In both cases, it is recommended to use a dedicated Git repository for content and not use the same repository as used
-for application code. See "Git repository hosting" below on where this content repository can be located.
-
-# Getting started
-
-If you're new to Commitspark, the quickest way to see Commitspark in action is as follows:
-
-1. [Copy the example Git content repository](https://github.com/commitspark/example-content-website/generate)
-2. [Copy the example Next.js application repository](https://github.com/commitspark/example-nextjs/generate)
-3. In the application repository, follow the simple
-   [README](https://github.com/commitspark/example-nextjs/blob/main/README.md) steps to point Next.js to your content
-   repository
-
 # Git repository hosting
 
-Commitspark follows an adapter pattern, so it can read from and write to Git repositories in various places, either
-hosted or locally. When using the library, pass an adapter instance as needed by your project.
+This library follows an adapter pattern to allow reading from and writing to Git repositories in various locations,
+either hosted or locally. When calling the library, pass an adapter instance as needed by your project.
 
-The following adapters exist:
+The following pre-built adapters exist:
 
 | Adapter                                                             | Description                                                | NPM package name                      |
 |---------------------------------------------------------------------|------------------------------------------------------------|---------------------------------------|
@@ -77,28 +47,30 @@ argument in library calls to a
 * branch name, or
 * tag name (light or regular)
 
-This enables great flexibility, e.g. to retrieve always the same content of a specific (historic) commit, to have
-different branches with different content, or to retrieve content by tag such as reviewed content.
+This enables great flexibility, e.g. to retrieve always the same entries of a specific (historic) commit, to have
+different branches with different entries, or to retrieve entries by tag such as one that marks the latest approved
+data in a repository.
 
 ## Obtaining the generated GraphQL schema
 
-Commitspark dynamically extends the GraphQL schema file's content model at runtime with additional types as well as
-queries and mutations. This extended schema can be retrieved by calling `getSchema()`.
+At runtime, Commitspark dynamically extends the GraphQL schema found in the schema file with additional
+types as well as queries and mutations. This extended schema can be retrieved by calling `getSchema()`.
 
-Compared to schema data obtained through GraphQL introspection, the schema returned here also includes directive
-declarations and annotations, allowing for development of additional tools that require this information.
+Compared to schema data obtained through GraphQL introspection, the schema returned by this function also includes
+directive declarations and annotations, allowing for development of additional tools that require this information.
 
 ## Reading data
 
 The `request` argument of `postGraphQL()` expects a conventional GraphQL query and supports query variables as well as
-introspection. Commitspark also transparently resolves references between @Entry-annotated content entries (see below),
-allowing for retrieval of complex data in a single query.
+introspection. Commitspark also transparently resolves references to other @Entry-annotated GraphQL types (see below),
+allowing for retrieval of complex data in a single query as nested result data.
 
 ### Generated queries
 
-For each content type annotated with `@Entry` in the content model (see below), the following queries are generated:
+For each GraphQL type annotated with `@Entry` in the schema (see below), e.g. `MyType`, the following queries are
+generated:
 
-* Query a single entry of a type by ID, e.g. `MyType(id:"..."): MyType`
+* Query a single entry of a type by ID, e.g. `MyType(id: "..."): MyType`
 * Query all entries of a type, e.g. `allMyTypes: [MyType]`
 
 ## Writing data
@@ -108,40 +80,36 @@ well as introspection. Mutation operations work on branch names only and (when s
 HEAD in the given branch. To avoid race conditions, mutations in calls with multiple mutations are processed
 sequentially (see the [GraphQL documentation](https://graphql.org/learn/queries/#multiple-fields-in-mutations)).
 
-### Generated queries
+### Generated mutations
 
-For each content type annotated with `@Entry` (see below), the following mutations are generated:
+For each GraphQL type annotated with `@Entry` (see below), the following mutations are generated:
 
 * Create a single entry of a type, e.g.
-  `createMyType(id:"...", message:"Commit message", data:{...}): MyType`
+  `createMyType(id: "...", message: "Commit message", data: {...}): MyType`
 * Mutate a single entry of a type by ID, e.g.
-  `updateMyType(id:"...", message:"Commit message", data:{...}): MyType`
+  `updateMyType(id: "...", message: "Commit message", data: {...}): MyType`
 * Delete a single entry of a type by ID, e.g.
-  `deleteMyType(id:"...", message:"Commit message"): { id }`
-
-## Authenticating with your repository
-
-Depending on the Git adapter used (see above), an authentication token must be provided. See the corresponding adapter
-README for details.
+  `deleteMyType(id: "...", message: "Commit message"): { id }`
 
 # Technical documentation
 
-## Content model
+## Data model
 
-The content model (i.e. schema) is defined in a single GraphQL type definition text file using the
+The data model (i.e. schema) is defined in a single GraphQL type definition text file using the
 [GraphQL type system](https://graphql.org/learn/schema/).
 
-The schema file must be located at `schema/schema.graphql` inside the Git repository.
+The schema file must be located at `commitspark/schema/schema.graphql` inside the Git repository (unless otherwise
+configured in your Git adapter).
 
-Commitspark currently supports the following data types:
+Commitspark currently supports the following GraphQL types:
 
 * `type`
 * `union`
 * `enum`
 
-### Content entries
+### Data entries
 
-To denote which content type instances are to be given a unique identity for referencing, a directive `@Entry` is
+To denote which data is to be given a unique identity for referencing, a directive `@Entry` is
 to be declared (this must be done right in the schema file so that the schema remains valid).
 
 To define the `@Entry` directive, simply add this line to the schema file:
@@ -150,7 +118,7 @@ To define the `@Entry` directive, simply add this line to the schema file:
 directive @Entry on OBJECT
 ```
 
-To promote a content type to Entry, annotate the type as follows:
+To promote a data type to Entry, annotate the type as follows:
 
 ```graphql
 type MyType @Entry {
@@ -161,13 +129,13 @@ type MyType @Entry {
 
 **Important:** Any type annotated with `@Entry` must have a field `id` of type `ID!`.
 
-**Note:** Only apply `@Entry` to content types that you actually want to reference or link to from other entries. This
+**Note:** Only apply `@Entry` to data types that you actually want to reference or link to from other entries. This
 keeps the number of entries low and performance up.
 
-## Content storage
+## Entry storage
 
-Content entries, i.e. instances of content types annotated with `@Entry`, are stored as `.yaml` YAML text files inside
-a folder `entries` in the repository.
+Entries, i.e. instances of data types annotated with `@Entry`, are stored as `.yaml` YAML text files inside
+a folder `commitspark/entries/` in the repository (unless otherwise configured in your Git adapter).
 
 The filename (excluding file extension) constitutes the entry ID.
 
@@ -175,13 +143,16 @@ Entry files have the following structure:
 
 ```yaml
 metadata:
-    type: MyType # name of type as defined in your schema
+  type: MyType # name of type as defined in your schema
+  referencedBy: [ ] # array of entry IDs that hold a reference to this entry
 data:
 #   ... fields of the type as defined in your schema
 ```
 
 ### Serialization
 
+#### References
+
 References to types annotated with `@Entry` are stored using a sub-field `id`.
 
 For example, consider the following schema:
@@ -197,27 +168,67 @@ type Link @Entry {
 }
 ```
 
-An entry for `Link` referencing a `Page` will look like this:
+An entry YAML file for a `Link` with ID `myLink` referencing a `Page` with ID `myPage` will look like this:
 
 ```yaml
 metadata:
-    type: Link
+  type: Link
+  referencedBy: [ ]
 data:
-    target:
-        id: "..." # ID of targeted Page
+  target:
+    id: myPage
+```
+
+The entry YAML file of referenced `Page` `myPage` will then look like this:
+
+```yaml
+metadata:
+  type: Page
+  referencedBy:
+    - myLink
+data: ~
 ```
 
-# FAQ
+#### Unions
+
+Consider the following schema where field `contentElements` is an array of Union type `ContentElement`, allowing
+different concrete types `Hero` or `Text` to be applied:
+
+```graphql
+type Page @Entry {
+  id: ID!
+  contentElements: [ContentElement!]
+}
+
+union ContentElement =
+  | Hero
+  | Text
 
-* Q: Do I need to run a web server or serverless function to use Commitspark?
+type Hero {
+  heroText: String!
+}
+
+type Text {
+  bodyText: String!
+}
+```
 
-  A: No. You can pass a GraphQL request string directly to the Commitspark library without going through HTTP. This can
-  be useful e.g. in CI/CD pipelines where you might not want to bring up a server just to execute a GraphQL query.
+During serialization, concrete type instances are represented through an additional nested level of data, using the
+instance's type name with a lowercase first character as field name:
 
-* Q: Do I really need to have two separate repositories for application code and content?
+```yaml
+metadata:
+  type: Page
+  referencedBy: [ ]
+data:
+  contentElements:
+    - hero: # represents type `Hero`
+        heroText: "..."
+    - text: # represents type `Text`
+        bodyText: "..."
+```
 
-  A: No. You can have both in the same repository but depending on how your software and content workflows are
-  structured, you may have a hard time finding a workflow that works equally well for both domains.
+When querying data through the API, this additional level of nesting is transparently removed and not visible.
 
 # License
 

package/dist/container.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiService = void 0;
 const api_service_1 = require("./app/api.service");
 const apollo_config_factory_service_1 = require("./graphql/apollo-config-factory.service");
-const entry_reference_resolver_generator_1 = require("./graphql/resolver-generators/entry-reference-resolver.generator");
 const input_type_generator_service_1 = require("./graphql/input-type-generator.service");
 const queries_mutations_generator_service_1 = require("./graphql/queries-mutations-generator.service");
 const schema_analyzer_service_1 = require("./graphql/schema-analyzer.service");
@@ -13,32 +12,41 @@ const persistence_service_1 = require("./persistence/persistence.service");
 const schema_generator_service_1 = require("./graphql/schema-generator.service");
 const mutation_create_resolver_generator_1 = require("./graphql/resolver-generators/mutation-create-resolver-generator");
 const mutation_delete_resolver_generator_1 = require("./graphql/resolver-generators/mutation-delete-resolver-generator");
-const mutation_update_resolver_generator_1 = require("./graphql/resolver-generators/mutation-update.resolver-generator");
+const mutation_update_resolver_generator_1 = require("./graphql/resolver-generators/mutation-update-resolver-generator");
 const query_all_resolver_generator_1 = require("./graphql/resolver-generators/query-all-resolver-generator");
 const query_by_id_resolver_generator_1 = require("./graphql/resolver-generators/query-by-id-resolver-generator");
 const query_count_all_resolver_generator_1 = require("./graphql/resolver-generators/query-count-all-resolver-generator");
 const query_type_by_id_resolver_generator_1 = require("./graphql/resolver-generators/query-type-by-id-resolver-generator");
 const schema_validator_1 = require("./graphql/schema-validator");
-const union_value_resolver_generator_1 = require("./graphql/resolver-generators/union-value-resolver-generator");
+const union_value_resolver_1 = require("./graphql/field-resolver/union-value-resolver");
 const entry_reference_util_1 = require("./graphql/schema-utils/entry-reference-util");
-const entryReferenceUtil = new entry_reference_util_1.EntryReferenceUtil();
+const object_type_field_default_value_resolver_generator_1 = require("./graphql/resolver-generators/object-type-field-default-value-resolver-generator");
+const field_default_value_resolver_1 = require("./graphql/field-resolver/field-default-value-resolver");
+const entry_reference_resolver_1 = require("./graphql/field-resolver/entry-reference-resolver");
+const union_type_util_1 = require("./graphql/schema-utils/union-type-util");
+const entry_type_util_1 = require("./graphql/schema-utils/entry-type-util");
 const schemaValidator = new schema_validator_1.SchemaValidator();
 const persistenceService = new persistence_service_1.PersistenceService();
+const entryTypeUtil = new entry_type_util_1.EntryTypeUtil();
+const unionTypeUtil = new union_type_util_1.UnionTypeUtil();
+const entryReferenceUtil = new entry_reference_util_1.EntryReferenceUtil(persistenceService, entryTypeUtil, unionTypeUtil);
 const schemaRootTypeGeneratorService = new schema_root_type_generator_service_1.SchemaRootTypeGeneratorService();
-const inputTypeGeneratorService = new input_type_generator_service_1.InputTypeGeneratorService(entryReferenceUtil);
-const schemaAnalyzerService = new schema_analyzer_service_1.SchemaAnalyzerService(entryReferenceUtil);
-const entryReferenceResolverGeneratorService = new entry_reference_resolver_generator_1.EntryReferenceResolverGenerator(persistenceService);
-const mutationCreateResolverGenerator = new mutation_create_resolver_generator_1.MutationCreateResolverGenerator(persistenceService);
-const mutationDeleteResolverGenerator = new mutation_delete_resolver_generator_1.MutationDeleteResolverGenerator(persistenceService);
-const mutationUpdateResolverGenerator = new mutation_update_resolver_generator_1.MutationUpdateResolverGenerator(persistenceService);
+const inputTypeGeneratorService = new input_type_generator_service_1.InputTypeGeneratorService(entryTypeUtil);
+const schemaAnalyzerService = new schema_analyzer_service_1.SchemaAnalyzerService();
+const mutationCreateResolverGenerator = new mutation_create_resolver_generator_1.MutationCreateResolverGenerator(persistenceService, entryReferenceUtil);
+const mutationDeleteResolverGenerator = new mutation_delete_resolver_generator_1.MutationDeleteResolverGenerator(persistenceService, entryReferenceUtil);
+const mutationUpdateResolverGenerator = new mutation_update_resolver_generator_1.MutationUpdateResolverGenerator(persistenceService, entryReferenceUtil);
 const queryAllResolverGenerator = new query_all_resolver_generator_1.QueryAllResolverGenerator(persistenceService);
 const queryByIdResolverGenerator = new query_by_id_resolver_generator_1.QueryByIdResolverGenerator(persistenceService);
 const queryCountAllResolverGenerator = new query_count_all_resolver_generator_1.QueryCountAllResolverGenerator(persistenceService);
 const queryTypeByIdResolverGenerator = new query_type_by_id_resolver_generator_1.QueryTypeByIdResolverGenerator(persistenceService);
-const unionTypeResolverGenerator = new union_type_resolver_generator_1.UnionTypeResolverGenerator(persistenceService, entryReferenceUtil);
-const unionValueResolverGenerator = new union_value_resolver_generator_1.UnionValueResolverGenerator(entryReferenceUtil);
+const unionTypeResolverGenerator = new union_type_resolver_generator_1.UnionTypeResolverGenerator(persistenceService, entryTypeUtil);
+const unionValueResolver = new union_value_resolver_1.UnionValueResolver(unionTypeUtil);
+const entryReferenceResolver = new entry_reference_resolver_1.EntryReferenceResolver(persistenceService);
+const fieldDefaultValueResolver = new field_default_value_resolver_1.FieldDefaultValueResolver(entryTypeUtil, unionValueResolver, entryReferenceResolver);
+const objectTypeFieldDefaultValueResolverGenerator = new object_type_field_default_value_resolver_generator_1.ObjectTypeFieldDefaultValueResolverGenerator(fieldDefaultValueResolver);
 const queriesMutationsGeneratorService = new queries_mutations_generator_service_1.QueriesMutationsGeneratorService(queryAllResolverGenerator, queryByIdResolverGenerator, queryCountAllResolverGenerator, queryTypeByIdResolverGenerator, mutationCreateResolverGenerator, mutationUpdateResolverGenerator, mutationDeleteResolverGenerator);
-const schemaGeneratorService = new schema_generator_service_1.SchemaGeneratorService(queriesMutationsGeneratorService, schemaAnalyzerService, inputTypeGeneratorService, schemaRootTypeGeneratorService, entryReferenceResolverGeneratorService, unionTypeResolverGenerator, unionValueResolverGenerator, schemaValidator);
+const schemaGeneratorService = new schema_generator_service_1.SchemaGeneratorService(queriesMutationsGeneratorService, schemaAnalyzerService, inputTypeGeneratorService, schemaRootTypeGeneratorService, unionTypeResolverGenerator, objectTypeFieldDefaultValueResolverGenerator, schemaValidator);
 const apolloConfigFactoryService = new apollo_config_factory_service_1.ApolloConfigFactoryService(schemaGeneratorService);
 exports.apiService = new api_service_1.ApiService(apolloConfigFactoryService, schemaGeneratorService);
 //# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -1 +1 @@
-{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAC9C,2FAAoF;AACpF,yHAAkH;AAClH,yFAAkF;AAClF,uGAAgG;AAChG,+EAAyE;AACzE,qGAA6F;AAC7F,+GAAwG;AACxG,2EAAsE;AACtE,iFAA2E;AAC3E,yHAAkH;AAClH,yHAAkH;AAClH,yHAAkH;AAClH,6GAAsG;AACtG,iHAAyG;AACzG,yHAAiH;AACjH,2HAAkH;AAClH,iEAA4D;AAC5D,iHAA0G;AAC1G,sFAAgF;AAIhF,MAAM,kBAAkB,GAAG,IAAI,yCAAkB,EAAE,CAAA;AACnD,MAAM,eAAe,GAAG,IAAI,kCAAe,EAAE,CAAA;AAC7C,MAAM,kBAAkB,GAAG,IAAI,wCAAkB,EAAE,CAAA;AACnD,MAAM,8BAA8B,GAAG,IAAI,mEAA8B,EAAE,CAAA;AAE3E,MAAM,yBAAyB,GAAG,IAAI,wDAAyB,CAC7D,kBAAkB,CACnB,CAAA;AACD,MAAM,qBAAqB,GAAG,IAAI,+CAAqB,CAAC,kBAAkB,CAAC,CAAA;AAC3E,MAAM,sCAAsC,GAC1C,IAAI,oEAA+B,CAAC,kBAAkB,CAAC,CAAA;AACzD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,CACnB,CAAA;AACD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,CACnB,CAAA;AACD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,CACnB,CAAA;AACD,MAAM,yBAAyB,GAAG,IAAI,wDAAyB,CAC7D,kBAAkB,CACnB,CAAA;AACD,MAAM,0BAA0B,GAAG,IAAI,2DAA0B,CAC/D,kBAAkB,CACnB,CAAA;AACD,MAAM,8BAA8B,GAAG,IAAI,mEAA8B,CACvE,kBAAkB,CACnB,CAAA;AACD,MAAM,8BAA8B,GAAG,IAAI,oEAA8B,CACvE,kBAAkB,CACnB,CAAA;AACD,MAAM,0BAA0B,GAAG,IAAI,0DAA0B,CAC/D,kBAAkB,EAClB,kBAAkB,CACnB,CAAA;AACD,MAAM,2BAA2B,GAAG,IAAI,4DAA2B,CACjE,kBAAkB,CACnB,CAAA;AAED,MAAM,gCAAgC,GAAG,IAAI,sEAAgC,CAC3E,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,CAChC,CAAA;AAED,MAAM,sBAAsB,GAAG,IAAI,iDAAsB,CACvD,gCAAgC,EAChC,qBAAqB,EACrB,yBAAyB,EACzB,8BAA8B,EAC9B,sCAAsC,EACtC,0BAA0B,EAC1B,2BAA2B,EAC3B,eAAe,CAChB,CAAA;AAED,MAAM,0BAA0B,GAAG,IAAI,0DAA0B,CAC/D,sBAAsB,CACvB,CAAA;AAEY,QAAA,UAAU,GAAG,IAAI,wBAAU,CACtC,0BAA0B,EAC1B,sBAAsB,CACvB,CAAA"}
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAC9C,2FAAoF;AACpF,yFAAkF;AAClF,uGAAgG;AAChG,+EAAyE;AACzE,qGAA6F;AAC7F,+GAAwG;AACxG,2EAAsE;AACtE,iFAA2E;AAC3E,yHAAkH;AAClH,yHAAkH;AAClH,yHAAkH;AAClH,6GAAsG;AACtG,iHAAyG;AACzG,yHAAiH;AACjH,2HAAkH;AAClH,iEAA4D;AAC5D,wFAAkF;AAClF,sFAAgF;AAChF,yJAA+I;AAC/I,wGAAiG;AACjG,gGAA0F;AAC1F,4EAAsE;AACtE,4EAAsE;AAItE,MAAM,eAAe,GAAG,IAAI,kCAAe,EAAE,CAAA;AAC7C,MAAM,kBAAkB,GAAG,IAAI,wCAAkB,EAAE,CAAA;AACnD,MAAM,aAAa,GAAG,IAAI,+BAAa,EAAE,CAAA;AACzC,MAAM,aAAa,GAAG,IAAI,+BAAa,EAAE,CAAA;AACzC,MAAM,kBAAkB,GAAG,IAAI,yCAAkB,CAC/C,kBAAkB,EAClB,aAAa,EACb,aAAa,CACd,CAAA;AACD,MAAM,8BAA8B,GAAG,IAAI,mEAA8B,EAAE,CAAA;AAE3E,MAAM,yBAAyB,GAAG,IAAI,wDAAyB,CAAC,aAAa,CAAC,CAAA;AAC9E,MAAM,qBAAqB,GAAG,IAAI,+CAAqB,EAAE,CAAA;AACzD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,EAClB,kBAAkB,CACnB,CAAA;AACD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,EAClB,kBAAkB,CACnB,CAAA;AACD,MAAM,+BAA+B,GAAG,IAAI,oEAA+B,CACzE,kBAAkB,EAClB,kBAAkB,CACnB,CAAA;AACD,MAAM,yBAAyB,GAAG,IAAI,wDAAyB,CAC7D,kBAAkB,CACnB,CAAA;AACD,MAAM,0BAA0B,GAAG,IAAI,2DAA0B,CAC/D,kBAAkB,CACnB,CAAA;AACD,MAAM,8BAA8B,GAAG,IAAI,mEAA8B,CACvE,kBAAkB,CACnB,CAAA;AACD,MAAM,8BAA8B,GAAG,IAAI,oEAA8B,CACvE,kBAAkB,CACnB,CAAA;AACD,MAAM,0BAA0B,GAAG,IAAI,0DAA0B,CAC/D,kBAAkB,EAClB,aAAa,CACd,CAAA;AACD,MAAM,kBAAkB,GAAG,IAAI,yCAAkB,CAAC,aAAa,CAAC,CAAA;AAChE,MAAM,sBAAsB,GAAG,IAAI,iDAAsB,CAAC,kBAAkB,CAAC,CAAA;AAC7E,MAAM,yBAAyB,GAAG,IAAI,wDAAyB,CAC7D,aAAa,EACb,kBAAkB,EAClB,sBAAsB,CACvB,CAAA;AACD,MAAM,4CAA4C,GAChD,IAAI,iGAA4C,CAAC,yBAAyB,CAAC,CAAA;AAE7E,MAAM,gCAAgC,GAAG,IAAI,sEAAgC,CAC3E,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,CAChC,CAAA;AAED,MAAM,sBAAsB,GAAG,IAAI,iDAAsB,CACvD,gCAAgC,EAChC,qBAAqB,EACrB,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC1B,4CAA4C,EAC5C,eAAe,CAChB,CAAA;AAED,MAAM,0BAA0B,GAAG,IAAI,0DAA0B,CAC/D,sBAAsB,CACvB,CAAA;AAEY,QAAA,UAAU,GAAG,IAAI,wBAAU,CACtC,0BAA0B,EAC1B,sBAAsB,CACvB,CAAA"}

package/dist/graphql/field-resolver/entry-reference-resolver.d.ts

@@ -0,0 +1,10 @@
+import { FieldResolver, ResolvedEntryData, FieldResolverContext } from './fieldResolver';
+import { GraphQLFieldResolver } from 'graphql/type/definition';
+import { PersistenceService } from '../../persistence/persistence.service';
+import { EntryData } from '@commitspark/git-adapter';
+export declare class EntryReferenceResolver implements FieldResolver<any> {
+    private readonly persistence;
+    resolve: GraphQLFieldResolver<any, FieldResolverContext, any, Promise<ResolvedEntryData<EntryData | EntryData[] | null>>>;
+    constructor(persistence: PersistenceService);
+    private resolveFieldValue;
+}

package/dist/graphql/field-resolver/entry-reference-resolver.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntryReferenceResolver = void 0;
+class EntryReferenceResolver {
+    constructor(persistence) {
+        this.persistence = persistence;
+        this.resolve = (fieldValue, args, context, info) => this.resolveFieldValue(fieldValue, args, context, info, info.returnType);
+    }
+    async resolveFieldValue(fieldValue, args, context, info, currentType) {
+        const entry = await this.persistence.findById(context.gitAdapter, context.getCurrentRef(), fieldValue.id);
+        return Object.assign(Object.assign({}, entry.data), { id: entry.id });
+    }
+}
+exports.EntryReferenceResolver = EntryReferenceResolver;
+//# sourceMappingURL=entry-reference-resolver.js.map

package/dist/graphql/field-resolver/entry-reference-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-reference-resolver.js","sourceRoot":"","sources":["../../../src/graphql/field-resolver/entry-reference-resolver.ts"],"names":[],"mappings":";;;AAaA,MAAa,sBAAsB;IAQjC,YAA6B,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;QAC1D,IAAI,CAAC,OAAO,GAAG,CACb,UAAU,EACV,IAAS,EACT,OAA6B,EAC7B,IAAI,EACwD,EAAE,CAC9D,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5E,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,UAAe,EACf,IAAS,EACT,OAA6B,EAC7B,IAAwB,EACxB,WAA8B;QAE9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAC3C,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,aAAa,EAAE,EACvB,UAAU,CAAC,EAAE,CACd,CAAA;QAED,uCAAY,KAAK,CAAC,IAAI,KAAE,EAAE,EAAE,KAAK,CAAC,EAAE,IAAE;IACxC,CAAC;CACF;AAjCD,wDAiCC"}

package/dist/graphql/field-resolver/field-default-value-resolver.d.ts

@@ -0,0 +1,14 @@
+import { FieldResolver, ResolvedEntryData, FieldResolverContext } from './fieldResolver';
+import { EntryData } from '@commitspark/git-adapter';
+import { GraphQLFieldResolver } from 'graphql/type/definition';
+import { EntryTypeUtil } from '../schema-utils/entry-type-util';
+import { UnionValueResolver } from './union-value-resolver';
+import { EntryReferenceResolver } from './entry-reference-resolver';
+export declare class FieldDefaultValueResolver implements FieldResolver<any> {
+    private readonly entryTypeUtil;
+    private readonly unionValueResolver;
+    private readonly entryReferenceResolver;
+    resolve: GraphQLFieldResolver<any, FieldResolverContext, any, Promise<ResolvedEntryData<EntryData | EntryData[] | null>>>;
+    constructor(entryTypeUtil: EntryTypeUtil, unionValueResolver: UnionValueResolver, entryReferenceResolver: EntryReferenceResolver);
+    private resolveFieldValue;
+}

package/dist/graphql/field-resolver/field-default-value-resolver.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldDefaultValueResolver = void 0;
+const graphql_1 = require("graphql");
+class FieldDefaultValueResolver {
+    constructor(entryTypeUtil, unionValueResolver, entryReferenceResolver) {
+        this.entryTypeUtil = entryTypeUtil;
+        this.unionValueResolver = unionValueResolver;
+        this.entryReferenceResolver = entryReferenceResolver;
+        this.resolve = (fieldValue, args, context, info) => this.resolveFieldValue(fieldValue, args, context, info, info.returnType, false);
+    }
+    resolveFieldValue(fieldValue, args, context, info, currentType, hasNonNullParent) {
+        if ((0, graphql_1.isNonNullType)(currentType)) {
+            return this.resolveFieldValue(fieldValue, args, {
+                gitAdapter: context.gitAdapter,
+                getCurrentRef: context.getCurrentRef,
+            }, info, currentType.ofType, true);
+        }
+        else if ((0, graphql_1.isListType)(currentType)) {
+            if (fieldValue === undefined || fieldValue === null) {
+                if (hasNonNullParent) {
+                    return new Promise((resolve) => resolve([]));
+                }
+                else {
+                    return new Promise((resolve) => resolve(null));
+                }
+            }
+            if (!Array.isArray(fieldValue)) {
+                throw new Error(`Expected array while resolving value for field "${info.fieldName}".`);
+            }
+            const resultPromises = [];
+            for (const item of fieldValue) {
+                const resultPromise = this.resolveFieldValue(item, args, {
+                    gitAdapter: context.gitAdapter,
+                    getCurrentRef: context.getCurrentRef,
+                }, info, currentType.ofType, hasNonNullParent);
+                resultPromises.push(resultPromise);
+            }
+            return Promise.all(resultPromises);
+        }
+        else if ((0, graphql_1.isUnionType)(currentType)) {
+            if (fieldValue === undefined || fieldValue === null) {
+                if (hasNonNullParent) {
+                    throw new Error(`Cannot generate a default value for NonNull field "${info.parentType.name}.${info.fieldName}" because it is a union field of type "${info.returnType.ofType.name}".`);
+                }
+                else {
+                    return new Promise((resolve) => resolve(null));
+                }
+            }
+            if (this.entryTypeUtil.buildsOnTypeWithEntryDirective(currentType)) {
+                return this.entryReferenceResolver.resolve(fieldValue, args, context, info);
+            }
+            return this.unionValueResolver.resolve(fieldValue, args, context, info);
+        }
+        else if ((0, graphql_1.isObjectType)(currentType)) {
+            if (fieldValue === undefined || fieldValue === null) {
+                if (hasNonNullParent) {
+                    throw new Error(`Cannot generate a default value for NonNull field "${info.fieldName}" of type "${info.parentType.name}".`);
+                }
+                else {
+                    return new Promise((resolve) => resolve(null));
+                }
+            }
+            if (this.entryTypeUtil.hasEntryDirective(currentType)) {
+                return this.entryReferenceResolver.resolve(fieldValue, args, context, info);
+            }
+            return fieldValue;
+        }
+        return fieldValue;
+    }
+}
+exports.FieldDefaultValueResolver = FieldDefaultValueResolver;
+//# sourceMappingURL=field-default-value-resolver.js.map

package/dist/graphql/field-resolver/field-default-value-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-default-value-resolver.js","sourceRoot":"","sources":["../../../src/graphql/field-resolver/field-default-value-resolver.ts"],"names":[],"mappings":"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"}

package/dist/graphql/field-resolver/fieldResolver.d.ts

@@ -0,0 +1,11 @@
+import { GraphQLFieldResolver } from 'graphql/type/definition';
+import { EntryData } from '@commitspark/git-adapter';
+import { GitAdapter } from '@commitspark/git-adapter';
+export interface FieldResolverContext {
+    gitAdapter: GitAdapter;
+    getCurrentRef(): string;
+}
+export interface FieldResolver<TSource, TContext = FieldResolverContext, TArgs = any, TResult = Promise<ResolvedEntryData<EntryData | EntryData[] | null>>> {
+    resolve: GraphQLFieldResolver<TSource, TContext, TArgs, TResult>;
+}
+export type ResolvedEntryData<T> = T | Array<ResolvedEntryData<T>>;

package/dist/graphql/field-resolver/fieldResolver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=fieldResolver.js.map

package/dist/graphql/field-resolver/fieldResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldResolver.js","sourceRoot":"","sources":["../../../src/graphql/field-resolver/fieldResolver.ts"],"names":[],"mappings":""}

package/dist/graphql/field-resolver/union-value-resolver.d.ts

@@ -0,0 +1,10 @@
+import { GraphQLFieldResolver } from 'graphql/type/definition';
+import { EntryData } from '@commitspark/git-adapter';
+import { FieldResolver, ResolvedEntryData, FieldResolverContext } from './fieldResolver';
+import { UnionTypeUtil } from '../schema-utils/union-type-util';
+export declare class UnionValueResolver implements FieldResolver<any> {
+    private readonly unionTypeUtil;
+    resolve: GraphQLFieldResolver<any, FieldResolverContext, any, Promise<ResolvedEntryData<EntryData | EntryData[] | null>>>;
+    constructor(unionTypeUtil: UnionTypeUtil);
+    private resolveFieldValue;
+}

package/dist/graphql/field-resolver/union-value-resolver.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnionValueResolver = void 0;
+class UnionValueResolver {
+    constructor(unionTypeUtil) {
+        this.unionTypeUtil = unionTypeUtil;
+        this.resolve = (fieldValue, args, context, info) => this.resolveFieldValue(fieldValue);
+    }
+    resolveFieldValue(fieldValue) {
+        const typeName = this.unionTypeUtil.getUnionTypeNameFromFieldValue(fieldValue);
+        const unionValue = this.unionTypeUtil.getUnionValue(fieldValue);
+        const res = Object.assign(Object.assign({}, unionValue), { __typename: typeName });
+        return new Promise((resolve) => resolve(res));
+    }
+}
+exports.UnionValueResolver = UnionValueResolver;
+//# sourceMappingURL=union-value-resolver.js.map

package/dist/graphql/field-resolver/union-value-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-value-resolver.js","sourceRoot":"","sources":["../../../src/graphql/field-resolver/union-value-resolver.ts"],"names":[],"mappings":";;;AASA,MAAa,kBAAkB;IAQ7B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QACvD,IAAI,CAAC,OAAO,GAAG,CACb,UAAU,EACV,IAAI,EACJ,OAAO,EACP,IAAI,EACwD,EAAE,CAC9D,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAA;IACtC,CAAC;IAEO,iBAAiB,CACvB,UAAe;QAEf,MAAM,QAAQ,GACZ,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAA;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;QAM/D,MAAM,GAAG,mCACJ,UAAU,KACb,UAAU,EAAE,QAAQ,GACrB,CAAA;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/C,CAAC;CACF;AApCD,gDAoCC"}

package/dist/graphql/input-type-generator.service.d.ts

@@ -1,9 +1,9 @@
 import { GraphQLNullableType, GraphQLObjectType, GraphQLUnionType } from 'graphql';
 import { ISchemaAnalyzerResult } from './schema-analyzer.service';
-import { EntryReferenceUtil } from './schema-utils/entry-reference-util';
+import { EntryTypeUtil } from './schema-utils/entry-type-util';
 export declare class InputTypeGeneratorService {
-    private readonly entryReferenceUtil;
-    constructor(entryReferenceUtil: EntryReferenceUtil);
+    private readonly entryTypeUtil;
+    constructor(entryTypeUtil: EntryTypeUtil);
     generateFieldInputTypeString(type: GraphQLNullableType): string;
     generateIdInputTypeStrings(schemaAnalyzerResult: ISchemaAnalyzerResult): string[];
     generateObjectInputTypeStrings(objectTypes: GraphQLObjectType[]): string[];