@keystrokehq/shopify 0.1.0 → 0.1.3

package/dist/actions/graph-ql-products.d.cts

@@ -1,9 +1,87 @@
 import { z } from "zod";
 
 //#region src/actions/graph-ql-products.d.ts
-declare const ShopifyGraphQlProductsInput: z.ZodTypeAny;
-declare const ShopifyGraphQlProductsOutput: z.ZodTypeAny;
-declare const shopifyGraphQlProducts: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+declare const ShopifyGraphQlProductsInput: z.ZodObject<{
+  last: z.ZodOptional<z.ZodNumber>;
+  after: z.ZodOptional<z.ZodString>;
+  first: z.ZodOptional<z.ZodNumber>;
+  query: z.ZodOptional<z.ZodString>;
+  before: z.ZodOptional<z.ZodString>;
+  fields: z.ZodOptional<z.ZodString>;
+  reverse: z.ZodOptional<z.ZodBoolean>;
+  sortKey: z.ZodOptional<z.ZodString>;
+  operation: z.ZodEnum<{
+    list_products: "list_products";
+    get_product: "get_product";
+    count_products: "count_products";
+    create_product: "create_product";
+    update_product: "update_product";
+    set_product: "set_product";
+    delete_product: "delete_product";
+    duplicate_product: "duplicate_product";
+    create_options: "create_options";
+    update_option: "update_option";
+    delete_options: "delete_options";
+    reorder_options: "reorder_options";
+    bulk_create_variants: "bulk_create_variants";
+    bulk_update_variants: "bulk_update_variants";
+    bulk_delete_variants: "bulk_delete_variants";
+    bulk_reorder_variants: "bulk_reorder_variants";
+    create_media: "create_media";
+    update_media: "update_media";
+    delete_media: "delete_media";
+    reorder_media: "reorder_media";
+    attach_variant_media: "attach_variant_media";
+    detach_variant_media: "detach_variant_media";
+    publish_product: "publish_product";
+    unpublish_product: "unpublish_product";
+  }>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  api_version: z.ZodOptional<z.ZodString>;
+  raise_on_user_errors: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  raise_on_graphql_errors: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const ShopifyGraphQlProductsOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    path: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    message: z.ZodNullable<z.ZodString>;
+    locations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      column: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>>;
+    extensions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  }, z.core.$loose>>>>;
+  operation: z.ZodNullable<z.ZodString>;
+  page_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    endCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hasNextPage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    startCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hasPreviousPage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  }, z.core.$loose>>>;
+  extensions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  user_errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    field: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    message: z.ZodNullable<z.ZodString>;
+  }, z.core.$loose>>>>;
+  migration_notes: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$loose>;
+declare const shopifyGraphQlProducts: import("@keystrokehq/action").WorkflowActionDefinition<{
+  operation: "list_products" | "get_product" | "count_products" | "create_product" | "update_product" | "set_product" | "delete_product" | "duplicate_product" | "create_options" | "update_option" | "delete_options" | "reorder_options" | "bulk_create_variants" | "bulk_update_variants" | "bulk_delete_variants" | "bulk_reorder_variants" | "create_media" | "update_media" | "delete_media" | "reorder_media" | "attach_variant_media" | "detach_variant_media" | "publish_product" | "unpublish_product";
+  last?: number | undefined;
+  after?: string | undefined;
+  first?: number | undefined;
+  query?: string | undefined;
+  before?: string | undefined;
+  fields?: string | undefined;
+  reverse?: boolean | undefined;
+  sortKey?: string | undefined;
+  variables?: Record<string, unknown> | undefined;
+  api_version?: string | undefined;
+  raise_on_user_errors?: boolean | undefined;
+  raise_on_graphql_errors?: boolean | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
 //#endregion
 export { shopifyGraphQlProducts };
 //# sourceMappingURL=graph-ql-products.d.cts.map

package/dist/actions/graph-ql-products.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-products.d.cts","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"mappings":";;;cAIa,2BAAA,EAA6B,CAAA,CAAE,UAcqV;AAAA,cAsBpX,4BAAA,EAA8B,CAAA,CAAE,UAQqC;AAAA,cAErE,sBAAA,gCAAsB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}
+{"version":3,"file":"graph-ql-products.d.cts","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"mappings":";;;cAIa,2BAAA,EAA2B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoC3B,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cAU5B,sBAAA,gCAAsB,wBAAA;;;;;;;;;;cAMjC,MAAA"}

package/dist/actions/graph-ql-products.d.mts

@@ -1,9 +1,87 @@
 import { z } from "zod";
 
 //#region src/actions/graph-ql-products.d.ts
-declare const ShopifyGraphQlProductsInput: z.ZodTypeAny;
-declare const ShopifyGraphQlProductsOutput: z.ZodTypeAny;
-declare const shopifyGraphQlProducts: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+declare const ShopifyGraphQlProductsInput: z.ZodObject<{
+  last: z.ZodOptional<z.ZodNumber>;
+  after: z.ZodOptional<z.ZodString>;
+  first: z.ZodOptional<z.ZodNumber>;
+  query: z.ZodOptional<z.ZodString>;
+  before: z.ZodOptional<z.ZodString>;
+  fields: z.ZodOptional<z.ZodString>;
+  reverse: z.ZodOptional<z.ZodBoolean>;
+  sortKey: z.ZodOptional<z.ZodString>;
+  operation: z.ZodEnum<{
+    list_products: "list_products";
+    get_product: "get_product";
+    count_products: "count_products";
+    create_product: "create_product";
+    update_product: "update_product";
+    set_product: "set_product";
+    delete_product: "delete_product";
+    duplicate_product: "duplicate_product";
+    create_options: "create_options";
+    update_option: "update_option";
+    delete_options: "delete_options";
+    reorder_options: "reorder_options";
+    bulk_create_variants: "bulk_create_variants";
+    bulk_update_variants: "bulk_update_variants";
+    bulk_delete_variants: "bulk_delete_variants";
+    bulk_reorder_variants: "bulk_reorder_variants";
+    create_media: "create_media";
+    update_media: "update_media";
+    delete_media: "delete_media";
+    reorder_media: "reorder_media";
+    attach_variant_media: "attach_variant_media";
+    detach_variant_media: "detach_variant_media";
+    publish_product: "publish_product";
+    unpublish_product: "unpublish_product";
+  }>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  api_version: z.ZodOptional<z.ZodString>;
+  raise_on_user_errors: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+  raise_on_graphql_errors: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const ShopifyGraphQlProductsOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    path: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    message: z.ZodNullable<z.ZodString>;
+    locations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      column: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>>;
+    extensions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  }, z.core.$loose>>>>;
+  operation: z.ZodNullable<z.ZodString>;
+  page_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    endCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hasNextPage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    startCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hasPreviousPage: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  }, z.core.$loose>>>;
+  extensions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  user_errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    field: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    message: z.ZodNullable<z.ZodString>;
+  }, z.core.$loose>>>>;
+  migration_notes: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$loose>;
+declare const shopifyGraphQlProducts: import("@keystrokehq/action").WorkflowActionDefinition<{
+  operation: "list_products" | "get_product" | "count_products" | "create_product" | "update_product" | "set_product" | "delete_product" | "duplicate_product" | "create_options" | "update_option" | "delete_options" | "reorder_options" | "bulk_create_variants" | "bulk_update_variants" | "bulk_delete_variants" | "bulk_reorder_variants" | "create_media" | "update_media" | "delete_media" | "reorder_media" | "attach_variant_media" | "detach_variant_media" | "publish_product" | "unpublish_product";
+  last?: number | undefined;
+  after?: string | undefined;
+  first?: number | undefined;
+  query?: string | undefined;
+  before?: string | undefined;
+  fields?: string | undefined;
+  reverse?: boolean | undefined;
+  sortKey?: string | undefined;
+  variables?: Record<string, unknown> | undefined;
+  api_version?: string | undefined;
+  raise_on_user_errors?: boolean | undefined;
+  raise_on_graphql_errors?: boolean | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
 //#endregion
 export { shopifyGraphQlProducts };
 //# sourceMappingURL=graph-ql-products.d.mts.map

package/dist/actions/graph-ql-products.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-products.d.mts","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"mappings":";;;cAIa,2BAAA,EAA6B,CAAA,CAAE,UAcqV;AAAA,cAsBpX,4BAAA,EAA8B,CAAA,CAAE,UAQqC;AAAA,cAErE,sBAAA,gCAAsB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}
+{"version":3,"file":"graph-ql-products.d.mts","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"mappings":";;;cAIa,2BAAA,EAA2B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoC3B,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cAU5B,sBAAA,gCAAsB,wBAAA;;;;;;;;;;cAMjC,MAAA"}

package/dist/actions/graph-ql-products.mjs

@@ -44,24 +44,24 @@ const ShopifyGraphQlProductsInput = z.object({
 const ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema = z.object({
 	line: z.number().int().describe("One-indexed line number.").nullable().optional(),
 	column: z.number().int().describe("One-indexed column number.").nullable().optional()
-}).describe("Location of a GraphQL parse, validation, or execution error.");
+}).passthrough().describe("Location of a GraphQL parse, validation, or execution error.");
 const ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema = z.object({
 	path: z.array(z.union([z.string(), z.number().int()])).describe("Path to the failing response field, when available.").nullable().optional(),
-	message: z.string().describe("Human-readable error message."),
+	message: z.string().describe("Human-readable error message.").nullable(),
 	locations: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema).describe("GraphQL document locations related to the error.").nullable().optional(),
 	extensions: z.record(z.string(), z.unknown()).describe("Shopify-specific error metadata such as error code.").nullable().optional()
-}).describe("GraphQL error object returned by Shopify.");
+}).passthrough().describe("GraphQL error object returned by Shopify.");
 const ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema = z.object({
 	endCursor: z.string().describe("Cursor for the last edge.").nullable().optional(),
 	hasNextPage: z.boolean().describe("Whether a next page exists.").nullable().optional(),
 	startCursor: z.string().describe("Cursor for the first edge.").nullable().optional(),
 	hasPreviousPage: z.boolean().describe("Whether a previous page exists.").nullable().optional()
-}).describe("Cursor pagination metadata for Shopify GraphQL connections.");
+}).passthrough().describe("Cursor pagination metadata for Shopify GraphQL connections.");
 const ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema = z.object({
 	code: z.string().describe("Machine-readable Shopify error code.").nullable().optional(),
 	field: z.array(z.string()).describe("Input field path that caused the user error.").nullable().optional(),
-	message: z.string().describe("Human-readable mutation error.")
-}).describe("Shopify mutation-level user error.");
+	message: z.string().describe("Human-readable mutation error.").nullable()
+}).passthrough().describe("Shopify mutation-level user error.");
 const shopifyGraphQlProducts = action("SHOPIFY_GRAPH_QL_PRODUCTS", {
 	slug: "shopify-graph-ql-products",
 	name: "Shopify GraphQL products, variants, media, and publishing",
@@ -70,12 +70,12 @@ const shopifyGraphQlProducts = action("SHOPIFY_GRAPH_QL_PRODUCTS", {
 	output: z.object({
 		data: z.record(z.string(), z.unknown()).describe("GraphQL data object returned by Shopify. Mutations can still include userErrors even when HTTP and GraphQL execution succeed.").nullable().optional(),
 		errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema).describe("Top-level GraphQL errors, if Shopify returned any.").nullable().optional(),
-		operation: z.string().describe("Canonical operation requested by the caller."),
+		operation: z.string().describe("Canonical operation requested by the caller.").nullable(),
 		page_info: ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema.nullable().optional(),
 		extensions: z.record(z.string(), z.unknown()).describe("GraphQL extensions, including Shopify query cost metadata.").nullable().optional(),
 		user_errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema).describe("All nested Shopify userErrors extracted from mutation payloads.").nullable().optional(),
 		migration_notes: z.array(z.string()).describe("Agent-facing notes for REST-to-GraphQL migration pitfalls.").nullable().optional()
-	}).describe("Consistent response envelope for canonical Shopify GraphQL actions.")
+	}).passthrough().describe("Consistent response envelope for canonical Shopify GraphQL actions.")
 });
 //#endregion
 export { shopifyGraphQlProducts };

package/dist/actions/graph-ql-products.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-products.mjs","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const ShopifyGraphQlProductsInput: z.ZodTypeAny = z.object({\n  last: z.number().int().describe(\"Backward page size for list_products.\").optional(),\n  after: z.string().describe(\"Cursor after which to read products.\").optional(),\n  first: z.number().int().describe(\"Forward page size for list_products.\").optional(),\n  query: z.string().describe(\"Shopify product search query for list_products/count_products.\").optional(),\n  before: z.string().describe(\"Cursor before which to read products.\").optional(),\n  fields: z.string().describe(\"Optional node field selection for product read operations. Keep it valid GraphQL, for example: `id title handle status updatedAt variants(first: 10) { nodes { id title sku } }`.\").optional(),\n  reverse: z.boolean().describe(\"Reverse sort order.\").optional(),\n  sortKey: z.string().describe(\"Shopify ProductSortKeys value.\").optional(),\n  operation: z.enum([\"list_products\", \"get_product\", \"count_products\", \"create_product\", \"update_product\", \"set_product\", \"delete_product\", \"duplicate_product\", \"create_options\", \"update_option\", \"delete_options\", \"reorder_options\", \"bulk_create_variants\", \"bulk_update_variants\", \"bulk_delete_variants\", \"bulk_reorder_variants\", \"create_media\", \"update_media\", \"delete_media\", \"reorder_media\", \"attach_variant_media\", \"detach_variant_media\", \"publish_product\", \"unpublish_product\"]).describe(\"Product operation to run.\"),\n  variables: z.record(z.string(), z.unknown()).describe(\"GraphQL variables for the selected operation. Examples: list_products accepts first/after/query/sortKey/reverse; create_product accepts input; update_product accepts input; set_product accepts input; variant/media/option operations accept the exact Shopify GraphQL mutation variables.\").optional(),\n  api_version: z.string().describe(\"Optional Shopify Admin API version override, for example 2026-04. Defaults to the API version in the connected account base_url when present; otherwise defaults to 2026-04.\").optional(),\n  raise_on_user_errors: z.boolean().default(true).describe(\"Raise on mutation userErrors.\").optional(),\n  raise_on_graphql_errors: z.boolean().default(true).describe(\"Raise on top-level GraphQL errors.\").optional(),\n}).describe(\"Run a first-class Shopify GraphQL product, variant, option, media, or publication operation.\\n\\nUse this action instead of legacy REST Product/Product Variant/Product Image actions. Shopify marks\\nREST product and product variant list/create/update/delete endpoints as deprecated as of REST API\\n2024-04. IDs should be GraphQL GIDs such as ``gid://shopify/Product/123``.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema: z.ZodTypeAny = z.object({\n  line: z.number().int().describe(\"One-indexed line number.\").nullable().optional(),\n  column: z.number().int().describe(\"One-indexed column number.\").nullable().optional(),\n}).describe(\"Location of a GraphQL parse, validation, or execution error.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema: z.ZodTypeAny = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Path to the failing response field, when available.\").nullable().optional(),\n  message: z.string().describe(\"Human-readable error message.\"),\n  locations: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema).describe(\"GraphQL document locations related to the error.\").nullable().optional(),\n  extensions: z.record(z.string(), z.unknown()).describe(\"Shopify-specific error metadata such as error code.\").nullable().optional(),\n}).describe(\"GraphQL error object returned by Shopify.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema: z.ZodTypeAny = z.object({\n  endCursor: z.string().describe(\"Cursor for the last edge.\").nullable().optional(),\n  hasNextPage: z.boolean().describe(\"Whether a next page exists.\").nullable().optional(),\n  startCursor: z.string().describe(\"Cursor for the first edge.\").nullable().optional(),\n  hasPreviousPage: z.boolean().describe(\"Whether a previous page exists.\").nullable().optional(),\n}).describe(\"Cursor pagination metadata for Shopify GraphQL connections.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema: z.ZodTypeAny = z.object({\n  code: z.string().describe(\"Machine-readable Shopify error code.\").nullable().optional(),\n  field: z.array(z.string()).describe(\"Input field path that caused the user error.\").nullable().optional(),\n  message: z.string().describe(\"Human-readable mutation error.\"),\n}).describe(\"Shopify mutation-level user error.\");\nexport const ShopifyGraphQlProductsOutput: z.ZodTypeAny = z.object({\n  data: z.record(z.string(), z.unknown()).describe(\"GraphQL data object returned by Shopify. Mutations can still include userErrors even when HTTP and GraphQL execution succeed.\").nullable().optional(),\n  errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema).describe(\"Top-level GraphQL errors, if Shopify returned any.\").nullable().optional(),\n  operation: z.string().describe(\"Canonical operation requested by the caller.\"),\n  page_info: ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema.nullable().optional(),\n  extensions: z.record(z.string(), z.unknown()).describe(\"GraphQL extensions, including Shopify query cost metadata.\").nullable().optional(),\n  user_errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema).describe(\"All nested Shopify userErrors extracted from mutation payloads.\").nullable().optional(),\n  migration_notes: z.array(z.string()).describe(\"Agent-facing notes for REST-to-GraphQL migration pitfalls.\").nullable().optional(),\n}).describe(\"Consistent response envelope for canonical Shopify GraphQL actions.\");\n\nexport const shopifyGraphQlProducts = action(\"SHOPIFY_GRAPH_QL_PRODUCTS\", {\n  slug: \"shopify-graph-ql-products\",\n  name: \"Shopify GraphQL products, variants, media, and publishing\",\n  description: \"GraphQL-first product toolkit: products, variants, options, media, and publications. This is the canonical agent-facing replacement for legacy REST product, product variant, and product image actions. It exposes Shopify's new product model in one consistent action, preserves cursor pagination metadata, extracts userErrors, and keeps the generic variables escape hatch for newly-added Shopify input fields without requiring a Mercury release.\",\n  input: ShopifyGraphQlProductsInput,\n  output: ShopifyGraphQlProductsOutput,\n});\n"],"mappings":"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"}
+{"version":3,"file":"graph-ql-products.mjs","names":[],"sources":["../../src/actions/graph-ql-products.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const ShopifyGraphQlProductsInput = z.object({\n  last: z.number().int().describe(\"Backward page size for list_products.\").optional(),\n  after: z.string().describe(\"Cursor after which to read products.\").optional(),\n  first: z.number().int().describe(\"Forward page size for list_products.\").optional(),\n  query: z.string().describe(\"Shopify product search query for list_products/count_products.\").optional(),\n  before: z.string().describe(\"Cursor before which to read products.\").optional(),\n  fields: z.string().describe(\"Optional node field selection for product read operations. Keep it valid GraphQL, for example: `id title handle status updatedAt variants(first: 10) { nodes { id title sku } }`.\").optional(),\n  reverse: z.boolean().describe(\"Reverse sort order.\").optional(),\n  sortKey: z.string().describe(\"Shopify ProductSortKeys value.\").optional(),\n  operation: z.enum([\"list_products\", \"get_product\", \"count_products\", \"create_product\", \"update_product\", \"set_product\", \"delete_product\", \"duplicate_product\", \"create_options\", \"update_option\", \"delete_options\", \"reorder_options\", \"bulk_create_variants\", \"bulk_update_variants\", \"bulk_delete_variants\", \"bulk_reorder_variants\", \"create_media\", \"update_media\", \"delete_media\", \"reorder_media\", \"attach_variant_media\", \"detach_variant_media\", \"publish_product\", \"unpublish_product\"]).describe(\"Product operation to run.\"),\n  variables: z.record(z.string(), z.unknown()).describe(\"GraphQL variables for the selected operation. Examples: list_products accepts first/after/query/sortKey/reverse; create_product accepts input; update_product accepts input; set_product accepts input; variant/media/option operations accept the exact Shopify GraphQL mutation variables.\").optional(),\n  api_version: z.string().describe(\"Optional Shopify Admin API version override, for example 2026-04. Defaults to the API version in the connected account base_url when present; otherwise defaults to 2026-04.\").optional(),\n  raise_on_user_errors: z.boolean().default(true).describe(\"Raise on mutation userErrors.\").optional(),\n  raise_on_graphql_errors: z.boolean().default(true).describe(\"Raise on top-level GraphQL errors.\").optional(),\n}).describe(\"Run a first-class Shopify GraphQL product, variant, option, media, or publication operation.\\n\\nUse this action instead of legacy REST Product/Product Variant/Product Image actions. Shopify marks\\nREST product and product variant list/create/update/delete endpoints as deprecated as of REST API\\n2024-04. IDs should be GraphQL GIDs such as ``gid://shopify/Product/123``.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema = z.object({\n  line: z.number().int().describe(\"One-indexed line number.\").nullable().optional(),\n  column: z.number().int().describe(\"One-indexed column number.\").nullable().optional(),\n}).passthrough().describe(\"Location of a GraphQL parse, validation, or execution error.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Path to the failing response field, when available.\").nullable().optional(),\n  message: z.string().describe(\"Human-readable error message.\").nullable(),\n  locations: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorLocationSchema).describe(\"GraphQL document locations related to the error.\").nullable().optional(),\n  extensions: z.record(z.string(), z.unknown()).describe(\"Shopify-specific error metadata such as error code.\").nullable().optional(),\n}).passthrough().describe(\"GraphQL error object returned by Shopify.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema = z.object({\n  endCursor: z.string().describe(\"Cursor for the last edge.\").nullable().optional(),\n  hasNextPage: z.boolean().describe(\"Whether a next page exists.\").nullable().optional(),\n  startCursor: z.string().describe(\"Cursor for the first edge.\").nullable().optional(),\n  hasPreviousPage: z.boolean().describe(\"Whether a previous page exists.\").nullable().optional(),\n}).passthrough().describe(\"Cursor pagination metadata for Shopify GraphQL connections.\");\nconst ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema = z.object({\n  code: z.string().describe(\"Machine-readable Shopify error code.\").nullable().optional(),\n  field: z.array(z.string()).describe(\"Input field path that caused the user error.\").nullable().optional(),\n  message: z.string().describe(\"Human-readable mutation error.\").nullable(),\n}).passthrough().describe(\"Shopify mutation-level user error.\");\nexport const ShopifyGraphQlProductsOutput = z.object({\n  data: z.record(z.string(), z.unknown()).describe(\"GraphQL data object returned by Shopify. Mutations can still include userErrors even when HTTP and GraphQL execution succeed.\").nullable().optional(),\n  errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLErrorSchema).describe(\"Top-level GraphQL errors, if Shopify returned any.\").nullable().optional(),\n  operation: z.string().describe(\"Canonical operation requested by the caller.\").nullable(),\n  page_info: ShopifyGraphQlProducts_ShopifyGraphQLPageInfoSchema.nullable().optional(),\n  extensions: z.record(z.string(), z.unknown()).describe(\"GraphQL extensions, including Shopify query cost metadata.\").nullable().optional(),\n  user_errors: z.array(ShopifyGraphQlProducts_ShopifyGraphQLUserErrorSchema).describe(\"All nested Shopify userErrors extracted from mutation payloads.\").nullable().optional(),\n  migration_notes: z.array(z.string()).describe(\"Agent-facing notes for REST-to-GraphQL migration pitfalls.\").nullable().optional(),\n}).passthrough().describe(\"Consistent response envelope for canonical Shopify GraphQL actions.\");\n\nexport const shopifyGraphQlProducts = action(\"SHOPIFY_GRAPH_QL_PRODUCTS\", {\n  slug: \"shopify-graph-ql-products\",\n  name: \"Shopify GraphQL products, variants, media, and publishing\",\n  description: \"GraphQL-first product toolkit: products, variants, options, media, and publications. This is the canonical agent-facing replacement for legacy REST product, product variant, and product image actions. It exposes Shopify's new product model in one consistent action, preserves cursor pagination metadata, extracts userErrors, and keeps the generic variables escape hatch for newly-added Shopify input fields without requiring a Mercury release.\",\n  input: ShopifyGraphQlProductsInput,\n  output: ShopifyGraphQlProductsOutput,\n});\n"],"mappings":";;;AAIA,MAAa,8BAA8B,EAAE,OAAO;CAClD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,uCAAuC,CAAC,CAAC,SAAS;CAClF,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,sCAAsC,CAAC,CAAC,SAAS;CAC5E,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,sCAAsC,CAAC,CAAC,SAAS;CAClF,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,gEAAgE,CAAC,CAAC,SAAS;CACtG,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,uCAAuC,CAAC,CAAC,SAAS;CAC9E,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,mLAAmL,CAAC,CAAC,SAAS;CAC1N,SAAS,EAAE,QAAQ,CAAC,CAAC,SAAS,qBAAqB,CAAC,CAAC,SAAS;CAC9D,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,gCAAgC,CAAC,CAAC,SAAS;CACxE,WAAW,EAAE,KAAK;EAAC;EAAiB;EAAe;EAAkB;EAAkB;EAAkB;EAAe;EAAkB;EAAqB;EAAkB;EAAiB;EAAkB;EAAmB;EAAwB;EAAwB;EAAwB;EAAyB;EAAgB;EAAgB;EAAgB;EAAiB;EAAwB;EAAwB;EAAmB;CAAmB,CAAC,CAAC,CAAC,SAAS,2BAA2B;CACtgB,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,8RAA8R,CAAC,CAAC,SAAS;CAC/V,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,8KAA8K,CAAC,CAAC,SAAS;CAC1N,sBAAsB,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,+BAA+B,CAAC,CAAC,SAAS;CACnG,yBAAyB,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,oCAAoC,CAAC,CAAC,SAAS;AAC7G,CAAC,CAAC,CAAC,SAAS,oXAAoX;AAChY,MAAM,2DAA2D,EAAE,OAAO;CACxE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,0BAA0B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAChF,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,4BAA4B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACtF,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,8DAA8D;AACxF,MAAM,mDAAmD,EAAE,OAAO;CAChE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,qDAAqD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC3I,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,+BAA+B,CAAC,CAAC,SAAS;CACvE,WAAW,EAAE,MAAM,wDAAwD,CAAC,CAAC,SAAS,kDAAkD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC9J,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,qDAAqD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACpI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,2CAA2C;AACrE,MAAM,sDAAsD,EAAE,OAAO;CACnE,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS,2BAA2B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAChF,aAAa,EAAE,QAAQ,CAAC,CAAC,SAAS,6BAA6B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACrF,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,4BAA4B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACnF,iBAAiB,EAAE,QAAQ,CAAC,CAAC,SAAS,iCAAiC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AAC/F,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,6DAA6D;AACvF,MAAM,uDAAuD,EAAE,OAAO;CACpE,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,sCAAsC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACtF,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,8CAA8C,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACxG,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,gCAAgC,CAAC,CAAC,SAAS;AAC1E,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,oCAAoC;AAW9D,MAAa,yBAAyB,OAAO,6BAA6B;CACxE,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAf0C,EAAE,OAAO;EACnD,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,+HAA+H,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EACtM,QAAQ,EAAE,MAAM,gDAAgD,CAAC,CAAC,SAAS,oDAAoD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EACrJ,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS,8CAA8C,CAAC,CAAC,SAAS;EACxF,WAAW,oDAAoD,SAAS,CAAC,CAAC,SAAS;EACnF,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,4DAA4D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EACzI,aAAa,EAAE,MAAM,oDAAoD,CAAC,CAAC,SAAS,iEAAiE,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EAC3K,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,4DAA4D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,qEAOhB;AACV,CAAC"}

package/dist/actions/graph-ql-query.cjs

@@ -6,51 +6,51 @@ const ShopifyGraphQlQueryInput = zod.z.object({
 	variables: zod.z.record(zod.z.string(), zod.z.unknown()).describe("Variables to be used in the GraphQL query as a dictionary. IDs use gid://shopify/Type/ID format; query legacyResourceId when a numeric ID is needed for interoperability with REST-based tools.").optional()
 });
 const ShopifyGraphQlQuery_ErrorLocationSchema = zod.z.object({
-	line: zod.z.number().int().describe("Line number in the GraphQL document (1-indexed)."),
-	column: zod.z.number().int().describe("Column number in the GraphQL document (1-indexed).")
-}).describe("Indicates where an error occurred in the GraphQL document.");
+	line: zod.z.number().int().describe("Line number in the GraphQL document (1-indexed).").nullable(),
+	column: zod.z.number().int().describe("Column number in the GraphQL document (1-indexed).").nullable()
+}).passthrough().describe("Indicates where an error occurred in the GraphQL document.");
 const ShopifyGraphQlQuery_ThrottleCostDetailSchema = zod.z.object({
 	windowResetAt: zod.z.string().describe("ISO 8601 timestamp when the rate limit window resets.").nullable().optional(),
-	maximumAvailable: zod.z.number().int().describe("Maximum query cost capacity available."),
-	currentlyAvailable: zod.z.number().int().describe("Remaining query cost capacity currently available."),
-	requestedQueryCost: zod.z.number().int().describe("The query cost that was requested.")
-}).describe("Detailed cost and rate limit information when a query is throttled.");
+	maximumAvailable: zod.z.number().int().describe("Maximum query cost capacity available.").nullable(),
+	currentlyAvailable: zod.z.number().int().describe("Remaining query cost capacity currently available.").nullable(),
+	requestedQueryCost: zod.z.number().int().describe("The query cost that was requested.").nullable()
+}).passthrough().describe("Detailed cost and rate limit information when a query is throttled.");
 const ShopifyGraphQlQuery_ErrorExtensionsSchema = zod.z.object({
 	code: zod.z.string().describe("Standardized Shopify error code identifying the error type (e.g., THROTTLED, ACCESS_DENIED, SHOP_INACTIVE, INTERNAL_SERVER_ERROR, MAX_COST_EXCEEDED).").nullable().optional(),
 	cost: ShopifyGraphQlQuery_ThrottleCostDetailSchema.nullable().optional(),
 	maxCost: zod.z.number().int().describe("The maximum allowed query cost. Present in MAX_COST_EXCEEDED error responses.").nullable().optional(),
 	requestId: zod.z.string().describe("Request identifier included with internal errors for support references.").nullable().optional(),
 	documentation: zod.z.string().describe("URL to official documentation explaining the error. Present in MAX_COST_EXCEEDED error responses.").nullable().optional()
-}).describe("Additional error metadata specific to Shopify's GraphQL implementation.");
+}).passthrough().describe("Additional error metadata specific to Shopify's GraphQL implementation.");
 const ShopifyGraphQlQuery_GraphQLErrorSchema = zod.z.object({
 	path: zod.z.array(zod.z.union([zod.z.string(), zod.z.number().int()])).describe("Response path array identifying the specific field that raised the error. Contains field names (strings) or list indices (0-indexed integers) from root to the error location.").nullable().optional(),
-	message: zod.z.string().describe("String description of the error intended for the developer as a guide to understand and correct the error."),
+	message: zod.z.string().describe("String description of the error intended for the developer as a guide to understand and correct the error.").nullable(),
 	locations: zod.z.array(ShopifyGraphQlQuery_ErrorLocationSchema).describe("List of locations in the GraphQL document where the error occurred. Each location contains line and column numbers (1-indexed).").nullable().optional(),
 	extensions: ShopifyGraphQlQuery_ErrorExtensionsSchema.nullable().optional()
-}).describe("Represents an error that occurred during GraphQL request processing or execution.");
+}).passthrough().describe("Represents an error that occurred during GraphQL request processing or execution.");
 const ShopifyGraphQlQuery_FieldCostDetailSchema = zod.z.object({
 	path: zod.z.array(zod.z.union([zod.z.string(), zod.z.number().int()])).describe("Array representing the field location in the query."),
-	definedCost: zod.z.number().int().describe("Base cost value assigned to this field."),
-	requestedTotalCost: zod.z.number().int().describe("Cumulative cost including this field and its children."),
-	requestedChildrenCost: zod.z.number().int().describe("Cost of nested selections under this field.")
-}).describe("Detailed cost breakdown for a specific field in the query.");
+	definedCost: zod.z.number().int().describe("Base cost value assigned to this field.").nullable(),
+	requestedTotalCost: zod.z.number().int().describe("Cumulative cost including this field and its children.").nullable(),
+	requestedChildrenCost: zod.z.number().int().describe("Cost of nested selections under this field.").nullable()
+}).passthrough().describe("Detailed cost breakdown for a specific field in the query.");
 const ShopifyGraphQlQuery_ThrottleStatusSchema = zod.z.object({
-	restoreRate: zod.z.number().describe("Points restored per second (typically 50.0 points/second)."),
-	maximumAvailable: zod.z.number().describe("Total capacity bucket size in points (typically 1000.0 points)."),
-	currentlyAvailable: zod.z.number().describe("Remaining capacity in points after this request.")
-}).describe("Rate limit information using the leaky bucket algorithm. Tracks available capacity and restore rate.");
+	restoreRate: zod.z.number().describe("Points restored per second (typically 50.0 points/second).").nullable(),
+	maximumAvailable: zod.z.number().describe("Total capacity bucket size in points (typically 1000.0 points).").nullable(),
+	currentlyAvailable: zod.z.number().describe("Remaining capacity in points after this request.").nullable()
+}).passthrough().describe("Rate limit information using the leaky bucket algorithm. Tracks available capacity and restore rate.");
 const ShopifyGraphQlQuery_CostInformationSchema = zod.z.object({
 	fields: zod.z.array(ShopifyGraphQlQuery_FieldCostDetailSchema).describe("Detailed per-field cost breakdown. Only present when the Shopify-GraphQL-Cost-Debug=1 header is included in the request.").nullable().optional(),
 	throttleStatus: ShopifyGraphQlQuery_ThrottleStatusSchema.nullable(),
 	actualQueryCost: zod.z.number().int().describe("The real cost incurred after the query executes, determined by actual results returned. Typically lower than requestedQueryCost since it reflects only what was truly fetched. Null when the request is throttled.").nullable().optional(),
-	requestedQueryCost: zod.z.number().int().describe("The anticipated cost of the query based on its composition before execution begins. Represents the maximum possible cost given the fields selected in the request. This value is used when checking if there is space in the rate limit bucket.")
-}).describe("Shopify-specific query cost tracking and rate limit information returned with every GraphQL response.");
-const ShopifyGraphQlQuery_ResponseExtensionsSchema = zod.z.object({ cost: ShopifyGraphQlQuery_CostInformationSchema.nullable().optional() }).describe("Map reserved for implementers to extend the protocol with additional metadata. Shopify uses this for query cost tracking and rate limit information.");
+	requestedQueryCost: zod.z.number().int().describe("The anticipated cost of the query based on its composition before execution begins. Represents the maximum possible cost given the fields selected in the request. This value is used when checking if there is space in the rate limit bucket.").nullable()
+}).passthrough().describe("Shopify-specific query cost tracking and rate limit information returned with every GraphQL response.");
+const ShopifyGraphQlQuery_ResponseExtensionsSchema = zod.z.object({ cost: ShopifyGraphQlQuery_CostInformationSchema.nullable().optional() }).passthrough().describe("Map reserved for implementers to extend the protocol with additional metadata. Shopify uses this for query cost tracking and rate limit information.");
 const ShopifyGraphQlQueryOutput = zod.z.object({
 	data: zod.z.record(zod.z.string(), zod.z.unknown()).describe("The result of executing the requested operation. Contains the hierarchical query result structured to mirror the GraphQL request. Null if errors occurred before execution began. May contain partial data if errors were raised during field resolution.").nullable().optional(),
 	errors: zod.z.array(ShopifyGraphQlQuery_GraphQLErrorSchema).describe("Non-empty list of errors encountered during request validation or execution. Omitted entirely if no errors occurred. Must be present if execution could not start.").nullable().optional(),
 	extensions: ShopifyGraphQlQuery_ResponseExtensionsSchema.nullable().optional()
-}).describe("Complete response schema for Shopify GraphQL Admin API queries following the GraphQL specification.");
+}).passthrough().describe("Complete response schema for Shopify GraphQL Admin API queries following the GraphQL specification.");
 const shopifyGraphQlQuery = require_action.action("SHOPIFY_GRAPH_QL_QUERY", {
 	slug: "shopify-graph-ql-query",
 	name: "Execute Shopify GraphQL query",

package/dist/actions/graph-ql-query.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-query.cjs","names":["z","action"],"sources":["../../src/actions/graph-ql-query.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const ShopifyGraphQlQueryInput: z.ZodTypeAny = z.object({\n  query: z.string().describe(\"The GraphQL query string to execute against the Shopify Admin API. Include pageInfo { hasNextPage endCursor } on all list fields; the first argument caps results and silently omits remaining records without pagination.\"),\n  variables: z.record(z.string(), z.unknown()).describe(\"Variables to be used in the GraphQL query as a dictionary. IDs use gid://shopify/Type/ID format; query legacyResourceId when a numeric ID is needed for interoperability with REST-based tools.\").optional(),\n});\nconst ShopifyGraphQlQuery_ErrorLocationSchema: z.ZodTypeAny = z.object({\n  line: z.number().int().describe(\"Line number in the GraphQL document (1-indexed).\"),\n  column: z.number().int().describe(\"Column number in the GraphQL document (1-indexed).\"),\n}).describe(\"Indicates where an error occurred in the GraphQL document.\");\nconst ShopifyGraphQlQuery_ThrottleCostDetailSchema: z.ZodTypeAny = z.object({\n  windowResetAt: z.string().describe(\"ISO 8601 timestamp when the rate limit window resets.\").nullable().optional(),\n  maximumAvailable: z.number().int().describe(\"Maximum query cost capacity available.\"),\n  currentlyAvailable: z.number().int().describe(\"Remaining query cost capacity currently available.\"),\n  requestedQueryCost: z.number().int().describe(\"The query cost that was requested.\"),\n}).describe(\"Detailed cost and rate limit information when a query is throttled.\");\nconst ShopifyGraphQlQuery_ErrorExtensionsSchema: z.ZodTypeAny = z.object({\n  code: z.string().describe(\"Standardized Shopify error code identifying the error type (e.g., THROTTLED, ACCESS_DENIED, SHOP_INACTIVE, INTERNAL_SERVER_ERROR, MAX_COST_EXCEEDED).\").nullable().optional(),\n  cost: ShopifyGraphQlQuery_ThrottleCostDetailSchema.nullable().optional(),\n  maxCost: z.number().int().describe(\"The maximum allowed query cost. Present in MAX_COST_EXCEEDED error responses.\").nullable().optional(),\n  requestId: z.string().describe(\"Request identifier included with internal errors for support references.\").nullable().optional(),\n  documentation: z.string().describe(\"URL to official documentation explaining the error. Present in MAX_COST_EXCEEDED error responses.\").nullable().optional(),\n}).describe(\"Additional error metadata specific to Shopify's GraphQL implementation.\");\nconst ShopifyGraphQlQuery_GraphQLErrorSchema: z.ZodTypeAny = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Response path array identifying the specific field that raised the error. Contains field names (strings) or list indices (0-indexed integers) from root to the error location.\").nullable().optional(),\n  message: z.string().describe(\"String description of the error intended for the developer as a guide to understand and correct the error.\"),\n  locations: z.array(ShopifyGraphQlQuery_ErrorLocationSchema).describe(\"List of locations in the GraphQL document where the error occurred. Each location contains line and column numbers (1-indexed).\").nullable().optional(),\n  extensions: ShopifyGraphQlQuery_ErrorExtensionsSchema.nullable().optional(),\n}).describe(\"Represents an error that occurred during GraphQL request processing or execution.\");\nconst ShopifyGraphQlQuery_FieldCostDetailSchema: z.ZodTypeAny = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Array representing the field location in the query.\"),\n  definedCost: z.number().int().describe(\"Base cost value assigned to this field.\"),\n  requestedTotalCost: z.number().int().describe(\"Cumulative cost including this field and its children.\"),\n  requestedChildrenCost: z.number().int().describe(\"Cost of nested selections under this field.\"),\n}).describe(\"Detailed cost breakdown for a specific field in the query.\");\nconst ShopifyGraphQlQuery_ThrottleStatusSchema: z.ZodTypeAny = z.object({\n  restoreRate: z.number().describe(\"Points restored per second (typically 50.0 points/second).\"),\n  maximumAvailable: z.number().describe(\"Total capacity bucket size in points (typically 1000.0 points).\"),\n  currentlyAvailable: z.number().describe(\"Remaining capacity in points after this request.\"),\n}).describe(\"Rate limit information using the leaky bucket algorithm. Tracks available capacity and restore rate.\");\nconst ShopifyGraphQlQuery_CostInformationSchema: z.ZodTypeAny = z.object({\n  fields: z.array(ShopifyGraphQlQuery_FieldCostDetailSchema).describe(\"Detailed per-field cost breakdown. Only present when the Shopify-GraphQL-Cost-Debug=1 header is included in the request.\").nullable().optional(),\n  throttleStatus: ShopifyGraphQlQuery_ThrottleStatusSchema.nullable(),\n  actualQueryCost: z.number().int().describe(\"The real cost incurred after the query executes, determined by actual results returned. Typically lower than requestedQueryCost since it reflects only what was truly fetched. Null when the request is throttled.\").nullable().optional(),\n  requestedQueryCost: z.number().int().describe(\"The anticipated cost of the query based on its composition before execution begins. Represents the maximum possible cost given the fields selected in the request. This value is used when checking if there is space in the rate limit bucket.\"),\n}).describe(\"Shopify-specific query cost tracking and rate limit information returned with every GraphQL response.\");\nconst ShopifyGraphQlQuery_ResponseExtensionsSchema: z.ZodTypeAny = z.object({\n  cost: ShopifyGraphQlQuery_CostInformationSchema.nullable().optional(),\n}).describe(\"Map reserved for implementers to extend the protocol with additional metadata. Shopify uses this for query cost tracking and rate limit information.\");\nexport const ShopifyGraphQlQueryOutput: z.ZodTypeAny = z.object({\n  data: z.record(z.string(), z.unknown()).describe(\"The result of executing the requested operation. Contains the hierarchical query result structured to mirror the GraphQL request. Null if errors occurred before execution began. May contain partial data if errors were raised during field resolution.\").nullable().optional(),\n  errors: z.array(ShopifyGraphQlQuery_GraphQLErrorSchema).describe(\"Non-empty list of errors encountered during request validation or execution. Omitted entirely if no errors occurred. Must be present if execution could not start.\").nullable().optional(),\n  extensions: ShopifyGraphQlQuery_ResponseExtensionsSchema.nullable().optional(),\n}).describe(\"Complete response schema for Shopify GraphQL Admin API queries following the GraphQL specification.\");\n\nexport const shopifyGraphQlQuery = action(\"SHOPIFY_GRAPH_QL_QUERY\", {\n  slug: \"shopify-graph-ql-query\",\n  name: \"Execute Shopify GraphQL query\",\n  description: \"Executes a GraphQL query against the Shopify Admin API for flexible data retrieval and mutations including metafields. Response data is nested under result['data']['data'], not result['data']. Always inspect both response_data.errors (top-level) and mutation-level userErrors—HTTP 200 can accompany GraphQL validation failures. Query costs draw from a ~1000-point bucket (~50 points/second refill); monitor extensions.cost.throttleStatus to avoid THROTTLED errors. Paginate list queries using pageInfo.hasNextPage and endCursor to avoid silently missing records. productUpdate replaces the entire tags array—send the complete final tag list. refundCreate requires orderId at both the top level and inside each transactions element. transaction parentId must reference a CAPTURE-kind transaction. Numeric fields like numberOfOrders may be returned as strings—cast before aggregating.\",\n  input: ShopifyGraphQlQueryInput,\n  output: ShopifyGraphQlQueryOutput,\n});\n"],"mappings":"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"}
+{"version":3,"file":"graph-ql-query.cjs","names":["z","action"],"sources":["../../src/actions/graph-ql-query.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const ShopifyGraphQlQueryInput = z.object({\n  query: z.string().describe(\"The GraphQL query string to execute against the Shopify Admin API. Include pageInfo { hasNextPage endCursor } on all list fields; the first argument caps results and silently omits remaining records without pagination.\"),\n  variables: z.record(z.string(), z.unknown()).describe(\"Variables to be used in the GraphQL query as a dictionary. IDs use gid://shopify/Type/ID format; query legacyResourceId when a numeric ID is needed for interoperability with REST-based tools.\").optional(),\n});\nconst ShopifyGraphQlQuery_ErrorLocationSchema = z.object({\n  line: z.number().int().describe(\"Line number in the GraphQL document (1-indexed).\").nullable(),\n  column: z.number().int().describe(\"Column number in the GraphQL document (1-indexed).\").nullable(),\n}).passthrough().describe(\"Indicates where an error occurred in the GraphQL document.\");\nconst ShopifyGraphQlQuery_ThrottleCostDetailSchema = z.object({\n  windowResetAt: z.string().describe(\"ISO 8601 timestamp when the rate limit window resets.\").nullable().optional(),\n  maximumAvailable: z.number().int().describe(\"Maximum query cost capacity available.\").nullable(),\n  currentlyAvailable: z.number().int().describe(\"Remaining query cost capacity currently available.\").nullable(),\n  requestedQueryCost: z.number().int().describe(\"The query cost that was requested.\").nullable(),\n}).passthrough().describe(\"Detailed cost and rate limit information when a query is throttled.\");\nconst ShopifyGraphQlQuery_ErrorExtensionsSchema = z.object({\n  code: z.string().describe(\"Standardized Shopify error code identifying the error type (e.g., THROTTLED, ACCESS_DENIED, SHOP_INACTIVE, INTERNAL_SERVER_ERROR, MAX_COST_EXCEEDED).\").nullable().optional(),\n  cost: ShopifyGraphQlQuery_ThrottleCostDetailSchema.nullable().optional(),\n  maxCost: z.number().int().describe(\"The maximum allowed query cost. Present in MAX_COST_EXCEEDED error responses.\").nullable().optional(),\n  requestId: z.string().describe(\"Request identifier included with internal errors for support references.\").nullable().optional(),\n  documentation: z.string().describe(\"URL to official documentation explaining the error. Present in MAX_COST_EXCEEDED error responses.\").nullable().optional(),\n}).passthrough().describe(\"Additional error metadata specific to Shopify's GraphQL implementation.\");\nconst ShopifyGraphQlQuery_GraphQLErrorSchema = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Response path array identifying the specific field that raised the error. Contains field names (strings) or list indices (0-indexed integers) from root to the error location.\").nullable().optional(),\n  message: z.string().describe(\"String description of the error intended for the developer as a guide to understand and correct the error.\").nullable(),\n  locations: z.array(ShopifyGraphQlQuery_ErrorLocationSchema).describe(\"List of locations in the GraphQL document where the error occurred. Each location contains line and column numbers (1-indexed).\").nullable().optional(),\n  extensions: ShopifyGraphQlQuery_ErrorExtensionsSchema.nullable().optional(),\n}).passthrough().describe(\"Represents an error that occurred during GraphQL request processing or execution.\");\nconst ShopifyGraphQlQuery_FieldCostDetailSchema = z.object({\n  path: z.array(z.union([z.string(), z.number().int()])).describe(\"Array representing the field location in the query.\"),\n  definedCost: z.number().int().describe(\"Base cost value assigned to this field.\").nullable(),\n  requestedTotalCost: z.number().int().describe(\"Cumulative cost including this field and its children.\").nullable(),\n  requestedChildrenCost: z.number().int().describe(\"Cost of nested selections under this field.\").nullable(),\n}).passthrough().describe(\"Detailed cost breakdown for a specific field in the query.\");\nconst ShopifyGraphQlQuery_ThrottleStatusSchema = z.object({\n  restoreRate: z.number().describe(\"Points restored per second (typically 50.0 points/second).\").nullable(),\n  maximumAvailable: z.number().describe(\"Total capacity bucket size in points (typically 1000.0 points).\").nullable(),\n  currentlyAvailable: z.number().describe(\"Remaining capacity in points after this request.\").nullable(),\n}).passthrough().describe(\"Rate limit information using the leaky bucket algorithm. Tracks available capacity and restore rate.\");\nconst ShopifyGraphQlQuery_CostInformationSchema = z.object({\n  fields: z.array(ShopifyGraphQlQuery_FieldCostDetailSchema).describe(\"Detailed per-field cost breakdown. Only present when the Shopify-GraphQL-Cost-Debug=1 header is included in the request.\").nullable().optional(),\n  throttleStatus: ShopifyGraphQlQuery_ThrottleStatusSchema.nullable(),\n  actualQueryCost: z.number().int().describe(\"The real cost incurred after the query executes, determined by actual results returned. Typically lower than requestedQueryCost since it reflects only what was truly fetched. Null when the request is throttled.\").nullable().optional(),\n  requestedQueryCost: z.number().int().describe(\"The anticipated cost of the query based on its composition before execution begins. Represents the maximum possible cost given the fields selected in the request. This value is used when checking if there is space in the rate limit bucket.\").nullable(),\n}).passthrough().describe(\"Shopify-specific query cost tracking and rate limit information returned with every GraphQL response.\");\nconst ShopifyGraphQlQuery_ResponseExtensionsSchema = z.object({\n  cost: ShopifyGraphQlQuery_CostInformationSchema.nullable().optional(),\n}).passthrough().describe(\"Map reserved for implementers to extend the protocol with additional metadata. Shopify uses this for query cost tracking and rate limit information.\");\nexport const ShopifyGraphQlQueryOutput = z.object({\n  data: z.record(z.string(), z.unknown()).describe(\"The result of executing the requested operation. Contains the hierarchical query result structured to mirror the GraphQL request. Null if errors occurred before execution began. May contain partial data if errors were raised during field resolution.\").nullable().optional(),\n  errors: z.array(ShopifyGraphQlQuery_GraphQLErrorSchema).describe(\"Non-empty list of errors encountered during request validation or execution. Omitted entirely if no errors occurred. Must be present if execution could not start.\").nullable().optional(),\n  extensions: ShopifyGraphQlQuery_ResponseExtensionsSchema.nullable().optional(),\n}).passthrough().describe(\"Complete response schema for Shopify GraphQL Admin API queries following the GraphQL specification.\");\n\nexport const shopifyGraphQlQuery = action(\"SHOPIFY_GRAPH_QL_QUERY\", {\n  slug: \"shopify-graph-ql-query\",\n  name: \"Execute Shopify GraphQL query\",\n  description: \"Executes a GraphQL query against the Shopify Admin API for flexible data retrieval and mutations including metafields. Response data is nested under result['data']['data'], not result['data']. Always inspect both response_data.errors (top-level) and mutation-level userErrors—HTTP 200 can accompany GraphQL validation failures. Query costs draw from a ~1000-point bucket (~50 points/second refill); monitor extensions.cost.throttleStatus to avoid THROTTLED errors. Paginate list queries using pageInfo.hasNextPage and endCursor to avoid silently missing records. productUpdate replaces the entire tags array—send the complete final tag list. refundCreate requires orderId at both the top level and inside each transactions element. transaction parentId must reference a CAPTURE-kind transaction. Numeric fields like numberOfOrders may be returned as strings—cast before aggregating.\",\n  input: ShopifyGraphQlQueryInput,\n  output: ShopifyGraphQlQueryOutput,\n});\n"],"mappings":"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"}

package/dist/actions/graph-ql-query.d.cts

@@ -1,9 +1,54 @@
 import { z } from "zod";
 
 //#region src/actions/graph-ql-query.d.ts
-declare const ShopifyGraphQlQueryInput: z.ZodTypeAny;
-declare const ShopifyGraphQlQueryOutput: z.ZodTypeAny;
-declare const shopifyGraphQlQuery: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+declare const ShopifyGraphQlQueryInput: z.ZodObject<{
+  query: z.ZodString;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const ShopifyGraphQlQueryOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    path: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    message: z.ZodNullable<z.ZodString>;
+    locations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      line: z.ZodNullable<z.ZodNumber>;
+      column: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>>>>;
+    extensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      cost: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        windowResetAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maximumAvailable: z.ZodNullable<z.ZodNumber>;
+        currentlyAvailable: z.ZodNullable<z.ZodNumber>;
+        requestedQueryCost: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>>;
+      maxCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      documentation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>>;
+  extensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    cost: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        definedCost: z.ZodNullable<z.ZodNumber>;
+        requestedTotalCost: z.ZodNullable<z.ZodNumber>;
+        requestedChildrenCost: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>>>;
+      throttleStatus: z.ZodNullable<z.ZodObject<{
+        restoreRate: z.ZodNullable<z.ZodNumber>;
+        maximumAvailable: z.ZodNullable<z.ZodNumber>;
+        currentlyAvailable: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>;
+      actualQueryCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requestedQueryCost: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const shopifyGraphQlQuery: import("@keystrokehq/action").WorkflowActionDefinition<{
+  query: string;
+  variables?: Record<string, unknown> | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
 //#endregion
 export { shopifyGraphQlQuery };
 //# sourceMappingURL=graph-ql-query.d.cts.map

package/dist/actions/graph-ql-query.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-query.d.cts","names":[],"sources":["../../src/actions/graph-ql-query.ts"],"mappings":";;;cAIa,wBAAA,EAA0B,CAAA,CAAE,UAGvC;AAAA,cA4CW,yBAAA,EAA2B,CAAA,CAAE,UAIwE;AAAA,cAErG,mBAAA,gCAAmB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}
+{"version":3,"file":"graph-ql-query.d.cts","names":[],"sources":["../../src/actions/graph-ql-query.ts"],"mappings":";;;cAIa,wBAAA,EAAwB,CAAA,CAAA,SAAA;;;;cA+CxB,yBAAA,EAAyB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAMzB,mBAAA,gCAAmB,wBAAA;;cAM9B,MAAA;AAAA"}

package/dist/actions/graph-ql-query.d.mts

@@ -1,9 +1,54 @@
 import { z } from "zod";
 
 //#region src/actions/graph-ql-query.d.ts
-declare const ShopifyGraphQlQueryInput: z.ZodTypeAny;
-declare const ShopifyGraphQlQueryOutput: z.ZodTypeAny;
-declare const shopifyGraphQlQuery: import("@keystrokehq/action").WorkflowActionDefinition<unknown, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+declare const ShopifyGraphQlQueryInput: z.ZodObject<{
+  query: z.ZodString;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const ShopifyGraphQlQueryOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  errors: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    path: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    message: z.ZodNullable<z.ZodString>;
+    locations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      line: z.ZodNullable<z.ZodNumber>;
+      column: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>>>>;
+    extensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      cost: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        windowResetAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maximumAvailable: z.ZodNullable<z.ZodNumber>;
+        currentlyAvailable: z.ZodNullable<z.ZodNumber>;
+        requestedQueryCost: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>>;
+      maxCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      documentation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>>;
+  extensions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    cost: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        definedCost: z.ZodNullable<z.ZodNumber>;
+        requestedTotalCost: z.ZodNullable<z.ZodNumber>;
+        requestedChildrenCost: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>>>;
+      throttleStatus: z.ZodNullable<z.ZodObject<{
+        restoreRate: z.ZodNullable<z.ZodNumber>;
+        maximumAvailable: z.ZodNullable<z.ZodNumber>;
+        currentlyAvailable: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$loose>>;
+      actualQueryCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requestedQueryCost: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const shopifyGraphQlQuery: import("@keystrokehq/action").WorkflowActionDefinition<{
+  query: string;
+  variables?: Record<string, unknown> | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
 //#endregion
 export { shopifyGraphQlQuery };
 //# sourceMappingURL=graph-ql-query.d.mts.map

package/dist/actions/graph-ql-query.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ql-query.d.mts","names":[],"sources":["../../src/actions/graph-ql-query.ts"],"mappings":";;;cAIa,wBAAA,EAA0B,CAAA,CAAE,UAGvC;AAAA,cA4CW,yBAAA,EAA2B,CAAA,CAAE,UAIwE;AAAA,cAErG,mBAAA,gCAAmB,wBAAA,iDAAA,mBAAA,yCAAA,UAAA,4CAAA,UAAA"}
+{"version":3,"file":"graph-ql-query.d.mts","names":[],"sources":["../../src/actions/graph-ql-query.ts"],"mappings":";;;cAIa,wBAAA,EAAwB,CAAA,CAAA,SAAA;;;;cA+CxB,yBAAA,EAAyB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAMzB,mBAAA,gCAAmB,wBAAA;;cAM9B,MAAA;AAAA"}