@tinacms/graphql 0.0.0-e0ddb8c-20241004065742 → 0.0.0-e27c017-20250619233313

package/dist/mdx/index.d.ts

@@ -1,8 +1,3 @@
-/**
-
-
-
-*/
-import { parseMDX, stringifyMDX } from '@tinacms/mdx';
+import { parseMDX, serializeMDX } from '@tinacms/mdx';
 export { parseMDX };
-export { stringifyMDX };
+export { serializeMDX };

package/dist/resolver/index.d.ts

@@ -2,7 +2,7 @@
 
 */
 import { Database } from '../database';
-import type { Collectable, Collection, TinaField, Template, TinaSchema } from '@tinacms/schema-tools';
+import type { Collectable, Collection, Template, TinaField, TinaSchema } from '@tinacms/schema-tools';
 import type { GraphQLConfig } from '../types';
 interface ResolverConfig {
     config?: GraphQLConfig;
@@ -14,12 +14,13 @@ export declare const createResolver: (args: ResolverConfig) => Resolver;
 export declare const transformDocumentIntoPayload: (fullPath: string, rawData: {
     _collection: any;
     _template: any;
-}, tinaSchema: TinaSchema, config?: GraphQLConfig, isAudit?: boolean) => Promise<{
+}, tinaSchema: TinaSchema, config?: GraphQLConfig, isAudit?: boolean, hasReferences?: boolean) => Promise<{
     _sys: {
         title: any;
         basename: string;
         filename: string;
         extension: string;
+        hasReferences: boolean;
         path: string;
         relativePath: string;
         breadcrumbs: string[];
@@ -39,6 +40,17 @@ export declare const transformDocumentIntoPayload: (fullPath: string, rawData: {
     __typename: string;
     id: string;
 }>;
+/**
+ * Updates a property in an object using a JSONPath.
+ * @param obj - The object to update.
+ * @param path - The JSONPath string.
+ * @param newValue - The new value to set at the specified path.
+ * @returns the updated object.
+ */
+export declare const updateObjectWithJsonPath: (obj: any, path: string, oldValue: any, newValue: any) => {
+    object: any;
+    updated: boolean;
+};
 /**
  * The resolver provides functions for all possible types of lookup
  * values and retrieves them from the database
@@ -62,10 +74,10 @@ export declare class Resolver {
                 name: string;
             }[];
         }[];
-        format?: "json" | "md" | "markdown" | "mdx" | "yaml" | "yml" | "toml";
+        format?: import("@tinacms/schema-tools").ContentFormat;
         ui?: import("@tinacms/schema-tools").UICollection;
         defaultItem?: import("@tinacms/schema-tools").DefaultItem<Record<string, any>>;
-        frontmatterFormat?: "yaml" | "toml" | "json";
+        frontmatterFormat?: import("@tinacms/schema-tools").ContentFrontmatterFormat;
         frontmatterDelimiters?: [string, string] | string;
         match?: {
             include?: string;
@@ -90,10 +102,10 @@ export declare class Resolver {
                 name: string;
             }[];
         }[];
-        format?: "json" | "md" | "markdown" | "mdx" | "yaml" | "yml" | "toml";
+        format?: import("@tinacms/schema-tools").ContentFormat;
         ui?: import("@tinacms/schema-tools").UICollection;
         defaultItem?: import("@tinacms/schema-tools").DefaultItem<Record<string, any>>;
-        frontmatterFormat?: "yaml" | "toml" | "json";
+        frontmatterFormat?: import("@tinacms/schema-tools").ContentFrontmatterFormat;
         frontmatterDelimiters?: [string, string] | string;
         match?: {
             include?: string;
@@ -117,6 +129,7 @@ export declare class Resolver {
             basename: string;
             filename: string;
             extension: string;
+            hasReferences: boolean;
             path: string;
             relativePath: string;
             breadcrumbs: string[];
@@ -140,12 +153,16 @@ export declare class Resolver {
         name: any;
         path: any;
     }>;
-    getDocument: (fullPath: unknown) => Promise<{
+    getDocument: (fullPath: unknown, opts?: {
+        collection?: Collection<true>;
+        checkReferences?: boolean;
+    }) => Promise<{
         _sys: {
             title: any;
             basename: string;
             filename: string;
             extension: string;
+            hasReferences: boolean;
             path: string;
             relativePath: string;
             breadcrumbs: string[];
@@ -184,6 +201,7 @@ export declare class Resolver {
             basename: string;
             filename: string;
             extension: string;
+            hasReferences: boolean;
             path: string;
             relativePath: string;
             breadcrumbs: string[];
@@ -215,6 +233,7 @@ export declare class Resolver {
             basename: string;
             filename: string;
             extension: string;
+            hasReferences: boolean;
             path: string;
             relativePath: string;
             breadcrumbs: string[];
@@ -255,6 +274,7 @@ export declare class Resolver {
             basename: string;
             filename: string;
             extension: string;
+            hasReferences: boolean;
             path: string;
             relativePath: string;
             breadcrumbs: string[];
@@ -285,6 +305,7 @@ export declare class Resolver {
                     basename: string;
                     filename: string;
                     extension: string;
+                    hasReferences: boolean;
                     path: string;
                     relativePath: string;
                     breadcrumbs: string[];
@@ -325,6 +346,20 @@ export declare class Resolver {
             endCursor: string;
         };
     }>;
+    /**
+     * Checks if a document has references to it
+     * @param id  The id of the document to check for references
+     * @param c The collection to check for references
+     * @returns true if the document has references, false otherwise
+     */
+    private hasReferences;
+    /**
+     * Finds references to a document
+     * @param id the id of the document to find references to
+     * @param c the collection to find references in
+     * @returns a map of references to the document
+     */
+    private findReferences;
     private buildFieldMutations;
     /**
      * A mutation looks nearly identical between updateDocument:

package/dist/resolver/media-utils.d.ts

@@ -1,10 +1,10 @@
 /**
 
 */
-import type { GraphQLConfig } from '../types';
 import type { Schema } from '@tinacms/schema-tools';
+import type { GraphQLConfig } from '../types';
 /**
- * Strips away the Tina Cloud Asset URL from an `image` value
+ * Strips away the TinaCloud Asset URL from an `image` value
  *
  * @param {string | string[]} value
  * @param {GraphQLConfig} config
@@ -12,7 +12,7 @@ import type { Schema } from '@tinacms/schema-tools';
  */
 export declare const resolveMediaCloudToRelative: (value: string | string[], config: GraphQLConfig, schema: Schema<true>) => string | string[];
 /**
- * Adds Tina Cloud Asset URL to an `image` value
+ * Adds TinaCloud Asset URL to an `image` value
  *
  * @param {string | string[]} value
  * @param {GraphQLConfig} config

package/dist/schema/createSchema.d.ts

@@ -1,6 +1,3 @@
-/**
-
-*/
 import { TinaSchema, Schema } from '@tinacms/schema-tools';
 export declare const createSchema: ({ schema, flags, }: {
     schema: Schema;

package/dist/schema/validate.d.ts

@@ -1,6 +1,3 @@
-/**
-
-*/
 import { type Schema, type Collection } from '@tinacms/schema-tools';
 export declare const validateSchema: (schema: Schema) => Promise<{
     collections: Collection<true>[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinacms/graphql",
-  "version": "0.0.0-e0ddb8c-20241004065742",
+  "version": "0.0.0-e27c017-20250619233313",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "typings": "dist/index.d.ts",
@@ -26,26 +26,26 @@
     "@iarna/toml": "^2.2.5",
     "abstract-level": "^1.0.4",
     "date-fns": "^2.30.0",
-    "fast-glob": "^3.3.2",
-    "fs-extra": "^11.2.0",
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.3.0",
     "glob-parent": "^6.0.2",
     "graphql": "15.8.0",
     "gray-matter": "^4.0.3",
-    "isomorphic-git": "^1.27.1",
+    "isomorphic-git": "^1.29.0",
     "js-sha1": "^0.6.0",
     "js-yaml": "^3.14.1",
-    "jsonpath-plus": "^6.0.1",
+    "jsonpath-plus": "10.1.0",
     "lodash.clonedeep": "^4.5.0",
     "lodash.set": "^4.3.2",
     "lodash.uniqby": "^4.7.0",
     "many-level": "^2.0.0",
     "micromatch": "4.0.8",
     "normalize-path": "^3.0.0",
-    "readable-stream": "^4.5.2",
+    "readable-stream": "^4.7.0",
     "scmp": "^2.1.0",
     "yup": "^0.32.11",
-    "@tinacms/schema-tools": "0.0.0-e0ddb8c-20241004065742",
-    "@tinacms/mdx": "0.0.0-e0ddb8c-20241004065742"
+    "@tinacms/mdx": "0.0.0-e27c017-20250619233313",
+    "@tinacms/schema-tools": "0.0.0-e27c017-20250619233313"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
@@ -59,33 +59,30 @@
     "@types/estree": "^0.0.50",
     "@types/express": "^4.17.21",
     "@types/fs-extra": "^9.0.13",
-    "@types/jest": "^26.0.24",
     "@types/js-yaml": "^3.12.10",
     "@types/lodash.camelcase": "^4.3.9",
     "@types/lodash.upperfirst": "^4.3.9",
     "@types/lru-cache": "^5.1.1",
     "@types/mdast": "^3.0.15",
     "@types/micromatch": "^4.0.9",
-    "@types/node": "^22.7.4",
+    "@types/node": "^22.13.1",
     "@types/normalize-path": "^3.0.2",
     "@types/ws": "^7.4.7",
     "@types/yup": "^0.29.14",
-    "jest": "^29.7.0",
-    "jest-diff": "^29.7.0",
     "jest-file-snapshot": "^0.5.0",
-    "jest-matcher-utils": "^29.7.0",
     "memory-level": "^1.0.0",
-    "nodemon": "3.1.4",
-    "typescript": "^5.6.2",
-    "@tinacms/schema-tools": "0.0.0-e0ddb8c-20241004065742",
-    "@tinacms/scripts": "1.2.3"
+    "typescript": "^5.7.3",
+    "vite": "^4.5.9",
+    "vitest": "^0.32.4",
+    "zod": "^3.24.2",
+    "@tinacms/schema-tools": "0.0.0-e27c017-20250619233313",
+    "@tinacms/scripts": "1.3.5"
   },
   "scripts": {
     "types": "pnpm tsc",
     "build": "tinacms-scripts build",
     "docs": "pnpm typedoc",
-    "serve": "pnpm nodemon dist/server.js",
-    "test": "jest",
-    "test-watch": "jest --watch"
+    "test": "vitest run",
+    "test-watch": "vitest"
   }
 }

package/readme.md

@@ -1,194 +0,0 @@
-## Getting started
-
-There's a serve and watch command, which are separate for now:
-
-```sh
-// terminal 1
-cd packages/tina-graphql
-yarn watch
-
-// terminal 2
-cd packages/tina-graphql
-yarn serve
-```
-
-You can consume this from the `graphiql` app:
-
-```sh
-// terminal 3
-cd apps/graphiql
-yarn start
-```
-
-Note that this app doesn't use anything from the `client` package right now, it's just an interactive tool to see how things move from the graphql server into tina. That process has been improved in this package but will need to be merged back into the `client` package before this is usable.
-
-### Running queries
-
-By default the app will redirect to `project1` and display the default query generated from the `graphql-helpers` library - which consumes the fixtures from the `project1` folder the the `gql` package, any number of fixtures can be used if you want to add your own, just ensure the `server.ts` file knows about them.
-
-When you run the initial query, you should see the result along with the Tina sidebar toggle, this indicates that the Tina form has now been populated with the query values. If you change some values around and hit submit, the `onSubmit` function will populate the GraphiQL editor instead of sending it off to the server, you can play around with the mutation before sending it off if you'd like.
-
-### Tests
-
-The most valuable test right now is the `builder.spec.ts`, it's sort of an integration of all the field-level builders. There are also field-level build tests, but not resolvers ones just yet. If you're making changes to the builder just run `yarn test-watch` and hit `p` to provide a pattern, then type "builder", this will isolate that test and if it's passing you probably didn't break anything.
-
-## Architecture
-
-### Builder
-
-The builder service is responsible for building out the entire GraphQL schema for a given `.tina` config. This service can run at any time (but needs to be re-run on each schema change) and it's output is a GraphQL schema which can be stored in the schema definition language (SDL) as a string in a database record or as a `.graphql` file. At the top of the schema is a `document` query, this query returns the document, which can be one of any number of templates defined in the `.tina` config. From there, each field in the given template is used to build out the rest of the schema, so each template field is built by the `type` in it's definition
-
-#### Field-level builders
-
-Field-level builders take a field definition and produce 4 different GraphQL types:
-
-##### `field`
-
-Builds the type which fits into Tina's field definition shape:
-
-Given:
-
-```yaml
-name: Title
-label: title
-type: text
-```
-
-```js
-text.build.field({ cache, field });
-```
-
-Produces
-
-```graphql
-type TextField {
-  name: String
-  label: String
-  component: String
-  description: String
-}
-```
-
-##### `initialValue`
-
-Tina fields need an initial value when editing existing data. This builder is responsible for providing the shape of that value.
-
-For most fields this is the same value as `value` - but if you picture the schema as a "graph" - you can see how the "value" of a document reference (ie. a Post has an Author) is not helpful to Tina. Tina only cares about the stored document value of the reference (in this case `/path/to/author.md`) so it's the `initialValue`'s role to provide what makes sense to Tina, regardless of the schema's relationships.
-
-##### `value`
-
-The value of the field, it's the role of this function to provide the shape of the data we should expect for a fully resolved graph.
-
-For `block` fields, this looks like an array of different shapes, which means it's the `blocks.build.value` function's responsibility to return a `union` array.
-
-##### `input`
-
-When a mutation is made, the shape of this mutation needs to fit the shape create by this function.
-
-### Resolvers
-
-`resolvers` can be thought of as the runtime siblings to `builders`. While it's the job of builders to define the "graph", the resolvers are responsible for taking raw values (like those from a `.md` file) and shaping them so they fit the schema.
-
-#### Field-level resolvers
-
-Again, similar to field-level builders, most of the work for resolving the data is passed on to the appropriate field to handle. So if you have a document like so:
-
-```md
----
-title: Hello, World!
-author: /authors/homer.md
----
-```
-
-It's template definition might look like:
-
-```yaml
-label: Post
----
-fields:
-  - name: title
-    label: Title
-    type: text
-  - name: author
-    label: Author
-    type: select
-    config:
-      source:
-        type: pages
-        section: authors
-```
-
-The `text.resolver` object will be responsible for resolving the values related to `title`:
-
-##### `field`
-
-The `field` resolver provides the appropriate values for it's `field` builder counterpart. In the example above the `text.resolve.field` function would return:
-
-```json
-{
-  "name": "title",
-  "label": "Title",
-  "component": "text"
-}
-```
-
-This would then be passed on to Tina for rendering on the client.
-
-##### `initialValue`
-
-In the example above the `text.resolve.initialValue` would return "Hello, World!"
-
-For blocks we need to return the object along with a `_template` key, this is used downstream to disambiguate which template the value comes from.
-
-##### `value`
-
-In the example above the `text.resolve.value` would return "Hello, World!", and again, for document references this would return the entire document being referenced, which may or may not be used depending on the graph fields requested
-
-##### `input`
-
-Input resolvers don't do much (except in the case of blocks described later), since the GraphQL mutataion payload has all the necessary information, we just pass the value into these resolvers as a runtime type-check. In the future, this is where field-level validations can take place.
-
-**Caveats with `blocks`**: `blocks` values are an array of unlike objects, meaning in order to enforce type-safe requests coming into the server, we need to use a somewhat awkward pattern ([read more about the trade-offs here](https://github.com/graphql/graphql-spec/blob/master/rfcs/InputUnion.md#-5-one-of-tagged-union)) which we sort of need to rearrange once it hits the server.
-
-## Architecture Diagram
-
-<iframe style="border:none" width="700" height="350" src="https://whimsical.com/embed/Kh28ULaAYKPRpeCLm3VG63@2Ux7TurymMtzhxz2sLxX"></iframe>
-
-## Caveats
-
-### Why do we use `GraphQLUnion` instead of `GraphQLInterface` for fields?
-
-Since `component`, `label`, & `name` are common across all fields, we'd only use a fragment to gather what's unique to that field type, so field definitions using an interface would allow our queries to look like this:
-
-```graphql
-fields {
-  component
-  label
-  name
-  ...on SelectField {
-    options
-  }
-}
-```
-
-Instead, we use a union - which requires us to load each key inside it's respective fragment:
-
-```graphql
-fields {
-  ... on TextareaField {
-    name
-    label
-    component
-  }
-  ... on SelectField {
-    name
-    label
-    component
-    options
-  }
-}
-```
-
-A GraphQL interface allows you to define a heterogeneous set of types, which have some fields in common. This is a textbook usecase for interfaces, and it's something that could change in the future. But the current reason we're using unions is because unions are exhaustive, and they allow us to scope down the possible field types for a given set of fields.
-
-An interface would be too broad for our needs, a collection of fields should only contain the types which are possible for that given template config. So while an `interface` would allow us to present **all** possible field types, a `union` gives us the ability to scope down the field list to only allow what the template defines. Using `unions` forces us to be explicit about that in a way that's clear (note: it may be possible to do this with interfaces but there would end up being an interface for each collection of possible fields - making the `interface` term somewhat misleading). Using unions also allows our auto-querybuilder to know that they have populated all possible types of a field, something that seems like it might be more difficult with interfaces.