@shopify/shopify-api 9.7.1 → 10.0.0

package/dist/esm/lib/session/session-utils.mjs

@@ -0,0 +1,73 @@
+import { SESSION_COOKIE_NAME } from '../auth/oauth/types.mjs';
+import { abstractConvertRequest } from '../../runtime/http/index.mjs';
+import { sanitizeShop } from '../utils/shop-validator.mjs';
+import { logger } from '../logger/index.mjs';
+import { MissingJwtTokenError } from '../error.mjs';
+import { decodeSessionToken } from './decode-session-token.mjs';
+import { Session } from './session.mjs';
+import { Cookies } from '../../runtime/http/cookies.mjs';
+
+function getJwtSessionId(config) {
+    return (shop, userId) => {
+        return `${sanitizeShop(config)(shop, true)}_${userId}`;
+    };
+}
+function getOfflineId(config) {
+    return (shop) => {
+        return `offline_${sanitizeShop(config)(shop, true)}`;
+    };
+}
+function getCurrentSessionId(config) {
+    return async function getCurrentSessionId({ isOnline, ...adapterArgs }) {
+        const request = await abstractConvertRequest(adapterArgs);
+        const log = logger(config);
+        if (config.isEmbeddedApp) {
+            log.debug('App is embedded, looking for session id in JWT payload', {
+                isOnline,
+            });
+            const authHeader = request.headers.Authorization;
+            if (authHeader) {
+                const matches = (typeof authHeader === 'string' ? authHeader : authHeader[0]).match(/^Bearer (.+)$/);
+                if (!matches) {
+                    log.error('Missing Bearer token in authorization header', { isOnline });
+                    throw new MissingJwtTokenError('Missing Bearer token in authorization header');
+                }
+                const jwtPayload = await decodeSessionToken(config)(matches[1]);
+                const shop = jwtPayload.dest.replace(/^https:\/\//, '');
+                log.debug('Found valid JWT payload', { shop, isOnline });
+                if (isOnline) {
+                    return getJwtSessionId(config)(shop, jwtPayload.sub);
+                }
+                else {
+                    return getOfflineId(config)(shop);
+                }
+            }
+            else {
+                log.error('Missing Authorization header, was the request made with authenticatedFetch?', { isOnline });
+            }
+        }
+        else {
+            log.debug('App is not embedded, looking for session id in cookies', {
+                isOnline,
+            });
+            const cookies = new Cookies(request, {}, {
+                keys: [config.apiSecretKey],
+            });
+            return cookies.getAndVerify(SESSION_COOKIE_NAME);
+        }
+        return undefined;
+    };
+}
+function customAppSession(config) {
+    return (shop) => {
+        return new Session({
+            id: '',
+            shop: `${sanitizeShop(config)(shop, true)}`,
+            state: '',
+            isOnline: false,
+        });
+    };
+}
+
+export { customAppSession, getCurrentSessionId, getJwtSessionId, getOfflineId };
+//# sourceMappingURL=session-utils.mjs.map

package/dist/esm/lib/session/session-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-utils.mjs","sources":["../../../../../../lib/session/session-utils.ts"],"sourcesContent":[null],"names":["ShopifyErrors.MissingJwtTokenError"],"mappings":"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"}

package/dist/esm/lib/session/session.mjs

@@ -0,0 +1,237 @@
+import { InvalidSession } from '../error.mjs';
+import { AuthScopes } from '../auth/scopes/index.mjs';
+
+/* eslint-disable no-fallthrough */
+const propertiesToSave = [
+    'id',
+    'shop',
+    'state',
+    'isOnline',
+    'scope',
+    'accessToken',
+    'expires',
+    'onlineAccessInfo',
+];
+/**
+ * Stores App information from logged in merchants so they can make authenticated requests to the Admin API.
+ */
+class Session {
+    static fromPropertyArray(entries, returnUserData = false) {
+        if (!Array.isArray(entries)) {
+            throw new InvalidSession('The parameter is not an array: a Session cannot be created from this object.');
+        }
+        const obj = Object.fromEntries(entries
+            .filter(([_key, value]) => value !== null && value !== undefined)
+            // Sanitize keys
+            .map(([key, value]) => {
+            switch (key.toLowerCase()) {
+                case 'isonline':
+                    return ['isOnline', value];
+                case 'accesstoken':
+                    return ['accessToken', value];
+                case 'onlineaccessinfo':
+                    return ['onlineAccessInfo', value];
+                case 'userid':
+                    return ['userId', value];
+                case 'firstname':
+                    return ['firstName', value];
+                case 'lastname':
+                    return ['lastName', value];
+                case 'accountowner':
+                    return ['accountOwner', value];
+                case 'emailverified':
+                    return ['emailVerified', value];
+                default:
+                    return [key.toLowerCase(), value];
+            }
+        }));
+        const sessionData = {};
+        const onlineAccessInfo = {
+            associated_user: {},
+        };
+        Object.entries(obj).forEach(([key, value]) => {
+            switch (key) {
+                case 'isOnline':
+                    if (typeof value === 'string') {
+                        sessionData[key] = value.toString().toLowerCase() === 'true';
+                    }
+                    else if (typeof value === 'number') {
+                        sessionData[key] = Boolean(value);
+                    }
+                    else {
+                        sessionData[key] = value;
+                    }
+                    break;
+                case 'scope':
+                    sessionData[key] = value.toString();
+                    break;
+                case 'expires':
+                    sessionData[key] = value ? new Date(Number(value)) : undefined;
+                    break;
+                case 'onlineAccessInfo':
+                    onlineAccessInfo.associated_user.id = Number(value);
+                    break;
+                case 'userId':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.id = Number(value);
+                        break;
+                    }
+                case 'firstName':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.first_name = String(value);
+                        break;
+                    }
+                case 'lastName':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.last_name = String(value);
+                        break;
+                    }
+                case 'email':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.email = String(value);
+                        break;
+                    }
+                case 'accountOwner':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.account_owner = Boolean(value);
+                        break;
+                    }
+                case 'locale':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.locale = String(value);
+                        break;
+                    }
+                case 'collaborator':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.collaborator = Boolean(value);
+                        break;
+                    }
+                case 'emailVerified':
+                    if (returnUserData) {
+                        onlineAccessInfo.associated_user.email_verified = Boolean(value);
+                        break;
+                    }
+                // Return any user keys as passed in
+                default:
+                    sessionData[key] = value;
+            }
+        });
+        if (sessionData.isOnline) {
+            sessionData.onlineAccessInfo = onlineAccessInfo;
+        }
+        const session = new Session(sessionData);
+        return session;
+    }
+    constructor(params) {
+        Object.assign(this, params);
+    }
+    /**
+     * Whether the session is active. Active sessions have an access token that is not expired, and has has the given
+     * scopes if scopes is equal to a truthy value.
+     */
+    isActive(scopes) {
+        const hasAccessToken = Boolean(this.accessToken);
+        const isTokenNotExpired = !this.isExpired();
+        const isScopeChanged = this.isScopeChanged(scopes);
+        return !isScopeChanged && hasAccessToken && isTokenNotExpired;
+    }
+    /**
+     * Whether the access token has the given scopes.
+     */
+    isScopeChanged(scopes) {
+        if (typeof scopes === 'undefined') {
+            return false;
+        }
+        const scopesObject = scopes instanceof AuthScopes ? scopes : new AuthScopes(scopes);
+        return !scopesObject.equals(this.scope);
+    }
+    /**
+     * Whether the access token is expired.
+     */
+    isExpired(withinMillisecondsOfExpiry = 0) {
+        return Boolean(this.expires &&
+            this.expires.getTime() - withinMillisecondsOfExpiry < Date.now());
+    }
+    /**
+     * Converts an object with data into a Session.
+     */
+    toObject() {
+        const object = {
+            id: this.id,
+            shop: this.shop,
+            state: this.state,
+            isOnline: this.isOnline,
+        };
+        if (this.scope) {
+            object.scope = this.scope;
+        }
+        if (this.expires) {
+            object.expires = this.expires;
+        }
+        if (this.accessToken) {
+            object.accessToken = this.accessToken;
+        }
+        if (this.onlineAccessInfo) {
+            object.onlineAccessInfo = this.onlineAccessInfo;
+        }
+        return object;
+    }
+    /**
+     * Checks whether the given session is equal to this session.
+     */
+    equals(other) {
+        if (!other)
+            return false;
+        const mandatoryPropsMatch = this.id === other.id &&
+            this.shop === other.shop &&
+            this.state === other.state &&
+            this.isOnline === other.isOnline;
+        if (!mandatoryPropsMatch)
+            return false;
+        const copyA = this.toPropertyArray(true);
+        copyA.sort(([k1], [k2]) => (k1 < k2 ? -1 : 1));
+        const copyB = other.toPropertyArray(true);
+        copyB.sort(([k1], [k2]) => (k1 < k2 ? -1 : 1));
+        return JSON.stringify(copyA) === JSON.stringify(copyB);
+    }
+    /**
+     * Converts the session into an array of key-value pairs.
+     */
+    toPropertyArray(returnUserData = false) {
+        return (Object.entries(this)
+            .filter(([key, value]) => propertiesToSave.includes(key) &&
+            value !== undefined &&
+            value !== null)
+            // Prepare values for db storage
+            .flatMap(([key, value]) => {
+            switch (key) {
+                case 'expires':
+                    return [[key, value ? value.getTime() : undefined]];
+                case 'onlineAccessInfo':
+                    // eslint-disable-next-line no-negated-condition
+                    if (!returnUserData) {
+                        return [[key, value.associated_user.id]];
+                    }
+                    else {
+                        return [
+                            ['userId', value?.associated_user?.id],
+                            ['firstName', value?.associated_user?.first_name],
+                            ['lastName', value?.associated_user?.last_name],
+                            ['email', value?.associated_user?.email],
+                            ['locale', value?.associated_user?.locale],
+                            ['emailVerified', value?.associated_user?.email_verified],
+                            ['accountOwner', value?.associated_user?.account_owner],
+                            ['collaborator', value?.associated_user?.collaborator],
+                        ];
+                    }
+                default:
+                    return [[key, value]];
+            }
+        })
+            // Filter out tuples with undefined values
+            .filter(([_key, value]) => value !== undefined));
+    }
+}
+
+export { Session };
+//# sourceMappingURL=session.mjs.map

package/dist/esm/lib/session/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","sources":["../../../../../../lib/session/session.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/lib/types.mjs

@@ -0,0 +1,61 @@
+var LogSeverity;
+(function (LogSeverity) {
+    LogSeverity[LogSeverity["Error"] = 0] = "Error";
+    LogSeverity[LogSeverity["Warning"] = 1] = "Warning";
+    LogSeverity[LogSeverity["Info"] = 2] = "Info";
+    LogSeverity[LogSeverity["Debug"] = 3] = "Debug";
+})(LogSeverity || (LogSeverity = {}));
+var ApiVersion;
+(function (ApiVersion) {
+    ApiVersion["October22"] = "2022-10";
+    ApiVersion["January23"] = "2023-01";
+    ApiVersion["April23"] = "2023-04";
+    ApiVersion["July23"] = "2023-07";
+    ApiVersion["October23"] = "2023-10";
+    ApiVersion["January24"] = "2024-01";
+    ApiVersion["April24"] = "2024-04";
+    ApiVersion["Unstable"] = "unstable";
+})(ApiVersion || (ApiVersion = {}));
+const LIBRARY_NAME = 'Shopify API Library';
+const LATEST_API_VERSION = ApiVersion.April24;
+/* eslint-disable @shopify/typescript/prefer-pascal-case-enums */
+var ShopifyHeader;
+(function (ShopifyHeader) {
+    ShopifyHeader["AccessToken"] = "X-Shopify-Access-Token";
+    ShopifyHeader["ApiVersion"] = "X-Shopify-API-Version";
+    ShopifyHeader["Domain"] = "X-Shopify-Shop-Domain";
+    ShopifyHeader["Hmac"] = "X-Shopify-Hmac-Sha256";
+    ShopifyHeader["Topic"] = "X-Shopify-Topic";
+    ShopifyHeader["SubTopic"] = "X-Shopify-Sub-Topic";
+    ShopifyHeader["WebhookId"] = "X-Shopify-Webhook-Id";
+    ShopifyHeader["StorefrontPrivateToken"] = "Shopify-Storefront-Private-Token";
+    ShopifyHeader["StorefrontSDKVariant"] = "X-SDK-Variant";
+    ShopifyHeader["StorefrontSDKVersion"] = "X-SDK-Version";
+})(ShopifyHeader || (ShopifyHeader = {}));
+/* eslint-enable @shopify/typescript/prefer-pascal-case-enums */
+var ClientType;
+(function (ClientType) {
+    ClientType["Rest"] = "rest";
+    ClientType["Graphql"] = "graphql";
+})(ClientType || (ClientType = {}));
+const privacyTopics = [
+    'CUSTOMERS_DATA_REQUEST',
+    'CUSTOMERS_REDACT',
+    'SHOP_REDACT',
+];
+var BillingInterval;
+(function (BillingInterval) {
+    BillingInterval["OneTime"] = "ONE_TIME";
+    BillingInterval["Every30Days"] = "EVERY_30_DAYS";
+    BillingInterval["Annual"] = "ANNUAL";
+    BillingInterval["Usage"] = "USAGE";
+})(BillingInterval || (BillingInterval = {}));
+var BillingReplacementBehavior;
+(function (BillingReplacementBehavior) {
+    BillingReplacementBehavior["ApplyImmediately"] = "APPLY_IMMEDIATELY";
+    BillingReplacementBehavior["ApplyOnNextBillingCycle"] = "APPLY_ON_NEXT_BILLING_CYCLE";
+    BillingReplacementBehavior["Standard"] = "STANDARD";
+})(BillingReplacementBehavior || (BillingReplacementBehavior = {}));
+
+export { ApiVersion, BillingInterval, BillingReplacementBehavior, ClientType, LATEST_API_VERSION, LIBRARY_NAME, LogSeverity, ShopifyHeader, privacyTopics };
+//# sourceMappingURL=types.mjs.map

package/dist/esm/lib/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sources":["../../../../../lib/types.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/lib/utils/fetch-request.mjs

@@ -0,0 +1,31 @@
+import { logger } from '../logger/index.mjs';
+import { LogSeverity } from '../types.mjs';
+import { abstractFetch } from '../../runtime/http/index.mjs';
+import '../../runtime/crypto/types.mjs';
+import '../../runtime/crypto/crypto.mjs';
+
+function fetchRequestFactory(config) {
+    return async function fetchRequest(url, options) {
+        const log = logger(config);
+        const doLog = config.logger.httpRequests && config.logger.level === LogSeverity.Debug;
+        if (doLog) {
+            log.debug('Making HTTP request', {
+                method: options?.method || 'GET',
+                url,
+                ...(options?.body && { body: options?.body }),
+            });
+        }
+        const response = await abstractFetch(url, options);
+        if (doLog) {
+            log.debug('HTTP request completed', {
+                method: options?.method || 'GET',
+                url,
+                status: response.status,
+            });
+        }
+        return response;
+    };
+}
+
+export { fetchRequestFactory };
+//# sourceMappingURL=fetch-request.mjs.map

package/dist/esm/lib/utils/fetch-request.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-request.mjs","sources":["../../../../../../lib/utils/fetch-request.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAKM,SAAU,mBAAmB,CAAC,MAAuB,EAAA;AACzD,IAAA,OAAO,eAAe,YAAY,CAChC,GAAW,EACX,OAAqB,EAAA;AAErB,QAAA,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3B,QAAA,MAAM,KAAK,GACT,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CAAC;QAE1E,IAAI,KAAK,EAAE;AACT,YAAA,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE;AAC/B,gBAAA,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;gBAChC,GAAG;AACH,gBAAA,IAAI,OAAO,EAAE,IAAI,IAAI,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAC;AAC3C,aAAA,CAAC,CAAC;SACJ;QAED,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEnD,IAAI,KAAK,EAAE;AACT,YAAA,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE;AAClC,gBAAA,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;gBAChC,GAAG;gBACH,MAAM,EAAE,QAAQ,CAAC,MAAM;AACxB,aAAA,CAAC,CAAC;SACJ;AAED,QAAA,OAAO,QAAQ,CAAC;AAClB,KAAC,CAAC;AACJ;;;;"}

package/dist/esm/lib/utils/get-hmac-key.mjs

@@ -0,0 +1,10 @@
+function getHMACKey(key) {
+    const arrayBuffer = new Uint8Array(key.length);
+    for (let i = 0, keyLen = key.length; i < keyLen; i++) {
+        arrayBuffer[i] = key.charCodeAt(i);
+    }
+    return arrayBuffer;
+}
+
+export { getHMACKey };
+//# sourceMappingURL=get-hmac-key.mjs.map

package/dist/esm/lib/utils/get-hmac-key.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-hmac-key.mjs","sources":["../../../../../../lib/utils/get-hmac-key.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAM,SAAU,UAAU,CAAC,GAAW,EAAA;IACpC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC/C,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QACpD,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;KACpC;AAED,IAAA,OAAO,WAAW,CAAC;AACrB;;;;"}

package/dist/esm/lib/utils/hmac-validator.mjs

@@ -0,0 +1,98 @@
+import { logger } from '../logger/index.mjs';
+import { ShopifyHeader } from '../types.mjs';
+import { abstractConvertRequest } from '../../runtime/http/index.mjs';
+import { HashFormat } from '../../runtime/crypto/types.mjs';
+import '../../runtime/crypto/crypto.mjs';
+import { createSHA256HMAC } from '../../runtime/crypto/utils.mjs';
+import { InvalidHmacError } from '../error.mjs';
+import { safeCompare } from '../auth/oauth/safe-compare.mjs';
+import ProcessedQuery from './processed-query.mjs';
+import { ValidationErrorReason } from './types.mjs';
+import { getHeader } from '../../runtime/http/headers.mjs';
+
+const HMAC_TIMESTAMP_PERMITTED_CLOCK_TOLERANCE_SEC = 90;
+function stringifyQueryForAdmin(query) {
+    const processedQuery = new ProcessedQuery();
+    Object.keys(query)
+        .sort((val1, val2) => val1.localeCompare(val2))
+        .forEach((key) => processedQuery.put(key, query[key]));
+    return processedQuery.stringify(true);
+}
+function stringifyQueryForAppProxy(query) {
+    return Object.entries(query)
+        .sort(([val1], [val2]) => val1.localeCompare(val2))
+        .reduce((acc, [key, value]) => {
+        return `${acc}${key}=${Array.isArray(value) ? value.join(',') : value}`;
+    }, '');
+}
+function generateLocalHmac(config) {
+    return async (params, signator = 'admin') => {
+        const { hmac, signature, ...query } = params;
+        const queryString = signator === 'admin'
+            ? stringifyQueryForAdmin(query)
+            : stringifyQueryForAppProxy(query);
+        return createSHA256HMAC(config.apiSecretKey, queryString, HashFormat.Hex);
+    };
+}
+function validateHmac(config) {
+    return async (query, { signator } = { signator: 'admin' }) => {
+        if (signator === 'admin' && !query.hmac) {
+            throw new InvalidHmacError('Query does not contain an HMAC value.');
+        }
+        if (signator === 'appProxy' && !query.signature) {
+            throw new InvalidHmacError('Query does not contain a signature value.');
+        }
+        validateHmacTimestamp(query);
+        const hmac = signator === 'appProxy' ? query.signature : query.hmac;
+        const localHmac = await generateLocalHmac(config)(query, signator);
+        return safeCompare(hmac, localHmac);
+    };
+}
+async function validateHmacString(config, data, hmac, format) {
+    const localHmac = await createSHA256HMAC(config.apiSecretKey, data, format);
+    return safeCompare(hmac, localHmac);
+}
+function getCurrentTimeInSec() {
+    return Math.trunc(Date.now() / 1000);
+}
+function validateHmacFromRequestFactory(config) {
+    return async function validateHmacFromRequest({ type, rawBody, ...adapterArgs }) {
+        const request = await abstractConvertRequest(adapterArgs);
+        if (!rawBody.length) {
+            return fail(ValidationErrorReason.MissingBody, type, config);
+        }
+        const hmac = getHeader(request.headers, ShopifyHeader.Hmac);
+        if (!hmac) {
+            return fail(ValidationErrorReason.MissingHmac, type, config);
+        }
+        const validHmac = await validateHmacString(config, rawBody, hmac, HashFormat.Base64);
+        if (!validHmac) {
+            return fail(ValidationErrorReason.InvalidHmac, type, config);
+        }
+        return succeed(type, config);
+    };
+}
+function validateHmacTimestamp(query) {
+    if (Math.abs(getCurrentTimeInSec() - Number(query.timestamp)) >
+        HMAC_TIMESTAMP_PERMITTED_CLOCK_TOLERANCE_SEC) {
+        throw new InvalidHmacError('HMAC timestamp is outside of the tolerance range');
+    }
+}
+async function fail(reason, type, config) {
+    const log = logger(config);
+    await log.debug(`${type} request is not valid`, { reason });
+    return {
+        valid: false,
+        reason,
+    };
+}
+async function succeed(type, config) {
+    const log = logger(config);
+    await log.debug(`${type} request is valid`);
+    return {
+        valid: true,
+    };
+}
+
+export { generateLocalHmac, getCurrentTimeInSec, validateHmac, validateHmacFromRequestFactory, validateHmacString };
+//# sourceMappingURL=hmac-validator.mjs.map

package/dist/esm/lib/utils/hmac-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmac-validator.mjs","sources":["../../../../../../lib/utils/hmac-validator.ts"],"sourcesContent":[null],"names":["ShopifyErrors.InvalidHmacError"],"mappings":"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"}

package/dist/esm/lib/utils/index.mjs

@@ -0,0 +1,19 @@
+import { sanitizeShop, sanitizeHost } from './shop-validator.mjs';
+import { validateHmac } from './hmac-validator.mjs';
+import { versionCompatible, versionPriorTo } from './version-compatible.mjs';
+import { shopAdminUrlToLegacyUrl, legacyUrlToShopAdminUrl } from './shop-admin-url-helper.mjs';
+
+function shopifyUtils(config) {
+    return {
+        sanitizeShop: sanitizeShop(config),
+        sanitizeHost: sanitizeHost(),
+        validateHmac: validateHmac(config),
+        versionCompatible: versionCompatible(config),
+        versionPriorTo: versionPriorTo(config),
+        shopAdminUrlToLegacyUrl,
+        legacyUrlToShopAdminUrl,
+    };
+}
+
+export { shopifyUtils };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/lib/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../../../lib/utils/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUM,SAAU,YAAY,CAAC,MAAuB,EAAA;IAClD,OAAO;AACL,QAAA,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC;QAClC,YAAY,EAAE,YAAY,EAAE;AAC5B,QAAA,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC;AAClC,QAAA,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC;AAC5C,QAAA,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC;QACtC,uBAAuB;QACvB,uBAAuB;KACxB,CAAC;AACJ;;;;"}

package/dist/esm/lib/utils/processed-query.mjs

@@ -0,0 +1,43 @@
+class ProcessedQuery {
+    static stringify(keyValuePairs) {
+        if (!keyValuePairs || Object.keys(keyValuePairs).length === 0)
+            return '';
+        return new ProcessedQuery().putAll(keyValuePairs).stringify();
+    }
+    constructor() {
+        this.processedQuery = new URLSearchParams();
+    }
+    putAll(keyValuePairs) {
+        Object.entries(keyValuePairs).forEach(([key, value]) => this.put(key, value));
+        return this;
+    }
+    put(key, value) {
+        if (Array.isArray(value)) {
+            this.putArray(key, value);
+        }
+        else if (value?.constructor === Object) {
+            this.putObject(key, value);
+        }
+        else {
+            this.putSimple(key, value);
+        }
+    }
+    putArray(key, value) {
+        value.forEach((arrayValue) => this.processedQuery.append(`${key}[]`, `${arrayValue}`));
+    }
+    putObject(key, value) {
+        Object.entries(value).forEach(([entry, entryValue]) => {
+            this.processedQuery.append(`${key}[${entry}]`, `${entryValue}`);
+        });
+    }
+    putSimple(key, value) {
+        this.processedQuery.append(key, `${value}`);
+    }
+    stringify(omitQuestionMark = false) {
+        const queryString = this.processedQuery.toString();
+        return omitQuestionMark ? queryString : `?${queryString}`;
+    }
+}
+
+export { ProcessedQuery as default };
+//# sourceMappingURL=processed-query.mjs.map

package/dist/esm/lib/utils/processed-query.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"processed-query.mjs","sources":["../../../../../../lib/utils/processed-query.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAc,MAAO,cAAc,CAAA;IACjC,OAAO,SAAS,CAAC,aAAmC,EAAA;AAClD,QAAA,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,EAAE,CAAC;QAEzE,OAAO,IAAI,cAAc,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC;KAC/D;AAID,IAAA,WAAA,GAAA;AACE,QAAA,IAAI,CAAC,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;KAC7C;AAED,IAAA,MAAM,CAAC,aAAkC,EAAA;QACvC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAgB,KAChE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CACrB,CAAC;AACF,QAAA,OAAO,IAAI,CAAC;KACb;IAED,GAAG,CAAC,GAAW,EAAE,KAAU,EAAA;AACzB,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,YAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SAC3B;AAAM,aAAA,IAAI,KAAK,EAAE,WAAW,KAAK,MAAM,EAAE;AACxC,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SAC5B;aAAM;AACL,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SAC5B;KACF;IAED,QAAQ,CAAC,GAAW,EAAE,KAA0B,EAAA;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC,UAAU,KACvB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAG,EAAA,GAAG,CAAI,EAAA,CAAA,EAAE,GAAG,UAAU,CAAA,CAAE,CAAC,CACxD,CAAC;KACH;IAED,SAAS,CAAC,GAAW,EAAE,KAAa,EAAA;AAClC,QAAA,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAC3B,CAAC,CAAC,KAAK,EAAE,UAAU,CAA4B,KAAI;AACjD,YAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAG,EAAA,GAAG,CAAI,CAAA,EAAA,KAAK,GAAG,EAAE,CAAA,EAAG,UAAU,CAAA,CAAE,CAAC,CAAC;AAClE,SAAC,CACF,CAAC;KACH;IAED,SAAS,CAAC,GAAW,EAAE,KAAsB,EAAA;QAC3C,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,CAAG,EAAA,KAAK,CAAE,CAAA,CAAC,CAAC;KAC7C;IAED,SAAS,CAAC,gBAAgB,GAAG,KAAK,EAAA;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;QACnD,OAAO,gBAAgB,GAAG,WAAW,GAAG,CAAA,CAAA,EAAI,WAAW,CAAA,CAAE,CAAC;KAC3D;AACF;;;;"}