@shopify/cli-kit 4.3.0 → 4.5.0

package/dist/public/node/api/bulk-operations/stage-file.js

@@ -0,0 +1,89 @@
+import { StagedUploadsCreate, } from '../../../../cli/api/graphql/bulk-operations/generated/staged-uploads-create.js';
+import { adminRequestDoc } from '../admin.js';
+import { fetch } from '../../http.js';
+import { AbortError } from '../../error.js';
+import { outputContent } from '../../output.js';
+import { renderSingleTask } from '../../ui.js';
+/**
+ * Uploads bulk mutation variables to a staged upload target and returns the staged upload key.
+ *
+ * @param options - The admin session and JSONL variables.
+ * @returns The staged upload key used as `stagedUploadPath` for the bulk mutation.
+ */
+export async function stageFile(options) {
+    const { adminSession, variablesJsonl } = options;
+    const buffer = Buffer.from(variablesJsonl ?? '', 'utf-8');
+    const filename = 'bulk-variables.jsonl';
+    const size = buffer.length;
+    const response = await requestStagedUpload(adminSession, filename, size);
+    const target = validateStagedUploadResponse(response);
+    await uploadFileToStagedUrl(buffer, target.url, target.parameters, filename);
+    return target.stagedUploadKey;
+}
+async function requestStagedUpload(adminSession, filename, size) {
+    return adminRequestDoc({
+        query: StagedUploadsCreate,
+        session: adminSession,
+        variables: {
+            input: [
+                {
+                    filename,
+                    fileSize: size.toString(),
+                    httpMethod: 'POST',
+                    mimeType: 'text/jsonl',
+                    resource: 'BULK_MUTATION_VARIABLES',
+                },
+            ],
+        },
+    });
+}
+function validateStagedUploadResponse(response) {
+    if (!response.stagedUploadsCreate) {
+        throw new AbortError('No response received from stagedUploadsCreate mutation');
+    }
+    if (response.stagedUploadsCreate.userErrors.length > 0) {
+        const errors = response.stagedUploadsCreate.userErrors
+            .map((error) => error.message)
+            .join(', ');
+        throw new AbortError(`Failed to create staged upload: ${errors}`);
+    }
+    const target = response.stagedUploadsCreate.stagedTargets?.[0];
+    if (!target) {
+        throw new AbortError('No staged upload target returned from Shopify');
+    }
+    if (!target.url || !target.resourceUrl) {
+        throw new AbortError('Invalid staged upload target: missing required URLs');
+    }
+    const stagedUploadKey = target.parameters.find((param) => param.name === 'key')?.value;
+    if (!stagedUploadKey) {
+        throw new AbortError('No key parameter found in staged upload target');
+    }
+    return {
+        url: target.url,
+        resourceUrl: target.resourceUrl,
+        parameters: target.parameters,
+        stagedUploadKey,
+    };
+}
+async function uploadFileToStagedUrl(fileContents, uploadUrl, parameters, filename) {
+    const form = new FormData();
+    for (const param of parameters) {
+        form.append(param.name, param.value);
+    }
+    form.append('file', new Blob([new Uint8Array(fileContents)], { type: 'text/jsonl' }), filename);
+    const uploadResponse = await renderSingleTask({
+        title: outputContent `Uploading bulk operation variables`,
+        task: async () => {
+            return fetch(uploadUrl, {
+                method: 'POST',
+                body: form,
+            }, 'slow-request');
+        },
+        renderOptions: { stdout: process.stderr },
+    });
+    if (!uploadResponse.ok) {
+        const errorText = await uploadResponse.text();
+        throw new AbortError(`Failed to upload file to staged URL: ${uploadResponse.statusText}\n${errorText}`);
+    }
+}
+//# sourceMappingURL=stage-file.js.map

package/dist/public/node/api/bulk-operations/stage-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-file.js","sourceRoot":"","sources":["../../../../../src/public/node/api/bulk-operations/stage-file.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  StagedUploadsCreate,\n  StagedUploadsCreateMutation,\n  StagedUploadsCreateMutationVariables,\n} from '../../../../cli/api/graphql/bulk-operations/generated/staged-uploads-create.js'\nimport {adminRequestDoc} from '../admin.js'\nimport {AdminSession} from '../../session.js'\nimport {fetch} from '../../http.js'\nimport {AbortError} from '../../error.js'\nimport {outputContent} from '../../output.js'\nimport {renderSingleTask} from '../../ui.js'\n\ninterface StageFileOptions {\n  adminSession: AdminSession\n  variablesJsonl?: string\n}\n\n/**\n * Uploads bulk mutation variables to a staged upload target and returns the staged upload key.\n *\n * @param options - The admin session and JSONL variables.\n * @returns The staged upload key used as `stagedUploadPath` for the bulk mutation.\n */\nexport async function stageFile(options: StageFileOptions): Promise<string> {\n  const {adminSession, variablesJsonl} = options\n\n  const buffer = Buffer.from(variablesJsonl ?? '', 'utf-8')\n  const filename = 'bulk-variables.jsonl'\n  const size = buffer.length\n\n  const response = await requestStagedUpload(adminSession, filename, size)\n  const target = validateStagedUploadResponse(response)\n\n  await uploadFileToStagedUrl(buffer, target.url, target.parameters, filename)\n\n  return target.stagedUploadKey\n}\n\nasync function requestStagedUpload(\n  adminSession: AdminSession,\n  filename: string,\n  size: number,\n): Promise<StagedUploadsCreateMutation> {\n  return adminRequestDoc<StagedUploadsCreateMutation, StagedUploadsCreateMutationVariables>({\n    query: StagedUploadsCreate,\n    session: adminSession,\n    variables: {\n      input: [\n        {\n          filename,\n          fileSize: size.toString(),\n          httpMethod: 'POST',\n          mimeType: 'text/jsonl',\n          resource: 'BULK_MUTATION_VARIABLES',\n        },\n      ],\n    },\n  })\n}\n\nfunction validateStagedUploadResponse(response: StagedUploadsCreateMutation): {\n  url: string\n  resourceUrl: string\n  parameters: {name: string; value: string}[]\n  stagedUploadKey: string\n} {\n  if (!response.stagedUploadsCreate) {\n    throw new AbortError('No response received from stagedUploadsCreate mutation')\n  }\n\n  if (response.stagedUploadsCreate.userErrors.length > 0) {\n    const errors = response.stagedUploadsCreate.userErrors\n      .map((error: {field?: string[] | null; message: string}) => error.message)\n      .join(', ')\n    throw new AbortError(`Failed to create staged upload: ${errors}`)\n  }\n\n  const target = response.stagedUploadsCreate.stagedTargets?.[0]\n  if (!target) {\n    throw new AbortError('No staged upload target returned from Shopify')\n  }\n\n  if (!target.url || !target.resourceUrl) {\n    throw new AbortError('Invalid staged upload target: missing required URLs')\n  }\n\n  const stagedUploadKey = target.parameters.find((param) => param.name === 'key')?.value\n  if (!stagedUploadKey) {\n    throw new AbortError('No key parameter found in staged upload target')\n  }\n\n  return {\n    url: target.url,\n    resourceUrl: target.resourceUrl,\n    parameters: target.parameters,\n    stagedUploadKey,\n  }\n}\n\nasync function uploadFileToStagedUrl(\n  fileContents: Buffer,\n  uploadUrl: string,\n  parameters: {name: string; value: string}[],\n  filename: string,\n): Promise<void> {\n  const form = new FormData()\n\n  for (const param of parameters) {\n    form.append(param.name, param.value)\n  }\n\n  form.append('file', new Blob([new Uint8Array(fileContents)], {type: 'text/jsonl'}), filename)\n\n  const uploadResponse = await renderSingleTask({\n    title: outputContent`Uploading bulk operation variables`,\n    task: async () => {\n      return fetch(\n        uploadUrl,\n        {\n          method: 'POST',\n          body: form,\n        },\n        'slow-request',\n      )\n    },\n    renderOptions: {stdout: process.stderr},\n  })\n\n  if (!uploadResponse.ok) {\n    const errorText = await uploadResponse.text()\n    throw new AbortError(`Failed to upload file to staged URL: ${uploadResponse.statusText}\\n${errorText}`)\n  }\n}\n"]}

package/dist/public/node/api/bulk-operations/watch-bulk-operation.d.ts

@@ -0,0 +1,26 @@
+import { GetBulkOperationByIdQuery } from '../../../../cli/api/graphql/bulk-operations/generated/get-bulk-operation-by-id.js';
+import { AdminSession } from '../../session.js';
+import { AbortSignal } from '../../abort.js';
+export declare const QUICK_WATCH_TIMEOUT_MS = 3000;
+export declare const QUICK_WATCH_POLL_INTERVAL_MS = 300;
+export type BulkOperation = NonNullable<GetBulkOperationByIdQuery['bulkOperation']>;
+/**
+ * Polls a bulk operation briefly to surface its initial state, returning quickly so the caller can
+ * keep working while the operation runs in the background.
+ *
+ * @param adminSession - The admin session.
+ * @param operationId - The bulk operation ID to poll.
+ * @returns The latest known operation state.
+ */
+export declare function shortBulkOperationPoll(adminSession: AdminSession, operationId: string): Promise<BulkOperation>;
+/**
+ * Polls a bulk operation until it reaches a terminal state or is aborted, updating the rendered
+ * status as it progresses.
+ *
+ * @param adminSession - The admin session.
+ * @param operationId - The bulk operation ID to watch.
+ * @param abortSignal - Signal used to stop watching early.
+ * @param onAbort - Callback invoked when the user aborts.
+ * @returns The latest known operation state.
+ */
+export declare function watchBulkOperation(adminSession: AdminSession, operationId: string, abortSignal: AbortSignal, onAbort: () => void): Promise<BulkOperation>;

package/dist/public/node/api/bulk-operations/watch-bulk-operation.js

@@ -0,0 +1,131 @@
+import { formatBulkOperationStatus } from './format-bulk-operation-status.js';
+import { BULK_OPERATIONS_MIN_API_VERSION } from './constants.js';
+import { GetBulkOperationById, } from '../../../../cli/api/graphql/bulk-operations/generated/get-bulk-operation-by-id.js';
+import { adminRequestDoc } from '../admin.js';
+import { sleep } from '../../system.js';
+import { outputContent } from '../../output.js';
+import { renderSingleTask } from '../../ui.js';
+const TERMINAL_STATUSES = ['COMPLETED', 'FAILED', 'CANCELED', 'EXPIRED'];
+const INITIAL_POLL_INTERVAL_SECONDS = 1;
+const REGULAR_POLL_INTERVAL_SECONDS = 5;
+const INITIAL_POLL_COUNT = 10;
+export const QUICK_WATCH_TIMEOUT_MS = 3000;
+export const QUICK_WATCH_POLL_INTERVAL_MS = 300;
+/**
+ * Polls a bulk operation briefly to surface its initial state, returning quickly so the caller can
+ * keep working while the operation runs in the background.
+ *
+ * @param adminSession - The admin session.
+ * @param operationId - The bulk operation ID to poll.
+ * @returns The latest known operation state.
+ */
+export async function shortBulkOperationPoll(adminSession, operationId) {
+    return renderSingleTask({
+        title: outputContent `Starting bulk operation`,
+        task: async () => {
+            const startTime = Date.now();
+            const poller = pollBulkOperation({
+                adminSession,
+                operationId,
+                pollIntervalSeconds: QUICK_WATCH_POLL_INTERVAL_MS / 1000,
+                useAdaptivePolling: false,
+            });
+            let latestOperationState;
+            do {
+                // eslint-disable-next-line no-await-in-loop
+                const { value, done } = await poller.next();
+                latestOperationState = value;
+                if (done)
+                    return latestOperationState;
+            } while (Date.now() - startTime < QUICK_WATCH_TIMEOUT_MS);
+            return latestOperationState;
+        },
+        renderOptions: { stdout: process.stderr },
+    });
+}
+/**
+ * Polls a bulk operation until it reaches a terminal state or is aborted, updating the rendered
+ * status as it progresses.
+ *
+ * @param adminSession - The admin session.
+ * @param operationId - The bulk operation ID to watch.
+ * @param abortSignal - Signal used to stop watching early.
+ * @param onAbort - Callback invoked when the user aborts.
+ * @returns The latest known operation state.
+ */
+export async function watchBulkOperation(adminSession, operationId, abortSignal, onAbort) {
+    return renderSingleTask({
+        title: outputContent `Polling bulk operation`,
+        task: async (updateStatus) => {
+            const poller = pollBulkOperation({
+                adminSession,
+                operationId,
+                pollIntervalSeconds: REGULAR_POLL_INTERVAL_SECONDS,
+                initialPollIntervalSeconds: INITIAL_POLL_INTERVAL_SECONDS,
+                initialPollCount: INITIAL_POLL_COUNT,
+                useAdaptivePolling: true,
+                abortSignal,
+            });
+            while (true) {
+                // eslint-disable-next-line no-await-in-loop
+                const { value: latestOperationState, done } = await poller.next();
+                if (done) {
+                    return latestOperationState;
+                }
+                else {
+                    updateStatus(formatBulkOperationStatus(latestOperationState));
+                }
+            }
+        },
+        onAbort,
+        renderOptions: { stdout: process.stderr },
+    });
+}
+async function* pollBulkOperation({ adminSession, operationId, pollIntervalSeconds, useAdaptivePolling = false, initialPollIntervalSeconds = INITIAL_POLL_INTERVAL_SECONDS, initialPollCount = INITIAL_POLL_COUNT, abortSignal, }) {
+    let pollCount = 0;
+    while (true) {
+        // eslint-disable-next-line no-await-in-loop
+        const response = await fetchBulkOperation(adminSession, operationId);
+        if (!response.bulkOperation) {
+            throw new Error('bulk operation not found');
+        }
+        const latestOperationState = response.bulkOperation;
+        if (TERMINAL_STATUSES.includes(latestOperationState.status) || abortSignal?.aborted) {
+            return latestOperationState;
+        }
+        else {
+            yield latestOperationState;
+        }
+        pollCount++;
+        let pollInterval = pollIntervalSeconds;
+        if (useAdaptivePolling && pollCount <= initialPollCount) {
+            pollInterval = initialPollIntervalSeconds;
+        }
+        if (abortSignal) {
+            // Remove the abort listener after each race so the common case (sleep wins) doesn't leak a
+            // listener per poll, which would otherwise trigger MaxListenersExceededWarning on long watches.
+            let removeAbortListener;
+            const abortPromise = new Promise((resolve) => {
+                const handler = () => resolve();
+                abortSignal.addEventListener('abort', handler, { once: true });
+                removeAbortListener = () => abortSignal.removeEventListener('abort', handler);
+            });
+            // eslint-disable-next-line no-await-in-loop
+            await Promise.race([sleep(pollInterval), abortPromise]);
+            removeAbortListener?.();
+        }
+        else {
+            // eslint-disable-next-line no-await-in-loop
+            await sleep(pollInterval);
+        }
+    }
+}
+async function fetchBulkOperation(adminSession, operationId) {
+    return adminRequestDoc({
+        query: GetBulkOperationById,
+        session: adminSession,
+        variables: { id: operationId },
+        version: BULK_OPERATIONS_MIN_API_VERSION,
+    });
+}
+//# sourceMappingURL=watch-bulk-operation.js.map

package/dist/public/node/api/bulk-operations/watch-bulk-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-bulk-operation.js","sourceRoot":"","sources":["../../../../../src/public/node/api/bulk-operations/watch-bulk-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAA;AAC3E,OAAO,EAAC,+BAA+B,EAAC,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EACL,oBAAoB,GAErB,MAAM,mFAAmF,CAAA;AAC1F,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAA;AAErC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,aAAa,CAAA;AAG5C,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AACxE,MAAM,6BAA6B,GAAG,CAAC,CAAA;AACvC,MAAM,6BAA6B,GAAG,CAAC,CAAA;AACvC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAE7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAC1C,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAA;AAI/C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,YAA0B,EAAE,WAAmB;IAC1F,OAAO,gBAAgB,CAAgB;QACrC,KAAK,EAAE,aAAa,CAAA,yBAAyB;QAC7C,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC;gBAC/B,YAAY;gBACZ,WAAW;gBACX,mBAAmB,EAAE,4BAA4B,GAAG,IAAI;gBACxD,kBAAkB,EAAE,KAAK;aAC1B,CAAC,CAAA;YAEF,IAAI,oBAA+C,CAAA;YAEnD,GAAG,CAAC;gBACF,4CAA4C;gBAC5C,MAAM,EAAC,KAAK,EAAE,IAAI,EAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBACzC,oBAAoB,GAAG,KAAK,CAAA;gBAC5B,IAAI,IAAI;oBAAE,OAAO,oBAAoB,CAAA;YACvC,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,sBAAsB,EAAC;YAEzD,OAAO,oBAAoB,CAAA;QAC7B,CAAC;QACD,aAAa,EAAE,EAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAC;KACxC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,WAAmB,EACnB,WAAwB,EACxB,OAAmB;IAEnB,OAAO,gBAAgB,CAAgB;QACrC,KAAK,EAAE,aAAa,CAAA,wBAAwB;QAC5C,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,iBAAiB,CAAC;gBAC/B,YAAY;gBACZ,WAAW;gBACX,mBAAmB,EAAE,6BAA6B;gBAClD,0BAA0B,EAAE,6BAA6B;gBACzD,gBAAgB,EAAE,kBAAkB;gBACpC,kBAAkB,EAAE,IAAI;gBACxB,WAAW;aACZ,CAAC,CAAA;YAEF,OAAO,IAAI,EAAE,CAAC;gBACZ,4CAA4C;gBAC5C,MAAM,EAAC,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC/D,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,oBAAoB,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC,CAAA;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO;QACP,aAAa,EAAE,EAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAC;KACxC,CAAC,CAAA;AACJ,CAAC;AAeD,KAAK,SAAS,CAAC,CAAC,iBAAiB,CAAC,EAChC,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GAAG,KAAK,EAC1B,0BAA0B,GAAG,6BAA6B,EAC1D,gBAAgB,GAAG,kBAAkB,EACrC,WAAW,GACc;IACzB,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,OAAO,IAAI,EAAE,CAAC;QACZ,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAA;QAEpE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QAED,MAAM,oBAAoB,GAAG,QAAQ,CAAC,aAAa,CAAA;QAEnD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACpF,OAAO,oBAAoB,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,oBAAoB,CAAA;QAC5B,CAAC;QAED,SAAS,EAAE,CAAA;QACX,IAAI,YAAY,GAAG,mBAAmB,CAAA;QACtC,IAAI,kBAAkB,IAAI,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACxD,YAAY,GAAG,0BAA0B,CAAA;QAC3C,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,2FAA2F;YAC3F,gGAAgG;YAChG,IAAI,mBAA6C,CAAA;YACjD,MAAM,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACjD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAA;gBAC/B,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAA;gBAC5D,mBAAmB,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC/E,CAAC,CAAC,CAAA;YACF,4CAA4C;YAC5C,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,CAAA;YACvD,mBAAmB,EAAE,EAAE,CAAA;QACzB,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,MAAM,KAAK,CAAC,YAAY,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,YAA0B,EAAE,WAAmB;IAC/E,OAAO,eAAe,CAA0C;QAC9D,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,EAAC,EAAE,EAAE,WAAW,EAAC;QAC5B,OAAO,EAAE,+BAA+B;KACzC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import {formatBulkOperationStatus} from './format-bulk-operation-status.js'\nimport {BULK_OPERATIONS_MIN_API_VERSION} from './constants.js'\nimport {\n  GetBulkOperationById,\n  GetBulkOperationByIdQuery,\n} from '../../../../cli/api/graphql/bulk-operations/generated/get-bulk-operation-by-id.js'\nimport {adminRequestDoc} from '../admin.js'\nimport {sleep} from '../../system.js'\nimport {AdminSession} from '../../session.js'\nimport {outputContent} from '../../output.js'\nimport {renderSingleTask} from '../../ui.js'\nimport {AbortSignal} from '../../abort.js'\n\nconst TERMINAL_STATUSES = ['COMPLETED', 'FAILED', 'CANCELED', 'EXPIRED']\nconst INITIAL_POLL_INTERVAL_SECONDS = 1\nconst REGULAR_POLL_INTERVAL_SECONDS = 5\nconst INITIAL_POLL_COUNT = 10\n\nexport const QUICK_WATCH_TIMEOUT_MS = 3000\nexport const QUICK_WATCH_POLL_INTERVAL_MS = 300\n\nexport type BulkOperation = NonNullable<GetBulkOperationByIdQuery['bulkOperation']>\n\n/**\n * Polls a bulk operation briefly to surface its initial state, returning quickly so the caller can\n * keep working while the operation runs in the background.\n *\n * @param adminSession - The admin session.\n * @param operationId - The bulk operation ID to poll.\n * @returns The latest known operation state.\n */\nexport async function shortBulkOperationPoll(adminSession: AdminSession, operationId: string): Promise<BulkOperation> {\n  return renderSingleTask<BulkOperation>({\n    title: outputContent`Starting bulk operation`,\n    task: async () => {\n      const startTime = Date.now()\n      const poller = pollBulkOperation({\n        adminSession,\n        operationId,\n        pollIntervalSeconds: QUICK_WATCH_POLL_INTERVAL_MS / 1000,\n        useAdaptivePolling: false,\n      })\n\n      let latestOperationState: BulkOperation | undefined\n\n      do {\n        // eslint-disable-next-line no-await-in-loop\n        const {value, done} = await poller.next()\n        latestOperationState = value\n        if (done) return latestOperationState\n      } while (Date.now() - startTime < QUICK_WATCH_TIMEOUT_MS)\n\n      return latestOperationState\n    },\n    renderOptions: {stdout: process.stderr},\n  })\n}\n\n/**\n * Polls a bulk operation until it reaches a terminal state or is aborted, updating the rendered\n * status as it progresses.\n *\n * @param adminSession - The admin session.\n * @param operationId - The bulk operation ID to watch.\n * @param abortSignal - Signal used to stop watching early.\n * @param onAbort - Callback invoked when the user aborts.\n * @returns The latest known operation state.\n */\nexport async function watchBulkOperation(\n  adminSession: AdminSession,\n  operationId: string,\n  abortSignal: AbortSignal,\n  onAbort: () => void,\n): Promise<BulkOperation> {\n  return renderSingleTask<BulkOperation>({\n    title: outputContent`Polling bulk operation`,\n    task: async (updateStatus) => {\n      const poller = pollBulkOperation({\n        adminSession,\n        operationId,\n        pollIntervalSeconds: REGULAR_POLL_INTERVAL_SECONDS,\n        initialPollIntervalSeconds: INITIAL_POLL_INTERVAL_SECONDS,\n        initialPollCount: INITIAL_POLL_COUNT,\n        useAdaptivePolling: true,\n        abortSignal,\n      })\n\n      while (true) {\n        // eslint-disable-next-line no-await-in-loop\n        const {value: latestOperationState, done} = await poller.next()\n        if (done) {\n          return latestOperationState\n        } else {\n          updateStatus(formatBulkOperationStatus(latestOperationState))\n        }\n      }\n    },\n    onAbort,\n    renderOptions: {stdout: process.stderr},\n  })\n}\n\ninterface PollBulkOperationOptions {\n  adminSession: AdminSession\n  operationId: string\n  pollIntervalSeconds: number\n  /** When true, polls faster initially then slows to pollIntervalSeconds. */\n  useAdaptivePolling?: boolean\n  /** Poll interval in seconds for initial fast polls (default: 1). */\n  initialPollIntervalSeconds?: number\n  /** Number of fast polls before switching to regular interval (default: 10). */\n  initialPollCount?: number\n  abortSignal?: AbortSignal\n}\n\nasync function* pollBulkOperation({\n  adminSession,\n  operationId,\n  pollIntervalSeconds,\n  useAdaptivePolling = false,\n  initialPollIntervalSeconds = INITIAL_POLL_INTERVAL_SECONDS,\n  initialPollCount = INITIAL_POLL_COUNT,\n  abortSignal,\n}: PollBulkOperationOptions): AsyncGenerator<BulkOperation, BulkOperation> {\n  let pollCount = 0\n\n  while (true) {\n    // eslint-disable-next-line no-await-in-loop\n    const response = await fetchBulkOperation(adminSession, operationId)\n\n    if (!response.bulkOperation) {\n      throw new Error('bulk operation not found')\n    }\n\n    const latestOperationState = response.bulkOperation\n\n    if (TERMINAL_STATUSES.includes(latestOperationState.status) || abortSignal?.aborted) {\n      return latestOperationState\n    } else {\n      yield latestOperationState\n    }\n\n    pollCount++\n    let pollInterval = pollIntervalSeconds\n    if (useAdaptivePolling && pollCount <= initialPollCount) {\n      pollInterval = initialPollIntervalSeconds\n    }\n\n    if (abortSignal) {\n      // Remove the abort listener after each race so the common case (sleep wins) doesn't leak a\n      // listener per poll, which would otherwise trigger MaxListenersExceededWarning on long watches.\n      let removeAbortListener: (() => void) | undefined\n      const abortPromise = new Promise<void>((resolve) => {\n        const handler = () => resolve()\n        abortSignal.addEventListener('abort', handler, {once: true})\n        removeAbortListener = () => abortSignal.removeEventListener('abort', handler)\n      })\n      // eslint-disable-next-line no-await-in-loop\n      await Promise.race([sleep(pollInterval), abortPromise])\n      removeAbortListener?.()\n    } else {\n      // eslint-disable-next-line no-await-in-loop\n      await sleep(pollInterval)\n    }\n  }\n}\n\nasync function fetchBulkOperation(adminSession: AdminSession, operationId: string): Promise<GetBulkOperationByIdQuery> {\n  return adminRequestDoc<GetBulkOperationByIdQuery, {id: string}>({\n    query: GetBulkOperationById,\n    session: adminSession,\n    variables: {id: operationId},\n    version: BULK_OPERATIONS_MIN_API_VERSION,\n  })\n}\n"]}

package/dist/public/node/api/bulk-operations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared primitives for running Admin API bulk operations.
+ *
+ * These are auth-agnostic: callers provide an `AdminSession` (however they obtained it —
+ * app client credentials, a stored store session, etc.) and these helpers handle starting,
+ * watching, fetching, cancelling, downloading, and formatting bulk operations.
+ */
+export { BULK_OPERATIONS_MIN_API_VERSION } from './bulk-operations/constants.js';
+export { normalizeBulkOperationId, extractBulkOperationId, isMutation, validateSingleOperation, resolveApiVersion, } from './bulk-operations/helpers.js';
+export { resolveBulkOperationQuery } from './bulk-operations/query.js';
+export { runBulkOperationQuery } from './bulk-operations/run-query.js';
+export { runBulkOperationMutation } from './bulk-operations/run-mutation.js';
+export { stageFile } from './bulk-operations/stage-file.js';
+export { fetchBulkOperationById, fetchRecentBulkOperations } from './bulk-operations/fetch.js';
+export { cancelBulkOperationRequest } from './bulk-operations/cancel.js';
+export { watchBulkOperation, shortBulkOperationPoll, QUICK_WATCH_TIMEOUT_MS, QUICK_WATCH_POLL_INTERVAL_MS, type BulkOperation, } from './bulk-operations/watch-bulk-operation.js';
+export { downloadBulkOperationResults, resultsContainUserErrors, } from './bulk-operations/download-bulk-operation-results.js';
+export { formatBulkOperationStatus, renderBulkOperationUserErrors, formatBulkOperationCancellationResult, type BulkOperationCancellationResult, } from './bulk-operations/format-bulk-operation-status.js';

package/dist/public/node/api/bulk-operations.js

@@ -0,0 +1,19 @@
+/**
+ * Shared primitives for running Admin API bulk operations.
+ *
+ * These are auth-agnostic: callers provide an `AdminSession` (however they obtained it —
+ * app client credentials, a stored store session, etc.) and these helpers handle starting,
+ * watching, fetching, cancelling, downloading, and formatting bulk operations.
+ */
+export { BULK_OPERATIONS_MIN_API_VERSION } from './bulk-operations/constants.js';
+export { normalizeBulkOperationId, extractBulkOperationId, isMutation, validateSingleOperation, resolveApiVersion, } from './bulk-operations/helpers.js';
+export { resolveBulkOperationQuery } from './bulk-operations/query.js';
+export { runBulkOperationQuery } from './bulk-operations/run-query.js';
+export { runBulkOperationMutation } from './bulk-operations/run-mutation.js';
+export { stageFile } from './bulk-operations/stage-file.js';
+export { fetchBulkOperationById, fetchRecentBulkOperations } from './bulk-operations/fetch.js';
+export { cancelBulkOperationRequest } from './bulk-operations/cancel.js';
+export { watchBulkOperation, shortBulkOperationPoll, QUICK_WATCH_TIMEOUT_MS, QUICK_WATCH_POLL_INTERVAL_MS, } from './bulk-operations/watch-bulk-operation.js';
+export { downloadBulkOperationResults, resultsContainUserErrors, } from './bulk-operations/download-bulk-operation-results.js';
+export { formatBulkOperationStatus, renderBulkOperationUserErrors, formatBulkOperationCancellationResult, } from './bulk-operations/format-bulk-operation-status.js';
+//# sourceMappingURL=bulk-operations.js.map

package/dist/public/node/api/bulk-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations.js","sourceRoot":"","sources":["../../../../src/public/node/api/bulk-operations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAC,+BAA+B,EAAC,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EACV,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAC,yBAAyB,EAAC,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAC,qBAAqB,EAAC,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAC,wBAAwB,EAAC,MAAM,mCAAmC,CAAA;AAC1E,OAAO,EAAC,SAAS,EAAC,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAC,sBAAsB,EAAE,yBAAyB,EAAC,MAAM,4BAA4B,CAAA;AAC5F,OAAO,EAAC,0BAA0B,EAAC,MAAM,6BAA6B,CAAA;AACtE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,GAE7B,MAAM,2CAA2C,CAAA;AAClD,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,qCAAqC,GAEtC,MAAM,mDAAmD,CAAA","sourcesContent":["/**\n * Shared primitives for running Admin API bulk operations.\n *\n * These are auth-agnostic: callers provide an `AdminSession` (however they obtained it —\n * app client credentials, a stored store session, etc.) and these helpers handle starting,\n * watching, fetching, cancelling, downloading, and formatting bulk operations.\n */\nexport {BULK_OPERATIONS_MIN_API_VERSION} from './bulk-operations/constants.js'\nexport {\n  normalizeBulkOperationId,\n  extractBulkOperationId,\n  isMutation,\n  validateSingleOperation,\n  resolveApiVersion,\n} from './bulk-operations/helpers.js'\nexport {resolveBulkOperationQuery} from './bulk-operations/query.js'\nexport {runBulkOperationQuery} from './bulk-operations/run-query.js'\nexport {runBulkOperationMutation} from './bulk-operations/run-mutation.js'\nexport {stageFile} from './bulk-operations/stage-file.js'\nexport {fetchBulkOperationById, fetchRecentBulkOperations} from './bulk-operations/fetch.js'\nexport {cancelBulkOperationRequest} from './bulk-operations/cancel.js'\nexport {\n  watchBulkOperation,\n  shortBulkOperationPoll,\n  QUICK_WATCH_TIMEOUT_MS,\n  QUICK_WATCH_POLL_INTERVAL_MS,\n  type BulkOperation,\n} from './bulk-operations/watch-bulk-operation.js'\nexport {\n  downloadBulkOperationResults,\n  resultsContainUserErrors,\n} from './bulk-operations/download-bulk-operation-results.js'\nexport {\n  formatBulkOperationStatus,\n  renderBulkOperationUserErrors,\n  formatBulkOperationCancellationResult,\n  type BulkOperationCancellationResult,\n} from './bulk-operations/format-bulk-operation-status.js'\n"]}

package/dist/public/node/constants.d.ts

@@ -0,0 +1 @@
+export declare const STORE_AUTH_APP_CLIENT_ID = "7e9cb568cfd431c538f36d1ad3f2b4f6";

package/dist/public/node/constants.js

@@ -0,0 +1,2 @@
+export const STORE_AUTH_APP_CLIENT_ID = '7e9cb568cfd431c538f36d1ad3f2b4f6';
+//# sourceMappingURL=constants.js.map

package/dist/public/node/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/public/node/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,kCAAkC,CAAA","sourcesContent":["export const STORE_AUTH_APP_CLIENT_ID = '7e9cb568cfd431c538f36d1ad3f2b4f6'\n"]}

package/dist/public/node/context/fqdn.js

@@ -116,10 +116,8 @@ export async function identityFqdn() {
  * @returns Normalized store name.
  */
 export function normalizeStoreFqdn(store) {
-    const storeFqdn = store
-        .replace(/^https?:\/\//, '')
-        .replace(/\/$/, '')
-        .replace(/\/admin$/, '');
+    const storeFqdn = parseStoreFqdn(store);
+    assertValidStoreFqdn(storeFqdn, store);
     const addDomain = (storeFqdn) => {
         switch (serviceEnvironment()) {
             case 'local':
@@ -131,6 +129,49 @@ export function normalizeStoreFqdn(store) {
     const containDomain = (storeFqdn) => storeFqdn.endsWith('.myshopify.com') || storeFqdn.endsWith('.myshopify.io') || storeFqdn.endsWith('.shop.dev');
     return containDomain(storeFqdn) ? storeFqdn : addDomain(storeFqdn);
 }
+const invalidStoreFqdnTryMessage = 'Provide a store handle or Shopify store domain, for example "example" or "example.myshopify.com". ' +
+    'Store URLs may only include the optional /admin path.';
+function parseStoreFqdn(store) {
+    const trimmedStore = store.trim();
+    if (trimmedStore.startsWith('/')) {
+        throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage);
+    }
+    const storeUrl = parseSupportedStoreUrl(/^https?:\/\//i.test(trimmedStore) ? trimmedStore : `https://${trimmedStore}`, store);
+    return storeUrl.hostname;
+}
+function parseSupportedStoreUrl(store, originalStore) {
+    let storeUrl;
+    try {
+        storeUrl = new URL(store);
+    }
+    catch {
+        throw new AbortError(`Invalid store value: ${originalStore}`, invalidStoreFqdnTryMessage);
+    }
+    const supportedPath = storeUrl.pathname === '/' || storeUrl.pathname === '/admin' || storeUrl.pathname === '/admin/';
+    if (!storeUrl.hostname ||
+        storeUrl.username ||
+        storeUrl.password ||
+        storeUrl.port ||
+        storeUrl.search ||
+        storeUrl.hash ||
+        !supportedPath) {
+        throw new AbortError(`Invalid store value: ${originalStore}`, invalidStoreFqdnTryMessage);
+    }
+    return storeUrl;
+}
+function assertValidStoreFqdn(storeFqdn, store) {
+    if (storeFqdn.length === 0 || storeFqdn.length > 253) {
+        throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage);
+    }
+    const domainLabels = storeFqdn.split('.');
+    const validStoreDomainLabel = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i;
+    const validDomain = domainLabels.every((label) => {
+        return label.length > 0 && label.length <= 63 && validStoreDomainLabel.test(label);
+    });
+    if (!validDomain) {
+        throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage);
+    }
+}
 /**
  * Convert a store FQDN to the admin URL pattern for local development.
  * In local mode, transforms \{store\}.my.shop.dev to admin.shop.dev/store/\{store\}.

package/dist/public/node/context/fqdn.js.map

@@ -1 +1 @@
-{"version":3,"file":"fqdn.js","sourceRoot":"","sources":["../../../../src/public/node/context/fqdn.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/switch-exhaustiveness-check -- all switches branch on Environment.Local vs default (production) */\nimport {AbortError} from '../error.js'\nimport {serviceEnvironment} from '../../../private/node/context/service.js'\nimport {DevServer, DevServerCore} from '../vendor/dev_server/index.js'\n\nexport const NotProvidedStoreFQDNError = new AbortError(\n  \"Couldn't obtain the Shopify FQDN because the store FQDN was not provided.\",\n)\n\n/**\n * It returns the Partners' API service we should interact with.\n *\n * @returns Fully-qualified domain of the partners service we should interact with.\n */\nexport async function partnersFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'partners.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('partners').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the Admin service we should interact with.\n *\n * @returns Fully-qualified domain of the Admin service we should interact with.\n */\nexport async function adminFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'admin.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('admin')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the App Management API service we should interact with.\n *\n * @returns Fully-qualified domain of the App Management service we should interact with.\n */\nexport async function appManagementFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'app.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('app')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the App Dev API service we should interact with.\n *\n * @param storeFqdn - The store FQDN.\n * @returns Fully-qualified domain of the App Dev service we should interact with.\n */\nexport async function appDevFqdn(storeFqdn: string): Promise<string> {\n  const environment = serviceEnvironment()\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('app')\n    default:\n      return storeFqdn\n  }\n}\n/**\n * It returns the Developer Dashboard domain we should interact with.\n *\n * @returns Fully-qualified domain of the Developer Dashboard we should interact with.\n */\nexport async function developerDashboardFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'dev.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('dev')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the BusinessPlatform' API service we should interact with.\n *\n * @returns Fully-qualified domain of the partners service we should interact with.\n */\nexport async function businessPlatformFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'destinations.shopifysvc.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('business-platform').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the Identity service we should interact with.\n *\n * @returns Fully-qualified domain of the Identity service we should interact with.\n */\nexport async function identityFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'accounts.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('identity').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * Normalize the store name to be used in the CLI.\n * It will add the .myshopify.com domain if it's not present.\n *\n * @param store - Store name.\n * @returns Normalized store name.\n */\nexport function normalizeStoreFqdn(store: string): string {\n  const storeFqdn = store\n    .replace(/^https?:\\/\\//, '')\n    .replace(/\\/$/, '')\n    .replace(/\\/admin$/, '')\n  const addDomain = (storeFqdn: string) => {\n    switch (serviceEnvironment()) {\n      case 'local':\n        return new DevServerCore().host(storeFqdn)\n      default:\n        return `${storeFqdn}.myshopify.com`\n    }\n  }\n  const containDomain = (storeFqdn: string) =>\n    storeFqdn.endsWith('.myshopify.com') || storeFqdn.endsWith('.myshopify.io') || storeFqdn.endsWith('.shop.dev')\n  return containDomain(storeFqdn) ? storeFqdn : addDomain(storeFqdn)\n}\n\n/**\n * Convert a store FQDN to the admin URL pattern for local development.\n * In local mode, transforms \\{store\\}.my.shop.dev to admin.shop.dev/store/\\{store\\}.\n *\n * @param storeFqdn - Normalized store FQDN.\n * @returns Store admin URL base (without protocol or path).\n */\nexport function storeAdminUrl(storeFqdn: string): string {\n  if (serviceEnvironment() === 'local' && storeFqdn.endsWith('.my.shop.dev')) {\n    const storeName = storeFqdn.replace('.my.shop.dev', '')\n    return `admin.shop.dev/store/${storeName}`\n  }\n  return storeFqdn\n}\n"]}
+{"version":3,"file":"fqdn.js","sourceRoot":"","sources":["../../../../src/public/node/context/fqdn.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/switch-exhaustiveness-check -- all switches branch on Environment.Local vs default (production) */\nimport {AbortError} from '../error.js'\nimport {serviceEnvironment} from '../../../private/node/context/service.js'\nimport {DevServer, DevServerCore} from '../vendor/dev_server/index.js'\n\nexport const NotProvidedStoreFQDNError = new AbortError(\n  \"Couldn't obtain the Shopify FQDN because the store FQDN was not provided.\",\n)\n\n/**\n * It returns the Partners' API service we should interact with.\n *\n * @returns Fully-qualified domain of the partners service we should interact with.\n */\nexport async function partnersFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'partners.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('partners').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the Admin service we should interact with.\n *\n * @returns Fully-qualified domain of the Admin service we should interact with.\n */\nexport async function adminFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'admin.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('admin')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the App Management API service we should interact with.\n *\n * @returns Fully-qualified domain of the App Management service we should interact with.\n */\nexport async function appManagementFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'app.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('app')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the App Dev API service we should interact with.\n *\n * @param storeFqdn - The store FQDN.\n * @returns Fully-qualified domain of the App Dev service we should interact with.\n */\nexport async function appDevFqdn(storeFqdn: string): Promise<string> {\n  const environment = serviceEnvironment()\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('app')\n    default:\n      return storeFqdn\n  }\n}\n/**\n * It returns the Developer Dashboard domain we should interact with.\n *\n * @returns Fully-qualified domain of the Developer Dashboard we should interact with.\n */\nexport async function developerDashboardFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'dev.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServerCore().host('dev')\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the BusinessPlatform' API service we should interact with.\n *\n * @returns Fully-qualified domain of the partners service we should interact with.\n */\nexport async function businessPlatformFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'destinations.shopifysvc.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('business-platform').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * It returns the Identity service we should interact with.\n *\n * @returns Fully-qualified domain of the Identity service we should interact with.\n */\nexport async function identityFqdn(): Promise<string> {\n  const environment = serviceEnvironment()\n  const productionFqdn = 'accounts.shopify.com'\n  switch (environment) {\n    case 'local':\n      return new DevServer('identity').host()\n    default:\n      return productionFqdn\n  }\n}\n\n/**\n * Normalize the store name to be used in the CLI.\n * It will add the .myshopify.com domain if it's not present.\n *\n * @param store - Store name.\n * @returns Normalized store name.\n */\nexport function normalizeStoreFqdn(store: string): string {\n  const storeFqdn = parseStoreFqdn(store)\n\n  assertValidStoreFqdn(storeFqdn, store)\n\n  const addDomain = (storeFqdn: string) => {\n    switch (serviceEnvironment()) {\n      case 'local':\n        return new DevServerCore().host(storeFqdn)\n      default:\n        return `${storeFqdn}.myshopify.com`\n    }\n  }\n  const containDomain = (storeFqdn: string) =>\n    storeFqdn.endsWith('.myshopify.com') || storeFqdn.endsWith('.myshopify.io') || storeFqdn.endsWith('.shop.dev')\n  return containDomain(storeFqdn) ? storeFqdn : addDomain(storeFqdn)\n}\n\nconst invalidStoreFqdnTryMessage =\n  'Provide a store handle or Shopify store domain, for example \"example\" or \"example.myshopify.com\". ' +\n  'Store URLs may only include the optional /admin path.'\n\nfunction parseStoreFqdn(store: string): string {\n  const trimmedStore = store.trim()\n\n  if (trimmedStore.startsWith('/')) {\n    throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage)\n  }\n\n  const storeUrl = parseSupportedStoreUrl(\n    /^https?:\\/\\//i.test(trimmedStore) ? trimmedStore : `https://${trimmedStore}`,\n    store,\n  )\n  return storeUrl.hostname\n}\n\nfunction parseSupportedStoreUrl(store: string, originalStore: string): URL {\n  let storeUrl: URL\n  try {\n    storeUrl = new URL(store)\n  } catch {\n    throw new AbortError(`Invalid store value: ${originalStore}`, invalidStoreFqdnTryMessage)\n  }\n\n  const supportedPath = storeUrl.pathname === '/' || storeUrl.pathname === '/admin' || storeUrl.pathname === '/admin/'\n  if (\n    !storeUrl.hostname ||\n    storeUrl.username ||\n    storeUrl.password ||\n    storeUrl.port ||\n    storeUrl.search ||\n    storeUrl.hash ||\n    !supportedPath\n  ) {\n    throw new AbortError(`Invalid store value: ${originalStore}`, invalidStoreFqdnTryMessage)\n  }\n\n  return storeUrl\n}\n\nfunction assertValidStoreFqdn(storeFqdn: string, store: string) {\n  if (storeFqdn.length === 0 || storeFqdn.length > 253) {\n    throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage)\n  }\n\n  const domainLabels = storeFqdn.split('.')\n  const validStoreDomainLabel = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i\n  const validDomain = domainLabels.every((label) => {\n    return label.length > 0 && label.length <= 63 && validStoreDomainLabel.test(label)\n  })\n\n  if (!validDomain) {\n    throw new AbortError(`Invalid store value: ${store}`, invalidStoreFqdnTryMessage)\n  }\n}\n\n/**\n * Convert a store FQDN to the admin URL pattern for local development.\n * In local mode, transforms \\{store\\}.my.shop.dev to admin.shop.dev/store/\\{store\\}.\n *\n * @param storeFqdn - Normalized store FQDN.\n * @returns Store admin URL base (without protocol or path).\n */\nexport function storeAdminUrl(storeFqdn: string): string {\n  if (serviceEnvironment() === 'local' && storeFqdn.endsWith('.my.shop.dev')) {\n    const storeName = storeFqdn.replace('.my.shop.dev', '')\n    return `admin.shop.dev/store/${storeName}`\n  }\n  return storeFqdn\n}\n"]}

package/dist/public/node/graphiql/session.d.ts

@@ -0,0 +1,50 @@
+import { GraphiQLAppContext, TokenProvider } from './server.js';
+import { AbortSignal } from '../abort.js';
+import { OutputMessage } from '../output.js';
+import { Writable } from 'stream';
+export interface BuildGraphiQLUrlOptions {
+    port: number;
+    key: string;
+    query?: string;
+    variables?: string;
+    apiVersion?: string;
+}
+export interface RunGraphiQLSessionOptions {
+    storeFqdn: string;
+    tokenProvider: TokenProvider;
+    key: string;
+    port?: number;
+    query?: string;
+    variables?: string;
+    apiVersion?: string;
+    appContext?: GraphiQLAppContext;
+    protectMutations?: boolean;
+    additionalReadyMessages?: OutputMessage[];
+    abortSignal?: AbortSignal;
+    stdout?: Writable;
+}
+/**
+ * Generates a random key suitable for authenticating a single local GraphiQL session.
+ *
+ * @returns A 64-character hex string.
+ */
+export declare function generateRandomGraphiQLKey(): string;
+/**
+ * Builds the browser URL for a local GraphiQL session.
+ *
+ * @param options - The local port, key, and optional query string fields to prefill.
+ * @returns The fully-qualified local GraphiQL URL.
+ */
+export declare function buildGraphiQLUrl(options: BuildGraphiQLUrlOptions): string;
+/**
+ * Runs a local GraphiQL session until the user interrupts it or the supplied abort signal fires.
+ *
+ * @param options - The server, authentication, URL prefill, and output options for the session.
+ */
+export declare function runGraphiQLSession(options: RunGraphiQLSessionOptions): Promise<void>;
+/**
+ * Resolves when the process receives SIGINT or when the supplied abort signal fires.
+ *
+ * @param externalSignal - Optional signal used by tests or callers to stop the session.
+ */
+export declare function waitForGraphiQLAbort(externalSignal?: AbortSignal): Promise<void>;

package/dist/public/node/graphiql/session.js

@@ -0,0 +1,92 @@
+import { setupGraphiQLServer } from './server.js';
+import { AbortController } from '../abort.js';
+import { outputContent, outputInfo, outputToken, outputWarn } from '../output.js';
+import { openURL } from '../system.js';
+import { getAvailableTCPPort } from '../tcp.js';
+import { randomBytes } from 'crypto';
+/**
+ * Generates a random key suitable for authenticating a single local GraphiQL session.
+ *
+ * @returns A 64-character hex string.
+ */
+export function generateRandomGraphiQLKey() {
+    return randomBytes(32).toString('hex');
+}
+/**
+ * Builds the browser URL for a local GraphiQL session.
+ *
+ * @param options - The local port, key, and optional query string fields to prefill.
+ * @returns The fully-qualified local GraphiQL URL.
+ */
+export function buildGraphiQLUrl(options) {
+    const url = new URL(`http://localhost:${options.port}/graphiql`);
+    url.searchParams.set('key', options.key);
+    if (options.query)
+        url.searchParams.set('query', options.query);
+    if (options.variables)
+        url.searchParams.set('variables', options.variables);
+    if (options.apiVersion)
+        url.searchParams.set('api_version', options.apiVersion);
+    return url.toString();
+}
+/**
+ * Runs a local GraphiQL session until the user interrupts it or the supplied abort signal fires.
+ *
+ * @param options - The server, authentication, URL prefill, and output options for the session.
+ */
+export async function runGraphiQLSession(options) {
+    const port = await getAvailableTCPPort(options.port);
+    const server = setupGraphiQLServer({
+        stdout: options.stdout ?? process.stdout,
+        port,
+        storeFqdn: options.storeFqdn,
+        tokenProvider: options.tokenProvider,
+        key: options.key,
+        appContext: options.appContext,
+        protectMutations: options.protectMutations,
+    });
+    const url = buildGraphiQLUrl({
+        port,
+        key: options.key,
+        query: options.query,
+        variables: options.variables,
+        apiVersion: options.apiVersion,
+    });
+    try {
+        outputInfo(outputContent `GraphiQL is running at ${outputToken.link(url)}`);
+        options.additionalReadyMessages?.forEach((message) => outputInfo(message));
+        outputInfo('Press Ctrl+C to stop.');
+        const opened = await openURL(url);
+        if (!opened) {
+            outputWarn('Browser did not open automatically. Open the URL above manually.');
+        }
+        await waitForGraphiQLAbort(options.abortSignal);
+    }
+    finally {
+        server.close();
+    }
+}
+/**
+ * Resolves when the process receives SIGINT or when the supplied abort signal fires.
+ *
+ * @param externalSignal - Optional signal used by tests or callers to stop the session.
+ */
+export async function waitForGraphiQLAbort(externalSignal) {
+    const controller = new AbortController();
+    const onSigint = () => controller.abort();
+    process.once('SIGINT', onSigint);
+    try {
+        await new Promise((resolve) => {
+            if (controller.signal.aborted || externalSignal?.aborted) {
+                resolve();
+                return;
+            }
+            controller.signal.addEventListener('abort', () => resolve(), { once: true });
+            externalSignal?.addEventListener('abort', () => controller.abort(), { once: true });
+        });
+    }
+    finally {
+        process.removeListener('SIGINT', onSigint);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/public/node/graphiql/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/public/node/graphiql/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,mBAAmB,EAAgB,MAAM,aAAa,CAAA;AAClF,OAAO,EAAC,eAAe,EAAc,MAAM,aAAa,CAAA;AACxD,OAAO,EAAgB,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,cAAc,CAAA;AAC9F,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAA;AACpC,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAC,WAAW,EAAC,MAAM,QAAQ,CAAA;AA0BlC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,OAAO,CAAC,IAAI,WAAW,CAAC,CAAA;IAChE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,OAAO,CAAC,KAAK;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/D,IAAI,OAAO,CAAC,SAAS;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IAC3E,IAAI,OAAO,CAAC,UAAU;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/E,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,mBAAmB,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;QACxC,IAAI;QACJ,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC3C,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,gBAAgB,CAAC;QAC3B,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,UAAU,CAAC,aAAa,CAAA,0BAA0B,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC1E,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1E,UAAU,CAAC,uBAAuB,CAAC,CAAA;QAEnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,UAAU,CAAC,kEAAkE,CAAC,CAAA;QAChF,CAAC;QAED,MAAM,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,cAA4B;IACrE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IAExC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAEhC,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;gBACzD,OAAO,EAAE,CAAA;gBACT,OAAM;YACR,CAAC;YACD,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAA;YAC1E,cAAc,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAA;QACnF,CAAC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC","sourcesContent":["import {GraphiQLAppContext, setupGraphiQLServer, TokenProvider} from './server.js'\nimport {AbortController, AbortSignal} from '../abort.js'\nimport {OutputMessage, outputContent, outputInfo, outputToken, outputWarn} from '../output.js'\nimport {openURL} from '../system.js'\nimport {getAvailableTCPPort} from '../tcp.js'\nimport {randomBytes} from 'crypto'\nimport {Writable} from 'stream'\n\nexport interface BuildGraphiQLUrlOptions {\n  port: number\n  key: string\n  query?: string\n  variables?: string\n  apiVersion?: string\n}\n\nexport interface RunGraphiQLSessionOptions {\n  storeFqdn: string\n  tokenProvider: TokenProvider\n  key: string\n  port?: number\n  query?: string\n  variables?: string\n  apiVersion?: string\n  appContext?: GraphiQLAppContext\n  protectMutations?: boolean\n  additionalReadyMessages?: OutputMessage[]\n  abortSignal?: AbortSignal\n  stdout?: Writable\n}\n\n/**\n * Generates a random key suitable for authenticating a single local GraphiQL session.\n *\n * @returns A 64-character hex string.\n */\nexport function generateRandomGraphiQLKey(): string {\n  return randomBytes(32).toString('hex')\n}\n\n/**\n * Builds the browser URL for a local GraphiQL session.\n *\n * @param options - The local port, key, and optional query string fields to prefill.\n * @returns The fully-qualified local GraphiQL URL.\n */\nexport function buildGraphiQLUrl(options: BuildGraphiQLUrlOptions): string {\n  const url = new URL(`http://localhost:${options.port}/graphiql`)\n  url.searchParams.set('key', options.key)\n  if (options.query) url.searchParams.set('query', options.query)\n  if (options.variables) url.searchParams.set('variables', options.variables)\n  if (options.apiVersion) url.searchParams.set('api_version', options.apiVersion)\n  return url.toString()\n}\n\n/**\n * Runs a local GraphiQL session until the user interrupts it or the supplied abort signal fires.\n *\n * @param options - The server, authentication, URL prefill, and output options for the session.\n */\nexport async function runGraphiQLSession(options: RunGraphiQLSessionOptions): Promise<void> {\n  const port = await getAvailableTCPPort(options.port)\n  const server = setupGraphiQLServer({\n    stdout: options.stdout ?? process.stdout,\n    port,\n    storeFqdn: options.storeFqdn,\n    tokenProvider: options.tokenProvider,\n    key: options.key,\n    appContext: options.appContext,\n    protectMutations: options.protectMutations,\n  })\n\n  const url = buildGraphiQLUrl({\n    port,\n    key: options.key,\n    query: options.query,\n    variables: options.variables,\n    apiVersion: options.apiVersion,\n  })\n\n  try {\n    outputInfo(outputContent`GraphiQL is running at ${outputToken.link(url)}`)\n    options.additionalReadyMessages?.forEach((message) => outputInfo(message))\n    outputInfo('Press Ctrl+C to stop.')\n\n    const opened = await openURL(url)\n    if (!opened) {\n      outputWarn('Browser did not open automatically. Open the URL above manually.')\n    }\n\n    await waitForGraphiQLAbort(options.abortSignal)\n  } finally {\n    server.close()\n  }\n}\n\n/**\n * Resolves when the process receives SIGINT or when the supplied abort signal fires.\n *\n * @param externalSignal - Optional signal used by tests or callers to stop the session.\n */\nexport async function waitForGraphiQLAbort(externalSignal?: AbortSignal): Promise<void> {\n  const controller = new AbortController()\n\n  const onSigint = () => controller.abort()\n  process.once('SIGINT', onSigint)\n\n  try {\n    await new Promise<void>((resolve) => {\n      if (controller.signal.aborted || externalSignal?.aborted) {\n        resolve()\n        return\n      }\n      controller.signal.addEventListener('abort', () => resolve(), {once: true})\n      externalSignal?.addEventListener('abort', () => controller.abort(), {once: true})\n    })\n  } finally {\n    process.removeListener('SIGINT', onSigint)\n  }\n}\n"]}

package/dist/public/node/graphiql/templates/graphiql.js

@@ -184,10 +184,7 @@ export function graphiqlTemplate({ apiVersion, apiVersions, appName, appUrl, key
                                 React.createElement(Text, { as: "span", tone: "subdued" }, scopesNoteText({ hasAppContext, protectMutations }))))),
                     React.createElement("div", { id: "top-error-bar" },
                         React.createElement(Banner, { tone: "critical", onDismiss: () => { }, icon: DisabledIcon },
-                            React.createElement("p", null,
-                                "The server has been stopped. Restart ",
-                                React.createElement("code", null, "dev"),
-                                " from the CLI."))))))))}
+                            React.createElement("p", null, "The server has been stopped. Restart it from the CLI."))))))))}
       <div id="graphiql-explorer">Loading...</div>
     </div>
     <script