@cmssy/core 10.5.1 → 10.6.0

package/dist/{csp-DJ17P3PN.d.ts → csp-B7ElkvAp.d.ts}

@@ -62,12 +62,38 @@ type CmssyEnvConfig = Omit<CmssyConfig, "org" | "workspaceSlug" | "draftSecret">
  */
 declare function defineCmssyConfig(config: CmssyEnvConfig): CmssyConfig;
 
+/**
+ * Accepting a *typed* document, not a string, is what makes a query's variables
+ * and its result checked together. graphql-codegen emits one of three shapes,
+ * and the SDK takes all of them so an app never has to care which mode its
+ * codegen runs in - or add `graphql` to its runtime dependencies to print an
+ * AST it already has.
+ */
+/**
+ * A document that carries its result and variable types. Structurally
+ * compatible with `TypedDocumentNode` (`@graphql-typed-document-node/core`) and
+ * with graphql-codegen's `TypedDocumentString`, both of which declare the same
+ * phantom `__apiType`.
+ */
+interface CmssyTypedDocument<Result, Variables> {
+    __apiType?: (variables: Variables) => Result;
+}
+
 interface QueryScopedOptions extends GraphqlRequestOptions {
     workspaceId?: string;
 }
 interface CmssyClient {
     readonly config: CmssyClientConfig;
+    /**
+     * Hand it a document that carries its types (what graphql-codegen emits, in
+     * either mode) and the variables are checked and the result inferred; hand it
+     * a query string and it behaves exactly as before. Same method, no second
+     * way to do the same thing.
+     */
+    query<Result, Variables>(document: CmssyTypedDocument<Result, Variables>, variables: Variables, options?: GraphqlRequestOptions): Promise<Result>;
     query<T = unknown>(document: string, variables?: Record<string, unknown>, options?: GraphqlRequestOptions): Promise<T>;
+    /** {@link CmssyClient.query} with the workspace id resolved and injected. */
+    queryScoped<Result, Variables>(document: CmssyTypedDocument<Result, Variables>, variables: Omit<Variables, "workspaceId">, options?: QueryScopedOptions): Promise<Result>;
     queryScoped<T = unknown>(document: string, variables?: Record<string, unknown>, options?: QueryScopedOptions): Promise<T>;
     resolveWorkspaceId(options?: GraphqlRequestOptions): Promise<string>;
 }
@@ -186,4 +212,4 @@ declare function toCspOrigin(origin: string): string;
 declare function cmssyCspHeaders(options: CmssyCspOptions): Record<string, string>;
 declare function applyCmssyCsp<T extends MutableHeaders>(response: T, options: CmssyCspOptions): T;
 
-export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, type SelectMessage as S, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type ParentReadyMessage as e, type PatchMessage as f, type PostTarget as g, applyCmssyCsp as h, createCmssyClient as i, defineCmssyConfig as j, isProtocolCompatible as k, postToEditor as l, cmssyCspHeaders as m, normalizeOrigin as n, isDevelopment as o, parseEditorMessage as p, resolveInitialTarget as q, resolveEditorOrigin as r, toCspOrigin as t };
+export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, type SelectMessage as S, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyTypedDocument as e, type ParentReadyMessage as f, type PatchMessage as g, type PostTarget as h, applyCmssyCsp as i, createCmssyClient as j, defineCmssyConfig as k, isProtocolCompatible as l, postToEditor as m, normalizeOrigin as n, cmssyCspHeaders as o, parseEditorMessage as p, isDevelopment as q, resolveEditorOrigin as r, resolveInitialTarget as s, toCspOrigin as t };

package/dist/{csp-BityT_ug.d.cts → csp-Bzrk_BeO.d.cts}

@@ -62,12 +62,38 @@ type CmssyEnvConfig = Omit<CmssyConfig, "org" | "workspaceSlug" | "draftSecret">
  */
 declare function defineCmssyConfig(config: CmssyEnvConfig): CmssyConfig;
 
+/**
+ * Accepting a *typed* document, not a string, is what makes a query's variables
+ * and its result checked together. graphql-codegen emits one of three shapes,
+ * and the SDK takes all of them so an app never has to care which mode its
+ * codegen runs in - or add `graphql` to its runtime dependencies to print an
+ * AST it already has.
+ */
+/**
+ * A document that carries its result and variable types. Structurally
+ * compatible with `TypedDocumentNode` (`@graphql-typed-document-node/core`) and
+ * with graphql-codegen's `TypedDocumentString`, both of which declare the same
+ * phantom `__apiType`.
+ */
+interface CmssyTypedDocument<Result, Variables> {
+    __apiType?: (variables: Variables) => Result;
+}
+
 interface QueryScopedOptions extends GraphqlRequestOptions {
     workspaceId?: string;
 }
 interface CmssyClient {
     readonly config: CmssyClientConfig;
+    /**
+     * Hand it a document that carries its types (what graphql-codegen emits, in
+     * either mode) and the variables are checked and the result inferred; hand it
+     * a query string and it behaves exactly as before. Same method, no second
+     * way to do the same thing.
+     */
+    query<Result, Variables>(document: CmssyTypedDocument<Result, Variables>, variables: Variables, options?: GraphqlRequestOptions): Promise<Result>;
     query<T = unknown>(document: string, variables?: Record<string, unknown>, options?: GraphqlRequestOptions): Promise<T>;
+    /** {@link CmssyClient.query} with the workspace id resolved and injected. */
+    queryScoped<Result, Variables>(document: CmssyTypedDocument<Result, Variables>, variables: Omit<Variables, "workspaceId">, options?: QueryScopedOptions): Promise<Result>;
     queryScoped<T = unknown>(document: string, variables?: Record<string, unknown>, options?: QueryScopedOptions): Promise<T>;
     resolveWorkspaceId(options?: GraphqlRequestOptions): Promise<string>;
 }
@@ -186,4 +212,4 @@ declare function toCspOrigin(origin: string): string;
 declare function cmssyCspHeaders(options: CmssyCspOptions): Record<string, string>;
 declare function applyCmssyCsp<T extends MutableHeaders>(response: T, options: CmssyCspOptions): T;
 
-export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, type SelectMessage as S, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type ParentReadyMessage as e, type PatchMessage as f, type PostTarget as g, applyCmssyCsp as h, createCmssyClient as i, defineCmssyConfig as j, isProtocolCompatible as k, postToEditor as l, cmssyCspHeaders as m, normalizeOrigin as n, isDevelopment as o, parseEditorMessage as p, resolveInitialTarget as q, resolveEditorOrigin as r, toCspOrigin as t };
+export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, type SelectMessage as S, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyTypedDocument as e, type ParentReadyMessage as f, type PatchMessage as g, type PostTarget as h, applyCmssyCsp as i, createCmssyClient as j, defineCmssyConfig as k, isProtocolCompatible as l, postToEditor as m, normalizeOrigin as n, cmssyCspHeaders as o, parseEditorMessage as p, isDevelopment as q, resolveEditorOrigin as r, resolveInitialTarget as s, toCspOrigin as t };

package/dist/index.cjs

@@ -202,6 +202,154 @@ async function graphqlRequest(config, query, variables, options = {}, label = "r
   });
 }
 
+// src/data/document.ts
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.kind === "string";
+}
+function name(node) {
+  return isNode(node) ? String(node.value ?? "") : "";
+}
+function printValue(node) {
+  if (!isNode(node)) return "null";
+  const value = node.value;
+  switch (node.kind) {
+    case "Variable":
+      return `$${name(node.name)}`;
+    case "IntValue":
+    case "FloatValue":
+    case "BooleanValue":
+      return String(value);
+    case "StringValue":
+      return node.block ? `"""
+${String(value)}
+"""` : JSON.stringify(String(value));
+    case "EnumValue":
+      return String(value);
+    case "NullValue":
+      return "null";
+    case "ListValue":
+      return `[${(node.values ?? []).map(printValue).join(", ")}]`;
+    case "ObjectValue":
+      return `{${(node.fields ?? []).map(
+        (field) => `${name(field.name)}: ${printValue(
+          field.value
+        )}`
+      ).join(", ")}}`;
+    default:
+      return "null";
+  }
+}
+function printType(node) {
+  if (!isNode(node)) return "";
+  switch (node.kind) {
+    case "NonNullType":
+      return `${printType(node.type)}!`;
+    case "ListType":
+      return `[${printType(node.type)}]`;
+    default:
+      return name(node.name);
+  }
+}
+function printArguments(node) {
+  const args = node.arguments ?? [];
+  if (args.length === 0) return "";
+  return `(${args.map(
+    (arg) => `${name(arg.name)}: ${printValue(
+      arg.value
+    )}`
+  ).join(", ")})`;
+}
+function printDirectives(node) {
+  const directives = node.directives ?? [];
+  if (directives.length === 0) return "";
+  return ` ${directives.map(
+    (directive) => `@${name(directive.name)}${printArguments(directive)}`
+  ).join(" ")}`;
+}
+function printSelectionSet(node, depth) {
+  if (!isNode(node)) return "";
+  const selections = node.selections ?? [];
+  if (selections.length === 0) return "";
+  const pad = "  ".repeat(depth + 1);
+  const body = selections.map((selection) => `${pad}${printSelection(selection, depth + 1)}`).join("\n");
+  return ` {
+${body}
+${"  ".repeat(depth)}}`;
+}
+function printSelection(node, depth) {
+  if (node.kind === "FragmentSpread") {
+    return `...${name(node.name)}${printDirectives(node)}`;
+  }
+  if (node.kind === "InlineFragment") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? ` on ${name(condition.name)}` : "";
+    return `...${on}${printDirectives(node)}${printSelectionSet(
+      node.selectionSet,
+      depth
+    )}`;
+  }
+  const alias = node.alias;
+  const prefix = isNode(alias) ? `${name(alias)}: ` : "";
+  return `${prefix}${name(node.name)}${printArguments(
+    node
+  )}${printDirectives(node)}${printSelectionSet(
+    node.selectionSet,
+    depth
+  )}`;
+}
+function printVariableDefinitions(node) {
+  const definitions = node.variableDefinitions ?? [];
+  if (definitions.length === 0) return "";
+  return `(${definitions.map((definition) => {
+    const variable = definition.variable;
+    const declared = `$${name(
+      isNode(variable) ? variable.name : void 0
+    )}: ${printType(definition.type)}`;
+    const defaultValue = definition.defaultValue;
+    return isNode(defaultValue) ? `${declared} = ${printValue(defaultValue)}` : declared;
+  }).join(", ")})`;
+}
+function printDefinition(node) {
+  if (node.kind === "FragmentDefinition") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? name(condition.name) : "";
+    return `fragment ${name(node.name)} on ${on}${printDirectives(
+      node
+    )}${printSelectionSet(node.selectionSet, 0)}`;
+  }
+  const operation = String(
+    node.operation ?? "query"
+  );
+  const operationName = name(node.name);
+  const head = operationName ? `${operation} ${operationName}` : operation;
+  return `${head}${printVariableDefinitions(node)}${printDirectives(
+    node
+  )}${printSelectionSet(node.selectionSet, 0)}`;
+}
+function printDocumentNode(node) {
+  const definitions = node.definitions ?? [];
+  return definitions.map(printDefinition).join("\n\n");
+}
+function documentText(document2) {
+  if (typeof document2 === "string") return document2;
+  if (!document2 || typeof document2 !== "object") {
+    throw new TypeError(
+      "cmssy: expected a GraphQL document - a query string, a TypedDocumentString, or a TypedDocumentNode"
+    );
+  }
+  const loc = document2.loc;
+  if (typeof loc?.source?.body === "string") return loc.source.body;
+  if (document2.kind === "Document") {
+    const printed = printDocumentNode(document2);
+    if (printed.trim()) return printed;
+  }
+  const asString = String(document2);
+  if (asString && asString !== "[object Object]") return asString;
+  throw new TypeError(
+    "cmssy: could not read the query text off the given document"
+  );
+}
+
 // src/data/queries.ts
 var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
   public {
@@ -266,32 +414,41 @@ function createCmssyClient(input) {
     }
     return inFlight;
   }
-  return {
+  function query(document2, variables, options) {
+    return graphqlRequest(
+      config,
+      document2,
+      variables,
+      options,
+      "graphql operation"
+    );
+  }
+  async function queryScoped(document2, variables, options = {}) {
+    const { workspaceId: provided, headers, ...rest } = options;
+    const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
+    const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
+    const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
+    return graphqlRequest(
+      config,
+      document2,
+      scopedVariables,
+      { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
+      "graphql operation"
+    );
+  }
+  const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query(document2, variables = {}, options) {
-      return graphqlRequest(
-        config,
-        document2,
-        variables,
-        options,
-        "graphql operation"
-      );
-    },
-    async queryScoped(document2, variables = {}, options = {}) {
-      const { workspaceId: provided, headers, ...rest } = options;
-      const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
-      const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
-      const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
-      return graphqlRequest(
-        config,
-        document2,
-        scopedVariables,
-        { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
-        "graphql operation"
-      );
-    }
+    // One implementation behind both overloads: a string passes through
+    // documentText untouched, a typed document gives up its query text.
+    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
+      documentText(document2),
+      variables,
+      options
+    ))
   };
+  return client;
 }
 
 // src/fields.ts

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-BityT_ug.cjs';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, f as ParentReadyMessage, g as PatchMessage, h as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, i as applyCmssyCsp, j as createCmssyClient, k as defineCmssyConfig, l as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, m as postToEditor, r as resolveEditorOrigin } from './csp-Bzrk_BeO.cjs';
 export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-C7sA46qu.cjs';
 export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-CJQ-nafm.cjs';
 import * as _cmssy_types from '@cmssy/types';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DJ17P3PN.js';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, f as ParentReadyMessage, g as PatchMessage, h as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, i as applyCmssyCsp, j as createCmssyClient, k as defineCmssyConfig, l as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, m as postToEditor, r as resolveEditorOrigin } from './csp-B7ElkvAp.js';
 export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-Ox_qVlNy.js';
 export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-CJQ-nafm.js';
 import * as _cmssy_types from '@cmssy/types';

package/dist/index.js

@@ -200,6 +200,154 @@ async function graphqlRequest(config, query, variables, options = {}, label = "r
   });
 }
 
+// src/data/document.ts
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.kind === "string";
+}
+function name(node) {
+  return isNode(node) ? String(node.value ?? "") : "";
+}
+function printValue(node) {
+  if (!isNode(node)) return "null";
+  const value = node.value;
+  switch (node.kind) {
+    case "Variable":
+      return `$${name(node.name)}`;
+    case "IntValue":
+    case "FloatValue":
+    case "BooleanValue":
+      return String(value);
+    case "StringValue":
+      return node.block ? `"""
+${String(value)}
+"""` : JSON.stringify(String(value));
+    case "EnumValue":
+      return String(value);
+    case "NullValue":
+      return "null";
+    case "ListValue":
+      return `[${(node.values ?? []).map(printValue).join(", ")}]`;
+    case "ObjectValue":
+      return `{${(node.fields ?? []).map(
+        (field) => `${name(field.name)}: ${printValue(
+          field.value
+        )}`
+      ).join(", ")}}`;
+    default:
+      return "null";
+  }
+}
+function printType(node) {
+  if (!isNode(node)) return "";
+  switch (node.kind) {
+    case "NonNullType":
+      return `${printType(node.type)}!`;
+    case "ListType":
+      return `[${printType(node.type)}]`;
+    default:
+      return name(node.name);
+  }
+}
+function printArguments(node) {
+  const args = node.arguments ?? [];
+  if (args.length === 0) return "";
+  return `(${args.map(
+    (arg) => `${name(arg.name)}: ${printValue(
+      arg.value
+    )}`
+  ).join(", ")})`;
+}
+function printDirectives(node) {
+  const directives = node.directives ?? [];
+  if (directives.length === 0) return "";
+  return ` ${directives.map(
+    (directive) => `@${name(directive.name)}${printArguments(directive)}`
+  ).join(" ")}`;
+}
+function printSelectionSet(node, depth) {
+  if (!isNode(node)) return "";
+  const selections = node.selections ?? [];
+  if (selections.length === 0) return "";
+  const pad = "  ".repeat(depth + 1);
+  const body = selections.map((selection) => `${pad}${printSelection(selection, depth + 1)}`).join("\n");
+  return ` {
+${body}
+${"  ".repeat(depth)}}`;
+}
+function printSelection(node, depth) {
+  if (node.kind === "FragmentSpread") {
+    return `...${name(node.name)}${printDirectives(node)}`;
+  }
+  if (node.kind === "InlineFragment") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? ` on ${name(condition.name)}` : "";
+    return `...${on}${printDirectives(node)}${printSelectionSet(
+      node.selectionSet,
+      depth
+    )}`;
+  }
+  const alias = node.alias;
+  const prefix = isNode(alias) ? `${name(alias)}: ` : "";
+  return `${prefix}${name(node.name)}${printArguments(
+    node
+  )}${printDirectives(node)}${printSelectionSet(
+    node.selectionSet,
+    depth
+  )}`;
+}
+function printVariableDefinitions(node) {
+  const definitions = node.variableDefinitions ?? [];
+  if (definitions.length === 0) return "";
+  return `(${definitions.map((definition) => {
+    const variable = definition.variable;
+    const declared = `$${name(
+      isNode(variable) ? variable.name : void 0
+    )}: ${printType(definition.type)}`;
+    const defaultValue = definition.defaultValue;
+    return isNode(defaultValue) ? `${declared} = ${printValue(defaultValue)}` : declared;
+  }).join(", ")})`;
+}
+function printDefinition(node) {
+  if (node.kind === "FragmentDefinition") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? name(condition.name) : "";
+    return `fragment ${name(node.name)} on ${on}${printDirectives(
+      node
+    )}${printSelectionSet(node.selectionSet, 0)}`;
+  }
+  const operation = String(
+    node.operation ?? "query"
+  );
+  const operationName = name(node.name);
+  const head = operationName ? `${operation} ${operationName}` : operation;
+  return `${head}${printVariableDefinitions(node)}${printDirectives(
+    node
+  )}${printSelectionSet(node.selectionSet, 0)}`;
+}
+function printDocumentNode(node) {
+  const definitions = node.definitions ?? [];
+  return definitions.map(printDefinition).join("\n\n");
+}
+function documentText(document2) {
+  if (typeof document2 === "string") return document2;
+  if (!document2 || typeof document2 !== "object") {
+    throw new TypeError(
+      "cmssy: expected a GraphQL document - a query string, a TypedDocumentString, or a TypedDocumentNode"
+    );
+  }
+  const loc = document2.loc;
+  if (typeof loc?.source?.body === "string") return loc.source.body;
+  if (document2.kind === "Document") {
+    const printed = printDocumentNode(document2);
+    if (printed.trim()) return printed;
+  }
+  const asString = String(document2);
+  if (asString && asString !== "[object Object]") return asString;
+  throw new TypeError(
+    "cmssy: could not read the query text off the given document"
+  );
+}
+
 // src/data/queries.ts
 var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
   public {
@@ -264,32 +412,41 @@ function createCmssyClient(input) {
     }
     return inFlight;
   }
-  return {
+  function query(document2, variables, options) {
+    return graphqlRequest(
+      config,
+      document2,
+      variables,
+      options,
+      "graphql operation"
+    );
+  }
+  async function queryScoped(document2, variables, options = {}) {
+    const { workspaceId: provided, headers, ...rest } = options;
+    const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
+    const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
+    const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
+    return graphqlRequest(
+      config,
+      document2,
+      scopedVariables,
+      { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
+      "graphql operation"
+    );
+  }
+  const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query(document2, variables = {}, options) {
-      return graphqlRequest(
-        config,
-        document2,
-        variables,
-        options,
-        "graphql operation"
-      );
-    },
-    async queryScoped(document2, variables = {}, options = {}) {
-      const { workspaceId: provided, headers, ...rest } = options;
-      const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
-      const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
-      const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
-      return graphqlRequest(
-        config,
-        document2,
-        scopedVariables,
-        { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
-        "graphql operation"
-      );
-    }
+    // One implementation behind both overloads: a string passes through
+    // documentText untouched, a typed document gives up its query text.
+    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
+      documentText(document2),
+      variables,
+      options
+    ))
   };
+  return client;
 }
 
 // src/fields.ts

package/dist/internal.cjs

@@ -468,6 +468,154 @@ function clearWorkspaceIdCache() {
   workspaceIdCache.clear();
 }
 
+// src/data/document.ts
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.kind === "string";
+}
+function name(node) {
+  return isNode(node) ? String(node.value ?? "") : "";
+}
+function printValue(node) {
+  if (!isNode(node)) return "null";
+  const value = node.value;
+  switch (node.kind) {
+    case "Variable":
+      return `$${name(node.name)}`;
+    case "IntValue":
+    case "FloatValue":
+    case "BooleanValue":
+      return String(value);
+    case "StringValue":
+      return node.block ? `"""
+${String(value)}
+"""` : JSON.stringify(String(value));
+    case "EnumValue":
+      return String(value);
+    case "NullValue":
+      return "null";
+    case "ListValue":
+      return `[${(node.values ?? []).map(printValue).join(", ")}]`;
+    case "ObjectValue":
+      return `{${(node.fields ?? []).map(
+        (field) => `${name(field.name)}: ${printValue(
+          field.value
+        )}`
+      ).join(", ")}}`;
+    default:
+      return "null";
+  }
+}
+function printType(node) {
+  if (!isNode(node)) return "";
+  switch (node.kind) {
+    case "NonNullType":
+      return `${printType(node.type)}!`;
+    case "ListType":
+      return `[${printType(node.type)}]`;
+    default:
+      return name(node.name);
+  }
+}
+function printArguments(node) {
+  const args = node.arguments ?? [];
+  if (args.length === 0) return "";
+  return `(${args.map(
+    (arg) => `${name(arg.name)}: ${printValue(
+      arg.value
+    )}`
+  ).join(", ")})`;
+}
+function printDirectives(node) {
+  const directives = node.directives ?? [];
+  if (directives.length === 0) return "";
+  return ` ${directives.map(
+    (directive) => `@${name(directive.name)}${printArguments(directive)}`
+  ).join(" ")}`;
+}
+function printSelectionSet(node, depth) {
+  if (!isNode(node)) return "";
+  const selections = node.selections ?? [];
+  if (selections.length === 0) return "";
+  const pad = "  ".repeat(depth + 1);
+  const body = selections.map((selection) => `${pad}${printSelection(selection, depth + 1)}`).join("\n");
+  return ` {
+${body}
+${"  ".repeat(depth)}}`;
+}
+function printSelection(node, depth) {
+  if (node.kind === "FragmentSpread") {
+    return `...${name(node.name)}${printDirectives(node)}`;
+  }
+  if (node.kind === "InlineFragment") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? ` on ${name(condition.name)}` : "";
+    return `...${on}${printDirectives(node)}${printSelectionSet(
+      node.selectionSet,
+      depth
+    )}`;
+  }
+  const alias = node.alias;
+  const prefix = isNode(alias) ? `${name(alias)}: ` : "";
+  return `${prefix}${name(node.name)}${printArguments(
+    node
+  )}${printDirectives(node)}${printSelectionSet(
+    node.selectionSet,
+    depth
+  )}`;
+}
+function printVariableDefinitions(node) {
+  const definitions = node.variableDefinitions ?? [];
+  if (definitions.length === 0) return "";
+  return `(${definitions.map((definition) => {
+    const variable = definition.variable;
+    const declared = `$${name(
+      isNode(variable) ? variable.name : void 0
+    )}: ${printType(definition.type)}`;
+    const defaultValue = definition.defaultValue;
+    return isNode(defaultValue) ? `${declared} = ${printValue(defaultValue)}` : declared;
+  }).join(", ")})`;
+}
+function printDefinition(node) {
+  if (node.kind === "FragmentDefinition") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? name(condition.name) : "";
+    return `fragment ${name(node.name)} on ${on}${printDirectives(
+      node
+    )}${printSelectionSet(node.selectionSet, 0)}`;
+  }
+  const operation = String(
+    node.operation ?? "query"
+  );
+  const operationName = name(node.name);
+  const head = operationName ? `${operation} ${operationName}` : operation;
+  return `${head}${printVariableDefinitions(node)}${printDirectives(
+    node
+  )}${printSelectionSet(node.selectionSet, 0)}`;
+}
+function printDocumentNode(node) {
+  const definitions = node.definitions ?? [];
+  return definitions.map(printDefinition).join("\n\n");
+}
+function documentText(document2) {
+  if (typeof document2 === "string") return document2;
+  if (!document2 || typeof document2 !== "object") {
+    throw new TypeError(
+      "cmssy: expected a GraphQL document - a query string, a TypedDocumentString, or a TypedDocumentNode"
+    );
+  }
+  const loc = document2.loc;
+  if (typeof loc?.source?.body === "string") return loc.source.body;
+  if (document2.kind === "Document") {
+    const printed = printDocumentNode(document2);
+    if (printed.trim()) return printed;
+  }
+  const asString = String(document2);
+  if (asString && asString !== "[object Object]") return asString;
+  throw new TypeError(
+    "cmssy: could not read the query text off the given document"
+  );
+}
+
 // src/data/client.ts
 function createCmssyClient(input) {
   const config = {
@@ -488,32 +636,41 @@ function createCmssyClient(input) {
     }
     return inFlight;
   }
-  return {
+  function query(document2, variables, options) {
+    return graphqlRequest(
+      config,
+      document2,
+      variables,
+      options,
+      "graphql operation"
+    );
+  }
+  async function queryScoped(document2, variables, options = {}) {
+    const { workspaceId: provided, headers, ...rest } = options;
+    const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
+    const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
+    const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
+    return graphqlRequest(
+      config,
+      document2,
+      scopedVariables,
+      { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
+      "graphql operation"
+    );
+  }
+  const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query(document2, variables = {}, options) {
-      return graphqlRequest(
-        config,
-        document2,
-        variables,
-        options,
-        "graphql operation"
-      );
-    },
-    async queryScoped(document2, variables = {}, options = {}) {
-      const { workspaceId: provided, headers, ...rest } = options;
-      const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
-      const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
-      const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
-      return graphqlRequest(
-        config,
-        document2,
-        scopedVariables,
-        { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
-        "graphql operation"
-      );
-    }
+    // One implementation behind both overloads: a string passes through
+    // documentText untouched, a typed document gives up its query text.
+    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
+      documentText(document2),
+      variables,
+      options
+    ))
   };
+  return client;
 }
 
 // src/data/resolve-forms.ts

package/dist/internal.d.cts

@@ -3,8 +3,8 @@ import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyCl
 export { CmssySiteLocales } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-C7sA46qu.cjs';
 export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-C7sA46qu.cjs';
-import { Q as QueryScopedOptions } from './csp-BityT_ug.cjs';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-BityT_ug.cjs';
+import { Q as QueryScopedOptions } from './csp-Bzrk_BeO.cjs';
+export { o as cmssyCspHeaders, q as isDevelopment, s as resolveInitialTarget, t as toCspOrigin } from './csp-Bzrk_BeO.cjs';
 export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } from './internal/locale.cjs';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        logoDarkUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.d.ts

@@ -3,8 +3,8 @@ import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyCl
 export { CmssySiteLocales } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-Ox_qVlNy.js';
 export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-Ox_qVlNy.js';
-import { Q as QueryScopedOptions } from './csp-DJ17P3PN.js';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DJ17P3PN.js';
+import { Q as QueryScopedOptions } from './csp-B7ElkvAp.js';
+export { o as cmssyCspHeaders, q as isDevelopment, s as resolveInitialTarget, t as toCspOrigin } from './csp-B7ElkvAp.js';
 export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } from './internal/locale.js';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        logoDarkUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.js

@@ -466,6 +466,154 @@ function clearWorkspaceIdCache() {
   workspaceIdCache.clear();
 }
 
+// src/data/document.ts
+function isNode(value) {
+  return typeof value === "object" && value !== null && typeof value.kind === "string";
+}
+function name(node) {
+  return isNode(node) ? String(node.value ?? "") : "";
+}
+function printValue(node) {
+  if (!isNode(node)) return "null";
+  const value = node.value;
+  switch (node.kind) {
+    case "Variable":
+      return `$${name(node.name)}`;
+    case "IntValue":
+    case "FloatValue":
+    case "BooleanValue":
+      return String(value);
+    case "StringValue":
+      return node.block ? `"""
+${String(value)}
+"""` : JSON.stringify(String(value));
+    case "EnumValue":
+      return String(value);
+    case "NullValue":
+      return "null";
+    case "ListValue":
+      return `[${(node.values ?? []).map(printValue).join(", ")}]`;
+    case "ObjectValue":
+      return `{${(node.fields ?? []).map(
+        (field) => `${name(field.name)}: ${printValue(
+          field.value
+        )}`
+      ).join(", ")}}`;
+    default:
+      return "null";
+  }
+}
+function printType(node) {
+  if (!isNode(node)) return "";
+  switch (node.kind) {
+    case "NonNullType":
+      return `${printType(node.type)}!`;
+    case "ListType":
+      return `[${printType(node.type)}]`;
+    default:
+      return name(node.name);
+  }
+}
+function printArguments(node) {
+  const args = node.arguments ?? [];
+  if (args.length === 0) return "";
+  return `(${args.map(
+    (arg) => `${name(arg.name)}: ${printValue(
+      arg.value
+    )}`
+  ).join(", ")})`;
+}
+function printDirectives(node) {
+  const directives = node.directives ?? [];
+  if (directives.length === 0) return "";
+  return ` ${directives.map(
+    (directive) => `@${name(directive.name)}${printArguments(directive)}`
+  ).join(" ")}`;
+}
+function printSelectionSet(node, depth) {
+  if (!isNode(node)) return "";
+  const selections = node.selections ?? [];
+  if (selections.length === 0) return "";
+  const pad = "  ".repeat(depth + 1);
+  const body = selections.map((selection) => `${pad}${printSelection(selection, depth + 1)}`).join("\n");
+  return ` {
+${body}
+${"  ".repeat(depth)}}`;
+}
+function printSelection(node, depth) {
+  if (node.kind === "FragmentSpread") {
+    return `...${name(node.name)}${printDirectives(node)}`;
+  }
+  if (node.kind === "InlineFragment") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? ` on ${name(condition.name)}` : "";
+    return `...${on}${printDirectives(node)}${printSelectionSet(
+      node.selectionSet,
+      depth
+    )}`;
+  }
+  const alias = node.alias;
+  const prefix = isNode(alias) ? `${name(alias)}: ` : "";
+  return `${prefix}${name(node.name)}${printArguments(
+    node
+  )}${printDirectives(node)}${printSelectionSet(
+    node.selectionSet,
+    depth
+  )}`;
+}
+function printVariableDefinitions(node) {
+  const definitions = node.variableDefinitions ?? [];
+  if (definitions.length === 0) return "";
+  return `(${definitions.map((definition) => {
+    const variable = definition.variable;
+    const declared = `$${name(
+      isNode(variable) ? variable.name : void 0
+    )}: ${printType(definition.type)}`;
+    const defaultValue = definition.defaultValue;
+    return isNode(defaultValue) ? `${declared} = ${printValue(defaultValue)}` : declared;
+  }).join(", ")})`;
+}
+function printDefinition(node) {
+  if (node.kind === "FragmentDefinition") {
+    const condition = node.typeCondition;
+    const on = isNode(condition) ? name(condition.name) : "";
+    return `fragment ${name(node.name)} on ${on}${printDirectives(
+      node
+    )}${printSelectionSet(node.selectionSet, 0)}`;
+  }
+  const operation = String(
+    node.operation ?? "query"
+  );
+  const operationName = name(node.name);
+  const head = operationName ? `${operation} ${operationName}` : operation;
+  return `${head}${printVariableDefinitions(node)}${printDirectives(
+    node
+  )}${printSelectionSet(node.selectionSet, 0)}`;
+}
+function printDocumentNode(node) {
+  const definitions = node.definitions ?? [];
+  return definitions.map(printDefinition).join("\n\n");
+}
+function documentText(document2) {
+  if (typeof document2 === "string") return document2;
+  if (!document2 || typeof document2 !== "object") {
+    throw new TypeError(
+      "cmssy: expected a GraphQL document - a query string, a TypedDocumentString, or a TypedDocumentNode"
+    );
+  }
+  const loc = document2.loc;
+  if (typeof loc?.source?.body === "string") return loc.source.body;
+  if (document2.kind === "Document") {
+    const printed = printDocumentNode(document2);
+    if (printed.trim()) return printed;
+  }
+  const asString = String(document2);
+  if (asString && asString !== "[object Object]") return asString;
+  throw new TypeError(
+    "cmssy: could not read the query text off the given document"
+  );
+}
+
 // src/data/client.ts
 function createCmssyClient(input) {
   const config = {
@@ -486,32 +634,41 @@ function createCmssyClient(input) {
     }
     return inFlight;
   }
-  return {
+  function query(document2, variables, options) {
+    return graphqlRequest(
+      config,
+      document2,
+      variables,
+      options,
+      "graphql operation"
+    );
+  }
+  async function queryScoped(document2, variables, options = {}) {
+    const { workspaceId: provided, headers, ...rest } = options;
+    const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
+    const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
+    const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
+    return graphqlRequest(
+      config,
+      document2,
+      scopedVariables,
+      { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
+      "graphql operation"
+    );
+  }
+  const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query(document2, variables = {}, options) {
-      return graphqlRequest(
-        config,
-        document2,
-        variables,
-        options,
-        "graphql operation"
-      );
-    },
-    async queryScoped(document2, variables = {}, options = {}) {
-      const { workspaceId: provided, headers, ...rest } = options;
-      const workspaceId = provided ?? await resolveWorkspaceId2({ ...rest, headers });
-      const hasWorkspaceId = variables.workspaceId !== void 0 && variables.workspaceId !== null;
-      const scopedVariables = /\$workspaceId\b/.test(document2) && !hasWorkspaceId ? { ...variables, workspaceId } : variables;
-      return graphqlRequest(
-        config,
-        document2,
-        scopedVariables,
-        { ...rest, headers: { ...headers, "x-workspace-id": workspaceId } },
-        "graphql operation"
-      );
-    }
+    // One implementation behind both overloads: a string passes through
+    // documentText untouched, a typed document gives up its query text.
+    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
+      documentText(document2),
+      variables,
+      options
+    ))
   };
+  return client;
 }
 
 // src/data/resolve-forms.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/core",
-  "version": "10.5.1",
+  "version": "10.6.0",
   "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",