arky-sdk 0.1.0

package/dist/utils/errors.d.ts

@@ -0,0 +1,121 @@
+export declare const ERROR_CODES: {
+    "GENERAL.001": string;
+    "GENERAL.002": string;
+    "GENERAL.003": string;
+    "GENERAL.004": string;
+    "GENERAL.005": string;
+    "GENERAL.006": string;
+    "GOOGLE.001": string;
+    "GOOGLE.002": string;
+    "GOOGLE.003": string;
+    "GOOGLE.004": string;
+    "GOOGLE.005": string;
+    "GOOGLE.006": string;
+    "GOOGLE.007": string;
+    "USER.001": string;
+    "USER.002": string;
+    "USER.003": string;
+    "USER.004": string;
+    "USER.005": string;
+    "USER.006": string;
+    "BUSINESS.001": string;
+    "BUSINESS.002": string;
+    "BUSINESS.003": string;
+    "BUSINESS.004": string;
+    "BUSINESS.005": string;
+    "BUSINESS.006": string;
+    "BUSINESS.007": string;
+    "BUSINESS.010": string;
+    "BUSINESS.011": string;
+    "PROVIDER.001": string;
+    "PROVIDER.002": string;
+    "PROVIDER.003": string;
+    "PROVIDER.004": string;
+    "PROVIDER.005": string;
+    "PROVIDER.006": string;
+    "PROVIDER.007": string;
+    "PROVIDER.008": string;
+};
+export declare const ERROR_CONSTANTS: {
+    GENERAL: {
+        BAD_REQUEST: string;
+        VALIDATION_ERROR: string;
+        FORBIDDEN_ERROR: string;
+        INTERNAL_SERVER_ERROR: string;
+        UNAUTHORIZED: string;
+        UNAUTHENTICATED: string;
+    };
+    USER: {
+        NOT_FOUND: string;
+        FAILED_TO_CREATE: string;
+        FAILED_TO_UPDATE: string;
+        FAILED_TO_DELETE: string;
+        EMAIL_EXISTS: string;
+        FAILED_TO_GET_UPLOAD_URL: string;
+    };
+    BUSINESS: {
+        NOT_FOUND: string;
+        FAILED_TO_CREATE: string;
+        FAILED_TO_UPDATE: string;
+        FAILED_TO_DELETE: string;
+        FAILED_TO_GET_UPLOAD_URL: string;
+        NAME_REQUIRED: string;
+        BUSINESS_ID_REQUIRED: string;
+        DESCRIPTION_REQUIRED: string;
+        SLUG_INVALID: string;
+    };
+};
+export type ServerError = {
+    error: string;
+    reason: string;
+    code: string;
+    statusCode: number;
+    validationErrors: {
+        field: string;
+        code: string;
+    }[];
+};
+export type ValidationError = {
+    field: string;
+    message: string;
+};
+export type RequestError = {
+    validationErrors: ValidationError[];
+};
+export declare function getErrorMessage(code: string): string;
+export declare function isErrorCode(code: string): boolean;
+export declare const transformErrors: (zodError: any) => ValidationError[];
+export declare const convertServerErrorToRequestError: (serverError: ServerError, renameRules?: {
+    [key: string]: string;
+}) => RequestError;
+export declare const errors: {
+    GENERAL: {
+        BAD_REQUEST: string;
+        VALIDATION_ERROR: string;
+        FORBIDDEN_ERROR: string;
+        INTERNAL_SERVER_ERROR: string;
+        UNAUTHORIZED: string;
+        UNAUTHENTICATED: string;
+    };
+    USER: {
+        NOT_FOUND: string;
+        FAILED_TO_CREATE: string;
+        FAILED_TO_UPDATE: string;
+        FAILED_TO_DELETE: string;
+        EMAIL_EXISTS: string;
+        FAILED_TO_GET_UPLOAD_URL: string;
+    };
+    BUSINESS: {
+        NOT_FOUND: string;
+        FAILED_TO_CREATE: string;
+        FAILED_TO_UPDATE: string;
+        FAILED_TO_DELETE: string;
+        FAILED_TO_GET_UPLOAD_URL: string;
+        NAME_REQUIRED: string;
+        BUSINESS_ID_REQUIRED: string;
+        DESCRIPTION_REQUIRED: string;
+        SLUG_INVALID: string;
+    };
+};
+export default ERROR_CODES;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CvB,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACP,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACvC,CAAC;AAGF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAID,eAAO,MAAM,eAAe,GAAI,UAAU,GAAG,KAAG,eAAe,EAmB9D,CAAC;AAEF,eAAO,MAAM,gCAAgC,GACzC,aAAa,WAAW,EACxB,cAAc;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,KACxC,YAeF,CAAC;AAGF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkB,CAAC;AACtC,eAAe,WAAW,CAAC"}

package/dist/utils/errors.js

@@ -0,0 +1,114 @@
+// Error handling utilities (combined from errorCodes.ts and errorHelpers.ts)
+// Comprehensive error code system with both numeric codes and named constants
+export const ERROR_CODES = {
+    // General errors
+    "GENERAL.001": "GENERAL.BAD_REQUEST",
+    "GENERAL.002": "GENERAL.VALIDATION_ERROR",
+    "GENERAL.003": "GENERAL.FORBIDDEN_ERROR",
+    "GENERAL.004": "GENERAL.INTERNAL_SERVER_ERROR",
+    "GENERAL.005": "GENERAL.UNAUTHORIZED",
+    "GENERAL.006": "GENERAL.UNAUTHENTICATED",
+    // Google/OAuth errors
+    "GOOGLE.001": "GOOGLE.INVALID_ORIGIN_URI",
+    "GOOGLE.002": "GOOGLE.INVALID_REDIRECT_URI",
+    "GOOGLE.003": "GOOGLE.FAILED_TO_CALL_API",
+    "GOOGLE.004": "GOOGLE.FAILED_LOGIN",
+    "GOOGLE.005": "GOOGLE.FAILED_LOGOUT",
+    "GOOGLE.006": "GOOGLE.FAILED_REFRESH_TOKEN",
+    "GOOGLE.007": "GOOGLE.INVALID_PROVIDER_PASSED",
+    // User errors
+    "USER.001": "USER.NOT_FOUND",
+    "USER.002": "USER.FAILED_TO_CREATE",
+    "USER.003": "USER.FAILED_TO_UPDATE",
+    "USER.004": "USER.FAILED_TO_DELETE",
+    "USER.005": "USER.EMAIL_EXISTS",
+    "USER.006": "USER.FAILED_TO_GET_UPLOAD_URL",
+    // Business errors
+    "BUSINESS.001": "BUSINESS.NOT_FOUND",
+    "BUSINESS.002": "BUSINESS.FAILED_TO_CREATE",
+    "BUSINESS.003": "BUSINESS.FAILED_TO_UPDATE",
+    "BUSINESS.004": "BUSINESS.FAILED_TO_DELETE",
+    "BUSINESS.005": "BUSINESS.FAILED_TO_GET_UPLOAD_URL",
+    "BUSINESS.006": "BUSINESS.NAME_REQUIRED",
+    "BUSINESS.007": "BUSINESS.BUSINESS_ID_REQUIRED",
+    "BUSINESS.010": "BUSINESS.DESCRIPTION_REQUIRED",
+    "BUSINESS.011": "BUSINESS.SLUG_INVALID",
+    // Provider errors  
+    "PROVIDER.001": "PROVIDER.NOT_FOUND",
+    "PROVIDER.002": "PROVIDER.FAILED_TO_CREATE",
+    "PROVIDER.003": "PROVIDER.FAILED_TO_UPDATE",
+    "PROVIDER.004": "PROVIDER.FAILED_TO_DELETE",
+    "PROVIDER.005": "PROVIDER.FAILED_TO_GET_UPLOAD_URL",
+    "PROVIDER.006": "PROVIDER.NAME_REQUIRED",
+    "PROVIDER.007": "PROVIDER.BUSINESS_ID_REQUIRED",
+    "PROVIDER.008": "PROVIDER.DESCRIPTION_REQUIRED",
+};
+// Named error constants for direct access
+export const ERROR_CONSTANTS = {
+    GENERAL: {
+        BAD_REQUEST: "GENERAL.BAD_REQUEST",
+        VALIDATION_ERROR: "GENERAL.VALIDATION_ERROR",
+        FORBIDDEN_ERROR: "GENERAL.FORBIDDEN_ERROR",
+        INTERNAL_SERVER_ERROR: "GENERAL.INTERNAL_SERVER_ERROR",
+        UNAUTHORIZED: "GENERAL.UNAUTHORIZED",
+        UNAUTHENTICATED: "GENERAL.UNAUTHENTICATED",
+    },
+    USER: {
+        NOT_FOUND: "USER.NOT_FOUND",
+        FAILED_TO_CREATE: "USER.FAILED_TO_CREATE",
+        FAILED_TO_UPDATE: "USER.FAILED_TO_UPDATE",
+        FAILED_TO_DELETE: "USER.FAILED_TO_DELETE",
+        EMAIL_EXISTS: "USER.EMAIL_EXISTS",
+        FAILED_TO_GET_UPLOAD_URL: "USER.FAILED_TO_GET_UPLOAD_URL",
+    },
+    BUSINESS: {
+        NOT_FOUND: "BUSINESS.NOT_FOUND",
+        FAILED_TO_CREATE: "BUSINESS.FAILED_TO_CREATE",
+        FAILED_TO_UPDATE: "BUSINESS.FAILED_TO_UPDATE",
+        FAILED_TO_DELETE: "BUSINESS.FAILED_TO_DELETE",
+        FAILED_TO_GET_UPLOAD_URL: "BUSINESS.FAILED_TO_GET_UPLOAD_URL",
+        NAME_REQUIRED: "BUSINESS.NAME_REQUIRED",
+        BUSINESS_ID_REQUIRED: "BUSINESS.BUSINESS_ID_REQUIRED",
+        DESCRIPTION_REQUIRED: "BUSINESS.DESCRIPTION_REQUIRED",
+        SLUG_INVALID: "BUSINESS.SLUG_INVALID",
+    },
+};
+// Utility functions for error handling
+export function getErrorMessage(code) {
+    return ERROR_CODES[code] || code;
+}
+export function isErrorCode(code) {
+    return code in ERROR_CODES;
+}
+// Note: transformErrors requires zod which is not a dependency
+// If you need zod validation, add it to package.json dependencies
+export const transformErrors = (zodError) => {
+    const customErrors = [];
+    if (!zodError.issues)
+        return customErrors;
+    zodError.issues.forEach((issue) => {
+        const field = issue.path.join(".");
+        const message = issue.message;
+        if (!customErrors.some((customError) => customError.field === field && customError.message === message)) {
+            customErrors.push({ field, message });
+        }
+    });
+    return customErrors;
+};
+export const convertServerErrorToRequestError = (serverError, renameRules) => {
+    return {
+        ...serverError,
+        validationErrors: serverError.validationErrors.map((validationError) => {
+            const field = renameRules && renameRules[validationError.field]
+                ? renameRules[validationError.field]
+                : validationError.field;
+            return {
+                field: field,
+                message: ERROR_CODES[validationError.code] || "Unknown error",
+            };
+        }),
+    };
+};
+// Export for backward compatibility
+export const errors = ERROR_CONSTANTS;
+export default ERROR_CODES;

package/dist/utils/i18n.d.ts

@@ -0,0 +1,5 @@
+export declare function setDefaultLocale(locale: string): void;
+export declare function getLocale(): string;
+export declare function getLocaleFromUrl(url: URL): string;
+export declare function getLocalizedString(value: any, locale?: string): string;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/utils/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/utils/i18n.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAajD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAatE"}

package/dist/utils/i18n.js

@@ -0,0 +1,37 @@
+// Simple i18n utilities for SDK
+// Can be enhanced or replaced by user's i18n library
+let defaultLocale = 'en';
+export function setDefaultLocale(locale) {
+    defaultLocale = locale;
+}
+export function getLocale() {
+    // Try to get from browser if available
+    if (typeof window !== 'undefined' && window.navigator) {
+        return window.navigator.language.split('-')[0] || defaultLocale;
+    }
+    return defaultLocale;
+}
+export function getLocaleFromUrl(url) {
+    // Simple implementation - can be enhanced
+    const pathParts = url.pathname.split('/').filter(Boolean);
+    const potentialLocale = pathParts[0];
+    // Common locale codes
+    const validLocales = ['en', 'fr', 'es', 'de', 'it', 'pt', 'ja', 'zh', 'ko', 'ru'];
+    if (potentialLocale && validLocales.includes(potentialLocale)) {
+        return potentialLocale;
+    }
+    return getLocale();
+}
+export function getLocalizedString(value, locale) {
+    if (!value)
+        return '';
+    // If it's already a string, return it
+    if (typeof value === 'string')
+        return value;
+    // If it's an object with locale keys
+    if (typeof value === 'object') {
+        const targetLocale = locale || getLocale();
+        return value[targetLocale] || value['en'] || value[Object.keys(value)[0]] || '';
+    }
+    return String(value);
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './blocks';
+export * from './errors';
+export * from './price';
+export * from './svg';
+export * from './text';
+export * from './timezone';
+export * from './validation';
+export { getCurrencySymbol } from './currency';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+// Utilities entry point (@arky/sdk/utils)
+export * from './blocks';
+export * from './errors';
+export * from './price';
+export * from './svg';
+export * from './text';
+export * from './timezone';
+export * from './validation';
+// Export specific functions from currency to avoid conflicts with price.ts
+export { getCurrencySymbol } from './currency';

package/dist/utils/price.d.ts

@@ -0,0 +1,33 @@
+import type { Payment, Price } from '../types';
+export declare function convertToMajor(minorAmount: number): number;
+export declare function convertToMinor(majorAmount: number): number;
+export declare function getSymbol(currency: string): string;
+export declare function getCurrencyFromMarket(marketId: string): string;
+export declare function formatCurrencyAmount(amount: number, currency: string, options?: {
+    showSymbols?: boolean;
+    decimalPlaces?: number;
+    customSymbol?: string;
+}): string;
+export declare function formatMinor(amountMinor: number, currency: string, options?: {
+    showSymbols?: boolean;
+    decimalPlaces?: number;
+    customSymbol?: string;
+}): string;
+export declare function formatPayment(payment: Payment, options?: {
+    showSymbols?: boolean;
+    decimalPlaces?: number;
+    showBreakdown?: boolean;
+}): string;
+export declare function getMarketPrice(prices: Price[], marketId: string, businessMarkets?: any[], options?: {
+    showSymbols?: boolean;
+    decimalPlaces?: number;
+    showCompareAt?: boolean;
+    fallbackMarket?: string;
+}): string;
+export declare function getPriceAmount(prices: Price[], marketId: string, fallbackMarket?: string): number;
+export declare function createPaymentForCheckout(subtotalMinor: number, marketId: string, currency: string, paymentMethod: any, options?: {
+    discount?: number;
+    tax?: number;
+    promoCodeId?: string;
+}): Payment;
+//# sourceMappingURL=price.d.ts.map

package/dist/utils/price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../src/utils/price.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,KAAK,EAAE,MAAM,UAAU,CAAC;AAqB9D,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAGD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAGD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAGD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAGD,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACL,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACpB,GACP,MAAM,CAUR;AAGD,wBAAgB,WAAW,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACL,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACpB,GACP,MAAM,CAGR;AAGD,wBAAgB,aAAa,CACzB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACL,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACtB,GACP,MAAM,CAmBR;AAGD,wBAAgB,cAAc,CAC1B,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,GAAG,EAAE,EACvB,OAAO,GAAE;IACL,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACtB,GACP,MAAM,CAwDR;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CASvG;AAGD,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,EAClB,OAAO,GAAE;IACL,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACnB,GACP,OAAO,CAeT"}

package/dist/utils/price.js

@@ -0,0 +1,141 @@
+import { getCurrencySymbol } from './currency';
+// Market-based currency symbols mapping
+const CURRENCY_SYMBOLS = {
+    'USD': '$',
+    'EUR': '€',
+    'GBP': '£',
+    'CAD': 'C$',
+    'AUD': 'A$'
+};
+const MARKET_CURRENCIES = {
+    'US': 'USD',
+    'EU': 'EUR',
+    'UK': 'GBP',
+    'CA': 'CAD',
+    'AU': 'AUD'
+};
+// Convert minor units (cents) to major units (dollars)
+export function convertToMajor(minorAmount) {
+    return (minorAmount ?? 0) / 100;
+}
+// Convert major units to minor units
+export function convertToMinor(majorAmount) {
+    return Math.round((majorAmount ?? 0) * 100);
+}
+// Get currency symbol from currency code
+export function getSymbol(currency) {
+    return CURRENCY_SYMBOLS[currency] || '$';
+}
+// Get currency from market ID
+export function getCurrencyFromMarket(marketId) {
+    return MARKET_CURRENCIES[marketId] || 'USD';
+}
+// Format currency amount with symbol
+export function formatCurrencyAmount(amount, currency, options = {}) {
+    const { showSymbols = true, decimalPlaces = 2, customSymbol } = options;
+    const roundedAmount = amount.toFixed(decimalPlaces);
+    if (!showSymbols) {
+        return `${roundedAmount} ${currency}`;
+    }
+    const symbol = customSymbol || getSymbol(currency);
+    return `${symbol}${roundedAmount}`;
+}
+// Format minor units with currency
+export function formatMinor(amountMinor, currency, options = {}) {
+    const major = convertToMajor(amountMinor);
+    return formatCurrencyAmount(major, currency, options);
+}
+// Format Payment structure for display
+export function formatPayment(payment, options = {}) {
+    if (!payment)
+        return '';
+    const { showSymbols = true, decimalPlaces = 2, showBreakdown = false } = options;
+    if (showBreakdown) {
+        const subtotal = formatMinor(payment.subtotal, payment.currency, { showSymbols, decimalPlaces });
+        const discount = (payment.discount ?? 0) > 0 ? formatMinor(payment.discount, payment.currency, { showSymbols, decimalPlaces }) : null;
+        const tax = (payment.tax ?? 0) > 0 ? formatMinor(payment.tax, payment.currency, { showSymbols, decimalPlaces }) : null;
+        const total = formatMinor(payment.total, payment.currency, { showSymbols, decimalPlaces });
+        let result = `Subtotal: ${subtotal}`;
+        if (discount)
+            result += `, Discount: -${discount}`;
+        if (tax)
+            result += `, Tax: ${tax}`;
+        result += `, Total: ${total}`;
+        return result;
+    }
+    return formatMinor(payment.total, payment.currency, { showSymbols, decimalPlaces });
+}
+// Format market-based prices (from product variants)
+export function getMarketPrice(prices, marketId, businessMarkets, options = {}) {
+    if (!prices || prices.length === 0)
+        return '';
+    const { showSymbols = true, decimalPlaces = 2, showCompareAt = true, fallbackMarket = 'US', } = options;
+    // Find price for the specific market
+    let price = prices.find(p => p.market === marketId);
+    // Fallback to first available or fallback market
+    if (!price) {
+        price = prices.find(p => p.market === fallbackMarket) || prices[0];
+    }
+    if (!price)
+        return '';
+    let currency;
+    let symbol;
+    // If we have business markets, use the currency directly from market data
+    if (businessMarkets) {
+        const marketData = businessMarkets.find(m => m.id === price.market || m.code === price.market);
+        if (marketData?.currency) {
+            currency = marketData.currency;
+            symbol = getCurrencySymbol(currency);
+        }
+        else {
+            currency = getCurrencyFromMarket(price.market);
+            symbol = getSymbol(currency);
+        }
+    }
+    else {
+        currency = getCurrencyFromMarket(price.market);
+        symbol = getSymbol(currency);
+    }
+    // Format price with custom symbol
+    const formattedPrice = formatMinor(price.amount ?? 0, currency, {
+        showSymbols,
+        decimalPlaces,
+        customSymbol: symbol
+    });
+    // Add compare-at price if available
+    if (showCompareAt && price.compareAt && price.compareAt > (price.amount ?? 0)) {
+        const formattedCompareAt = formatMinor(price.compareAt, currency, {
+            showSymbols,
+            decimalPlaces,
+            customSymbol: symbol
+        });
+        return `${formattedPrice} was ${formattedCompareAt}`;
+    }
+    return formattedPrice;
+}
+// Get price amount from market-based prices (for calculations)
+export function getPriceAmount(prices, marketId, fallbackMarket = 'US') {
+    if (!prices || prices.length === 0)
+        return 0;
+    const price = prices.find(p => p.market === marketId) ||
+        prices.find(p => p.market === fallbackMarket) ||
+        prices[0];
+    // Amounts are stored in minor units (e.g., cents)
+    return price?.amount || 0;
+}
+// Create Payment structure for checkout (all amounts in minor units)
+export function createPaymentForCheckout(subtotalMinor, marketId, currency, paymentMethod, options = {}) {
+    const { discount = 0, tax = 0, promoCodeId } = options;
+    const total = subtotalMinor - discount + tax;
+    return {
+        currency,
+        market: marketId,
+        subtotal: subtotalMinor,
+        shipping: 0,
+        discount,
+        tax,
+        total,
+        promoCodeId,
+        method: paymentMethod,
+    };
+}

package/dist/utils/queryParams.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Query parameter builder utility that maintains exact backward compatibility
+ * with existing API parameter encoding patterns
+ */
+export interface QueryParams {
+    [key: string]: string | number | boolean | string[] | number[] | null | undefined;
+}
+/**
+ * Builds a query string from parameters following the exact encoding patterns
+ * used by the existing API implementation:
+ * - Arrays: JSON.stringify then encodeURIComponent
+ * - Strings: encodeURIComponent
+ * - Numbers: No encoding
+ * - Null/undefined: Skip
+ */
+export declare function buildQueryString(params: QueryParams): string;
+/**
+ * Appends query string to a URL
+ */
+export declare function appendQueryString(url: string, params: QueryParams): string;
+//# sourceMappingURL=queryParams.d.ts.map

package/dist/utils/queryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/utils/queryParams.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACrF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA8B5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAG1E"}

package/dist/utils/queryParams.js

@@ -0,0 +1,47 @@
+/**
+ * Query parameter builder utility that maintains exact backward compatibility
+ * with existing API parameter encoding patterns
+ */
+/**
+ * Builds a query string from parameters following the exact encoding patterns
+ * used by the existing API implementation:
+ * - Arrays: JSON.stringify then encodeURIComponent
+ * - Strings: encodeURIComponent
+ * - Numbers: No encoding
+ * - Null/undefined: Skip
+ */
+export function buildQueryString(params) {
+    const queryParts = [];
+    Object.entries(params).forEach(([key, value]) => {
+        // Skip null and undefined values
+        if (value === null || value === undefined) {
+            return;
+        }
+        // Handle arrays: JSON.stringify then encode
+        if (Array.isArray(value)) {
+            const jsonString = JSON.stringify(value);
+            queryParts.push(`${key}=${encodeURIComponent(jsonString)}`);
+        }
+        // Handle strings: encode
+        else if (typeof value === 'string') {
+            queryParts.push(`${key}=${encodeURIComponent(value)}`);
+        }
+        // Handle numbers and booleans: no encoding
+        else if (typeof value === 'number' || typeof value === 'boolean') {
+            queryParts.push(`${key}=${value}`);
+        }
+        // Handle objects (in case needed in future): JSON.stringify then encode
+        else if (typeof value === 'object') {
+            const jsonString = JSON.stringify(value);
+            queryParts.push(`${key}=${encodeURIComponent(jsonString)}`);
+        }
+    });
+    return queryParts.length > 0 ? `?${queryParts.join('&')}` : '';
+}
+/**
+ * Appends query string to a URL
+ */
+export function appendQueryString(url, params) {
+    const queryString = buildQueryString(params);
+    return queryString ? `${url}${queryString}` : url;
+}

package/dist/utils/svg.d.ts

@@ -0,0 +1,17 @@
+export declare function fetchSvgContent(mediaObject: any): Promise<string | null>;
+/**
+ * Server-side helper for Astro components to fetch SVG content during SSR
+ *
+ * @param mediaObject The media object from the CMS
+ * @returns The SVG content as a string, or empty string on failure
+ */
+export declare function getSvgContentForAstro(mediaObject: any): Promise<string>;
+/**
+ * Client-side helper to fetch and inject SVG content into DOM elements
+ *
+ * @param mediaObject The media object from the CMS
+ * @param targetElement The DOM element to inject the SVG into
+ * @param className Optional CSS class to add to the SVG
+ */
+export declare function injectSvgIntoElement(mediaObject: any, targetElement: HTMLElement, className?: string): Promise<void>;
+//# sourceMappingURL=svg.d.ts.map

package/dist/utils/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/utils/svg.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmB9E;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ7E;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,GAAG,EAChB,aAAa,EAAE,WAAW,EAC1B,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/utils/svg.js

@@ -0,0 +1,62 @@
+import { getImageUrl } from "./blocks";
+export async function fetchSvgContent(mediaObject) {
+    if (!mediaObject)
+        return null;
+    const svgUrl = getImageUrl(mediaObject, false);
+    try {
+        const response = await fetch(svgUrl);
+        if (!response.ok) {
+            console.error(`Failed to fetch SVG: ${response.status} ${response.statusText}`);
+            return null;
+        }
+        const svgContent = await response.text();
+        return svgContent;
+    }
+    catch (error) {
+        console.error("Error fetching SVG:", error);
+        return null;
+    }
+}
+/**
+ * Server-side helper for Astro components to fetch SVG content during SSR
+ *
+ * @param mediaObject The media object from the CMS
+ * @returns The SVG content as a string, or empty string on failure
+ */
+export async function getSvgContentForAstro(mediaObject) {
+    try {
+        const svgContent = await fetchSvgContent(mediaObject);
+        return svgContent || "";
+    }
+    catch (error) {
+        console.error("Error getting SVG content for Astro:", error);
+        return "";
+    }
+}
+/**
+ * Client-side helper to fetch and inject SVG content into DOM elements
+ *
+ * @param mediaObject The media object from the CMS
+ * @param targetElement The DOM element to inject the SVG into
+ * @param className Optional CSS class to add to the SVG
+ */
+export async function injectSvgIntoElement(mediaObject, targetElement, className) {
+    if (!targetElement)
+        return;
+    try {
+        const svgContent = await fetchSvgContent(mediaObject);
+        if (svgContent) {
+            targetElement.innerHTML = svgContent;
+            // Add class if provided
+            if (className) {
+                const svgElement = targetElement.querySelector("svg");
+                if (svgElement) {
+                    svgElement.classList.add(...className.split(" "));
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error("Error injecting SVG:", error);
+    }
+}