shop-cli 0.1.3 → 0.1.4

package/README.md

@@ -137,7 +137,7 @@ shop products list --select seo.title --select seo.description
 Include connections when using `--view all`:
 
 ```bash
-shop products get --id 123 --view all --include variants --include images
+shop products get --id gid://shopify/Product/123 --view all --include variants --include images
 ```
 
 Override selection entirely with raw GraphQL:
@@ -155,7 +155,7 @@ With `--select`, use the `on_TypeName` prefix:
 
 ```bash
 # Select apps from an AppCatalog via publications
-shop products get --id 123 --include resourcePublicationsV2 \
+shop products get --id gid://shopify/Product/123 --include resourcePublicationsV2 \
   --select resourcePublicationsV2.nodes.publication.catalog.on_AppCatalog.apps.nodes.title
 ```
 
@@ -204,6 +204,7 @@ shop products list --quiet
 | `--set-json`  | Set a field value as JSON (repeatable)   |
 | `--tags`      | Comma-separated tags                     |
 | `--dry-run`   | Print GraphQL operation without executing |
+| `--strict-ids` | Require full `gid://shopify/...` IDs (or env `SHOP_CLI_STRICT_IDS=1`) |
 
 ## Raw GraphQL
 
@@ -229,23 +230,23 @@ shop products list --first 5
 shop products list --published
 
 # Get a specific product
-shop products get --id 123
+shop products get --id gid://shopify/Product/123
 
 # Create a product
 shop products create --set title="My Product" --set status="ACTIVE"
 
 # Update a product
-shop products update --id 123 --set title="Updated Title"
+shop products update --id gid://shopify/Product/123 --set title="Updated Title"
 
 # Add tags to a product
-shop products add-tags --id 123 --tags "summer,featured"
+shop products add-tags --id gid://shopify/Product/123 --tags "summer,featured"
 
 # Publish to a sales channel
 shop publications resolve --publication "Online Store"
-shop products publish --id 123 --publication "Online Store" --now
+shop products publish --id gid://shopify/Product/123 --publication "Online Store" --now
 
 # Work with metafields
-shop products metafields upsert --id 123 \
+shop products metafields upsert --id gid://shopify/Product/123 \
   --set namespace=custom \
   --set key=foo \
   --set type=single_line_text_field \

package/dist/cli/gid.d.ts

@@ -1,3 +1,14 @@
-export type ShopifyGidType = 'AbandonedCheckout' | 'Abandonment' | 'AndroidApplication' | 'App' | 'Metafield' | 'Job' | 'Product' | 'ProductOption' | 'ProductOptionValue' | 'ProductFeed' | 'ProductVariant' | 'Collection' | 'Customer' | 'CustomerPaymentMethod' | 'CustomerSegmentMembersQuery' | 'StaffMember' | 'Order' | 'OrderTransaction' | 'CalculatedOrder' | 'CalculatedLineItem' | 'CalculatedDiscountApplication' | 'CalculatedShippingLine' | 'AppInstallation' | 'AppSubscription' | 'DiscountAutomaticNode' | 'DiscountCodeNode' | 'DiscountNode' | 'DiscountRedeemCode' | 'DiscountRedeemCodeBulkCreation' | 'InventoryItem' | 'InventoryLevel' | 'InventoryShipment' | 'InventoryTransfer' | 'InventoryTransferLineItem' | 'Location' | 'FulfillmentOrder' | 'Fulfillment' | 'FulfillmentHold' | 'FulfillmentService' | 'FulfillmentConstraintRule' | 'GiftCard' | 'Return' | 'ReturnLineItem' | 'ReturnReasonDefinition' | 'ReturnableFulfillment' | 'DeliveryProfile' | 'DeliveryCustomization' | 'DeliveryCarrierService' | 'File' | 'PaymentTerms' | 'PaymentTermsTemplate' | 'PaymentSchedule' | 'PaymentMandate' | 'PaymentCustomization' | 'PriceList' | 'Publication' | 'Refund' | 'Article' | 'Blog' | 'Page' | 'Comment' | 'Event' | 'Menu' | 'Channel' | 'Catalog' | 'Market' | 'MarketRegionCountry' | 'MarketWebPresence' | 'BusinessEntity' | 'Company' | 'CompanyAddress' | 'CompanyContact' | 'CompanyContactRole' | 'CompanyContactRoleAssignment' | 'CompanyLocation' | 'CompanyLocationStaffMemberAssignment' | 'StoreCreditAccount' | 'StorefrontAccessToken' | 'DraftOrder' | 'DraftOrderTag' | 'BulkOperation' | 'UrlRedirect' | 'UrlRedirectImport' | 'Segment' | 'SavedSearch' | 'ScriptTag' | 'CartTransform' | 'Validation' | 'OnlineStoreTheme' | 'CheckoutProfile' | 'WebPixel' | 'ServerPixel' | 'MarketingActivity' | 'MarketingEvent' | 'WebhookSubscription' | 'Domain' | 'MetafieldDefinition' | 'Metaobject' | 'MetaobjectDefinition' | 'Shop' | 'MarketWebPresence' | 'SellingPlanGroup' | 'ShippingPackage' | 'ShopifyPaymentsDispute' | 'ShopifyPaymentsDisputeEvidence' | 'SubscriptionContract' | 'SubscriptionDraft' | 'SubscriptionLine' | 'SubscriptionManualDiscount' | 'SubscriptionBillingAttempt' | 'AppleApplication' | 'CashTrackingSession' | 'PointOfSaleDevice' | 'CustomerAccountPage' | 'FlowActionDefinition' | 'MailingAddress';
+export type ShopifyGidType = 'AbandonedCheckout' | 'Abandonment' | 'AndroidApplication' | 'App' | 'Metafield' | 'Job' | 'Product' | 'ProductOption' | 'ProductOptionValue' | 'ProductFeed' | 'ProductVariant' | 'Collection' | 'Customer' | 'CustomerPaymentMethod' | 'CustomerSegmentMembersQuery' | 'StaffMember' | 'Order' | 'OrderTransaction' | 'CalculatedOrder' | 'CalculatedLineItem' | 'CalculatedDiscountApplication' | 'CalculatedShippingLine' | 'AppInstallation' | 'AppSubscription' | 'DiscountAutomaticNode' | 'DiscountCodeNode' | 'DiscountNode' | 'DiscountRedeemCode' | 'DiscountRedeemCodeBulkCreation' | 'InventoryItem' | 'InventoryLevel' | 'InventoryShipment' | 'InventoryTransfer' | 'InventoryTransferLineItem' | 'Location' | 'FulfillmentOrder' | 'Fulfillment' | 'FulfillmentHold' | 'FulfillmentService' | 'FulfillmentConstraintRule' | 'GiftCard' | 'Return' | 'ReturnLineItem' | 'ReturnReasonDefinition' | 'ReturnableFulfillment' | 'DeliveryProfile' | 'DeliveryCustomization' | 'DeliveryCarrierService' | 'File' | 'PaymentTerms' | 'PaymentTermsTemplate' | 'PaymentSchedule' | 'PaymentMandate' | 'PaymentCustomization' | 'PriceList' | 'Publication' | 'Refund' | 'Article' | 'Blog' | 'Page' | 'Comment' | 'Event' | 'Menu' | 'Channel' | 'Catalog' | 'Market' | 'MarketRegionCountry' | 'MarketWebPresence' | 'BusinessEntity' | 'Company' | 'CompanyAddress' | 'CompanyContact' | 'CompanyContactRole' | 'CompanyContactRoleAssignment' | 'CompanyLocation' | 'CompanyLocationStaffMemberAssignment' | 'StoreCreditAccount' | 'StorefrontAccessToken' | 'DraftOrder' | 'DraftOrderTag' | 'BulkOperation' | 'UrlRedirect' | 'UrlRedirectImport' | 'Segment' | 'SavedSearch' | 'ScriptTag' | 'CartTransform' | 'Validation' | 'OnlineStoreTheme' | 'CheckoutProfile' | 'WebPixel' | 'ServerPixel' | 'MarketingActivity' | 'MarketingEvent' | 'WebhookSubscription' | 'Domain' | 'ExternalVideo' | 'MediaImage' | 'Model3d' | 'MetafieldDefinition' | 'Metaobject' | 'MetaobjectDefinition' | 'Shop' | 'MarketWebPresence' | 'SellingPlanGroup' | 'ShippingPackage' | 'ShopifyPaymentsDispute' | 'ShopifyPaymentsDisputeEvidence' | 'SubscriptionContract' | 'SubscriptionDraft' | 'SubscriptionLine' | 'SubscriptionManualDiscount' | 'SubscriptionBillingAttempt' | 'Video' | 'AppleApplication' | 'CashTrackingSession' | 'PointOfSaleDevice' | 'CustomerAccountPage' | 'FlowActionDefinition' | 'MailingAddress';
 export declare const isGid: (value: string) => boolean;
-export declare const coerceGid: (value: string, type: ShopifyGidType) => string;
+export declare const parseEnvBoolean: (value: string | undefined) => boolean;
+export declare const setStrictIdsMode: (enabled: boolean) => void;
+export declare const isStrictIdsMode: () => boolean;
+export declare const parseShopifyGid: (value: string) => {
+    raw: string;
+    type: string;
+    id: string;
+};
+export declare const getShopifyGidType: (value: string) => string;
+export declare const assertShopifyGidType: (value: string, expectedType: ShopifyGidType, label?: string) => string;
+export declare const assertShopifyGidTypeIn: (value: string, allowedTypes: readonly ShopifyGidType[], label?: string) => string;
+export declare const coerceGid: (value: string, type: ShopifyGidType, label?: string) => string;

package/dist/cli/gid.js

@@ -18,25 +18,93 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var gid_exports = {};
 __export(gid_exports, {
+  assertShopifyGidType: () => assertShopifyGidType,
+  assertShopifyGidTypeIn: () => assertShopifyGidTypeIn,
   coerceGid: () => coerceGid,
-  isGid: () => isGid
+  getShopifyGidType: () => getShopifyGidType,
+  isGid: () => isGid,
+  isStrictIdsMode: () => isStrictIdsMode,
+  parseEnvBoolean: () => parseEnvBoolean,
+  parseShopifyGid: () => parseShopifyGid,
+  setStrictIdsMode: () => setStrictIdsMode
 });
 module.exports = __toCommonJS(gid_exports);
 var import_errors = require("./errors");
-const isGid = (value) => value.startsWith("gid://");
-const coerceGid = (value, type) => {
-  if (isGid(value)) return value;
-  if (!/^\d+$/.test(value)) {
+const isGid = (value) => value.trim().startsWith("gid://");
+const parseEnvBoolean = (value) => {
+  if (value === void 0) return false;
+  const v = value.trim().toLowerCase();
+  if (v === "") return true;
+  if (v === "1" || v === "true" || v === "yes" || v === "y" || v === "on") return true;
+  if (v === "0" || v === "false" || v === "no" || v === "n" || v === "off") return false;
+  return true;
+};
+let strictIdsMode = parseEnvBoolean(process.env.SHOP_CLI_STRICT_IDS);
+const setStrictIdsMode = (enabled) => {
+  strictIdsMode = enabled;
+};
+const isStrictIdsMode = () => strictIdsMode;
+const parseShopifyGid = (value) => {
+  const raw = value.trim();
+  if (!raw.startsWith("gid://")) throw new import_errors.CliError(`Invalid Shopify GID: ${value}`, 2);
+  const parts = raw.split("/");
+  const scheme = parts[0];
+  const host = parts[2];
+  const type = parts[3];
+  const id = parts.slice(4).join("/");
+  if (scheme !== "gid:" || host !== "shopify" || !type || !id) {
+    throw new import_errors.CliError(`Invalid Shopify GID: ${value}`, 2);
+  }
+  return { raw, type, id };
+};
+const getShopifyGidType = (value) => parseShopifyGid(value).type;
+const assertShopifyGidType = (value, expectedType, label = "GID") => {
+  const parsed = parseShopifyGid(value);
+  if (parsed.type !== expectedType) {
+    throw new import_errors.CliError(
+      `${label} must be a Shopify GID of type ${expectedType}. Got type ${parsed.type}: ${parsed.raw}`,
+      2
+    );
+  }
+  return parsed.raw;
+};
+const assertShopifyGidTypeIn = (value, allowedTypes, label = "GID") => {
+  const parsed = parseShopifyGid(value);
+  if (!allowedTypes.includes(parsed.type)) {
+    throw new import_errors.CliError(
+      `${label} must be a Shopify GID of type one of ${allowedTypes.join(", ")}. Got type ${parsed.type}: ${parsed.raw}`,
+      2
+    );
+  }
+  return parsed.raw;
+};
+const coerceGid = (value, type, label = `ID for ${type}`) => {
+  const raw = value.trim();
+  if (isGid(raw)) return assertShopifyGidType(raw, type, label);
+  if (isStrictIdsMode()) {
+    throw new import_errors.CliError(
+      `${label} must be a full Shopify GID of type ${type} (gid://shopify/${type}/...). Strict IDs mode is enabled (SHOP_CLI_STRICT_IDS or --strict-ids). Got: ${value}`,
+      2
+    );
+  }
+  if (!/^\d+$/.test(raw)) {
     throw new import_errors.CliError(
       `Expected a numeric ID or full GID for ${type}. Got: ${value}`,
       2
     );
   }
-  return `gid://shopify/${type}/${value}`;
+  return `gid://shopify/${type}/${raw}`;
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  assertShopifyGidType,
+  assertShopifyGidTypeIn,
   coerceGid,
-  isGid
+  getShopifyGidType,
+  isGid,
+  isStrictIdsMode,
+  parseEnvBoolean,
+  parseShopifyGid,
+  setStrictIdsMode
 });
 //# sourceMappingURL=gid.js.map

package/dist/cli/globalFlags.d.ts

@@ -7,6 +7,7 @@ export type GlobalParsed = {
     format?: string;
     quiet?: boolean;
     dryRun?: boolean;
+    strictIds?: boolean;
     noFailOnUserErrors?: boolean;
     view?: string;
     headers: string[];

package/dist/cli/globalFlags.js

@@ -76,6 +76,10 @@ const parseGlobalFlags = (args) => {
       parsed.dryRun = true;
       continue;
     }
+    if (flag === "--strict-ids") {
+      parsed.strictIds = true;
+      continue;
+    }
     if (flag === "--no-fail-on-user-errors") {
       parsed.noFailOnUserErrors = true;
       continue;