graphlit-client 1.0.20260220002 → 1.0.20260220004

package/dist/client.d.ts

@@ -2629,3 +2629,5 @@ declare class Graphlit {
 }
 export { Graphlit };
 export * as Types from "./generated/graphql-types.js";
+export { getPartialErrors, PARTIAL_ERRORS_KEY } from "./partial-errors.js";
+export type { PartialGraphQLError } from "./partial-errors.js";

package/dist/client.js

@@ -3,6 +3,7 @@ import jwt from "jsonwebtoken";
 import { ApolloClient, InMemoryCache, createHttpLink, ApolloLink, ApolloError, } from "@apollo/client/core/index.js";
 // Apollo retry link for resilient error handling
 import { RetryLink } from "@apollo/client/link/retry/index.js";
+import { attachPartialErrors } from "./partial-errors.js";
 import * as Types from "./generated/graphql-types.js";
 import * as Documents from "./generated/graphql-documents.js";
 import { getServiceType, getModelName, getModelEnum } from "./model-mapping.js";
@@ -6125,6 +6126,7 @@ class Graphlit {
                 console.warn("GraphQL mutation returned partial data with errors:", result.errors
                     .map((err) => this.prettyPrintGraphQLError(err))
                     .join("\n"));
+                attachPartialErrors(result.data, result.errors);
             }
             if (!result.data) {
                 throw new Error("No data returned from mutation.");
@@ -6141,6 +6143,7 @@ class Graphlit {
                         console.warn("GraphQL mutation returned partial data with errors:", error.graphQLErrors
                             .map((err) => this.prettyPrintGraphQLError(err))
                             .join("\n"));
+                        attachPartialErrors(networkResult.data, error.graphQLErrors);
                         return networkResult.data;
                     }
                 }
@@ -6179,6 +6182,7 @@ class Graphlit {
                 console.warn("GraphQL query returned partial data with errors:", result.errors
                     .map((err) => this.prettyPrintGraphQLError(err))
                     .join("\n"));
+                attachPartialErrors(result.data, result.errors);
             }
             if (!result.data) {
                 throw new Error("No data returned from query.");
@@ -6195,6 +6199,7 @@ class Graphlit {
                         console.warn("GraphQL query returned partial data with errors:", error.graphQLErrors
                             .map((err) => this.prettyPrintGraphQLError(err))
                             .join("\n"));
+                        attachPartialErrors(networkResult.data, error.graphQLErrors);
                         return networkResult.data;
                     }
                 }
@@ -6216,3 +6221,4 @@ class Graphlit {
 }
 export { Graphlit };
 export * as Types from "./generated/graphql-types.js";
+export { getPartialErrors, PARTIAL_ERRORS_KEY } from "./partial-errors.js";

package/dist/partial-errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Partial GraphQL error surfacing.
+ *
+ * When a GraphQL response contains both `data` and `errors`, the SDK returns
+ * the partial data so callers don't break.  This module lets callers opt-in to
+ * inspecting the errors that came alongside that partial data.
+ *
+ * Errors are attached as a non-enumerable, Symbol-keyed property so they are
+ * invisible to JSON.stringify, Object.keys, for…in, and spread — no breaking
+ * changes for any existing consumer.
+ */
+export declare const PARTIAL_ERRORS_KEY: unique symbol;
+/**
+ * Simplified representation of a GraphQL error that doesn't require consumers
+ * to depend on the `graphql` package.
+ */
+export interface PartialGraphQLError {
+    message: string;
+    path?: ReadonlyArray<string | number>;
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Retrieve partial errors attached to an SDK result, if any.
+ *
+ * @returns The array of errors, or `undefined` if the result had no errors.
+ *
+ * @example
+ * ```ts
+ * const result = await client.queryGitHubRepositories(input);
+ * const errors = getPartialErrors(result);
+ * if (errors) {
+ *   console.warn("Partial errors:", errors);
+ * }
+ * ```
+ */
+export declare function getPartialErrors(result: unknown): PartialGraphQLError[] | undefined;
+/**
+ * Attach partial errors to an SDK result object.  The property is
+ * non-enumerable so it won't appear in serialisation or iteration.
+ *
+ * @internal — only called from client.ts
+ */
+export declare function attachPartialErrors<T>(data: T, errors: ReadonlyArray<{
+    message: string;
+    path?: ReadonlyArray<string | number>;
+    extensions?: Record<string, unknown>;
+}>): T;

package/dist/partial-errors.js

@@ -0,0 +1,58 @@
+/**
+ * Partial GraphQL error surfacing.
+ *
+ * When a GraphQL response contains both `data` and `errors`, the SDK returns
+ * the partial data so callers don't break.  This module lets callers opt-in to
+ * inspecting the errors that came alongside that partial data.
+ *
+ * Errors are attached as a non-enumerable, Symbol-keyed property so they are
+ * invisible to JSON.stringify, Object.keys, for…in, and spread — no breaking
+ * changes for any existing consumer.
+ */
+// Symbol.for() is globally shared, so even if two copies of the SDK are loaded
+// (e.g. CJS + ESM, or different versions) they will share the same key.
+export const PARTIAL_ERRORS_KEY = Symbol.for("graphlit.partialErrors");
+/**
+ * Retrieve partial errors attached to an SDK result, if any.
+ *
+ * @returns The array of errors, or `undefined` if the result had no errors.
+ *
+ * @example
+ * ```ts
+ * const result = await client.queryGitHubRepositories(input);
+ * const errors = getPartialErrors(result);
+ * if (errors) {
+ *   console.warn("Partial errors:", errors);
+ * }
+ * ```
+ */
+export function getPartialErrors(result) {
+    if (result != null &&
+        typeof result === "object" &&
+        PARTIAL_ERRORS_KEY in result) {
+        return result[PARTIAL_ERRORS_KEY];
+    }
+    return undefined;
+}
+/**
+ * Attach partial errors to an SDK result object.  The property is
+ * non-enumerable so it won't appear in serialisation or iteration.
+ *
+ * @internal — only called from client.ts
+ */
+export function attachPartialErrors(data, errors) {
+    if (data != null && typeof data === "object" && errors.length > 0) {
+        const simplified = errors.map((e) => ({
+            message: e.message,
+            ...(e.path ? { path: e.path } : {}),
+            ...(e.extensions ? { extensions: e.extensions } : {}),
+        }));
+        Object.defineProperty(data, PARTIAL_ERRORS_KEY, {
+            value: simplified,
+            enumerable: false,
+            writable: false,
+            configurable: true,
+        });
+    }
+    return data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphlit-client",
-  "version": "1.0.20260220002",
+  "version": "1.0.20260220004",
   "description": "Graphlit API Client for TypeScript",
   "type": "module",
   "main": "./dist/client.js",