@proxima-io/storefront-core 0.3.0 → 0.8.2

package/dist/types/buyer.d.ts

@@ -0,0 +1,144 @@
+/** Well-known error detail strings returned by the API. Use these for comparison
+ *  instead of hardcoding strings in your storefront.
+ *
+ * @example
+ * try { await resetPassword(...) } catch (e: any) {
+ *   if (e.data?.detail === BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID) { ... }
+ * }
+ */
+export declare const BUYER_AUTH_ERRORS: {
+    readonly RESET_TOKEN_INVALID: "RESET_TOKEN_INVALID";
+    readonly VERIFY_TOKEN_INVALID: "VERIFY_TOKEN_INVALID";
+    readonly EMAIL_ALREADY_VERIFIED: "EMAIL_ALREADY_VERIFIED";
+    readonly EMAIL_TAKEN: "Email already registered in this store";
+    readonly MISSING_REQUIRED_FIELDS: "MISSING_REQUIRED_FIELDS";
+    /** Turnstile enabled but captcha_token missing or invalid (HTTP 422). */
+    readonly CAPTCHA_REQUIRED: "CAPTCHA_REQUIRED";
+};
+/** True when the API rejected auth because Turnstile verification failed or was omitted. */
+export declare function isCaptchaRequiredError(err: unknown): boolean;
+/** Token pair returned by /store/auth/register, /store/auth/login, /store/auth/refresh */
+export interface BuyerSession {
+    access_token: string;
+    refresh_token: string | null;
+    token_type: string;
+}
+/** Full customer profile from GET /store/me */
+export interface BuyerProfile {
+    id: number;
+    email: string;
+    business_id: string;
+    full_name: string | null;
+    phone: string | null;
+    doc_type: number | null;
+    doc_number: string | null;
+    birth_date: string | null;
+    newsletter_subscribed: boolean;
+    avatar_url: string | null;
+    metadata: Record<string, any>;
+    registration_source: string;
+    last_login_at: string | null;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** A single resolved field in the storefront registration form. */
+export interface RegistrationFormField {
+    name: string;
+    label: string;
+    /** "text" | "password" | "phone" | "date" | "select" | "boolean" | "image" | "address" | "custom" */
+    type: string;
+    /** "text_input" | "phone_input" | "date_picker" | "select" | "checkbox" | "toggle"
+     *  | "image_upload" | "ubigeo_selector" | "google_maps_picker" | "manual" */
+    widget: string;
+    widget_config: Record<string, any>;
+    required: boolean;
+    order: number;
+    options: string[] | null;
+}
+/** A single step in the form (always at least one). */
+export interface RegistrationFormStep {
+    id: string;
+    label: string;
+    order: number;
+    skippable: boolean;
+    fields: RegistrationFormField[];
+}
+/** Full resolved form schema from GET /store/auth/registration-form.
+ *  `email` and `password` are always present in steps[0].fields — no need to add them. */
+export interface RegistrationForm {
+    mode: "single_step" | "multi_step";
+    steps: RegistrationFormStep[];
+}
+/** Address submitted during customer registration. */
+export interface AddressInRegistration {
+    line1: string;
+    line2?: string | null;
+    reference?: string | null;
+    /** 6-digit Peruvian ubigeo code, e.g. "150101" */
+    ubigeo_code?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    /** "google_maps" | "ubigeo_centroid" | "manual" */
+    geocoding_source?: string | null;
+}
+/** All accepted fields for POST /store/auth/register.
+ *  Which fields are required depends on the merchant's registration form configuration.
+ *  Use fetchRegistrationForm() to know which fields to show and which are required. */
+export interface BuyerRegisterParams {
+    email: string;
+    password: string;
+    fullName?: string | null;
+    phone?: string | null;
+    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
+    docType?: number | null;
+    docNumber?: string | null;
+    /** ISO date "YYYY-MM-DD" */
+    birthDate?: string | null;
+    newsletterSubscribed?: boolean;
+    /** Default "organic". */
+    registrationSource?: string;
+    /** Custom fields configured by the merchant — keyed by field name. */
+    metadata?: Record<string, any>;
+    address?: AddressInRegistration | null;
+    /** Cloudflare Turnstile token from the widget — required when API has TURNSTILE_ENABLED=true */
+    captchaToken?: string | null;
+}
+/** A single field that was missing in the registration request. */
+export interface MissingField {
+    field: string;
+    msg: string;
+}
+/**
+ * Thrown when the API returns 422 MISSING_REQUIRED_FIELDS.
+ * Use `error.missingFields` to mark exactly which fields are invalid in the UI.
+ *
+ * @example
+ * try {
+ *   await registerBuyer(config, website, params);
+ * } catch (e) {
+ *   if (e instanceof MissingFieldsError) {
+ *     for (const { field } of e.missingFields) markFieldError(field);
+ *   }
+ * }
+ */
+export declare class MissingFieldsError extends Error {
+    status: 422;
+    missingFields: MissingField[];
+    constructor(missingFields: MissingField[]);
+}
+/** Fields the customer can update via PATCH /store/me/profile. All optional. */
+export interface BuyerProfileUpdateParams {
+    fullName?: string | null;
+    phone?: string | null;
+    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
+    docType?: number | null;
+    docNumber?: string | null;
+    /** ISO date "YYYY-MM-DD" */
+    birthDate?: string | null;
+    newsletterSubscribed?: boolean;
+    avatarUrl?: string | null;
+    /** If provided, changes the customer's password. */
+    password?: string;
+}
+//# sourceMappingURL=buyer.d.ts.map

package/dist/types/buyer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer.d.ts","sourceRoot":"","sources":["../../src/types/buyer.ts"],"names":[],"mappings":"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"}

package/dist/types/buyer.js

@@ -0,0 +1,45 @@
+/** Well-known error detail strings returned by the API. Use these for comparison
+ *  instead of hardcoding strings in your storefront.
+ *
+ * @example
+ * try { await resetPassword(...) } catch (e: any) {
+ *   if (e.data?.detail === BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID) { ... }
+ * }
+ */
+export const BUYER_AUTH_ERRORS = {
+    RESET_TOKEN_INVALID: "RESET_TOKEN_INVALID",
+    VERIFY_TOKEN_INVALID: "VERIFY_TOKEN_INVALID",
+    EMAIL_ALREADY_VERIFIED: "EMAIL_ALREADY_VERIFIED",
+    EMAIL_TAKEN: "Email already registered in this store",
+    MISSING_REQUIRED_FIELDS: "MISSING_REQUIRED_FIELDS",
+    /** Turnstile enabled but captcha_token missing or invalid (HTTP 422). */
+    CAPTCHA_REQUIRED: "CAPTCHA_REQUIRED",
+};
+/** True when the API rejected auth because Turnstile verification failed or was omitted. */
+export function isCaptchaRequiredError(err) {
+    const e = err;
+    return e?.status === 422 && e?.data?.detail === BUYER_AUTH_ERRORS.CAPTCHA_REQUIRED;
+}
+/**
+ * Thrown when the API returns 422 MISSING_REQUIRED_FIELDS.
+ * Use `error.missingFields` to mark exactly which fields are invalid in the UI.
+ *
+ * @example
+ * try {
+ *   await registerBuyer(config, website, params);
+ * } catch (e) {
+ *   if (e instanceof MissingFieldsError) {
+ *     for (const { field } of e.missingFields) markFieldError(field);
+ *   }
+ * }
+ */
+export class MissingFieldsError extends Error {
+    status = 422;
+    missingFields;
+    constructor(missingFields) {
+        super("MISSING_REQUIRED_FIELDS");
+        this.name = "MissingFieldsError";
+        this.missingFields = missingFields;
+    }
+}
+//# sourceMappingURL=buyer.js.map

package/dist/types/buyer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer.js","sourceRoot":"","sources":["../../src/types/buyer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB,EAAK,qBAAqB;IAC7C,oBAAoB,EAAI,sBAAsB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,WAAW,EAAa,wCAAwC;IAChE,uBAAuB,EAAE,yBAAyB;IAClD,yEAAyE;IACzE,gBAAgB,EAAQ,kBAAkB;CAClC,CAAC;AAEX,4FAA4F;AAC5F,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,MAAM,CAAC,GAAG,GAAsD,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC,gBAAgB,CAAC;AACrF,CAAC;AAkHD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,GAAG,GAAY,CAAC;IACtB,aAAa,CAAiB;IAC9B,YAAY,aAA6B;QACvC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}

package/dist/types/campaign.d.ts

@@ -0,0 +1,51 @@
+export interface CampaignScheduleMeta {
+    /** ISO UTC datetime — null if not configured. */
+    countdown_target_at: string | null;
+    /** Which field the target was sourced from. */
+    countdown_target_source: "section_attribute" | "config.display.countdown_target_at" | "active_until" | null;
+}
+/**
+ * Full shape of a resolved Smart Collection as returned in section
+ * `attributes_meta` or `resolved_data` by the composition API.
+ */
+export interface ResolvedSmartCollectionInfo {
+    collection: {
+        id: number;
+        name: string;
+        type: string;
+        is_active: boolean;
+        active_from: string | null;
+        active_until: string | null;
+        config: {
+            display?: {
+                countdown_target_at?: string | null;
+            };
+        };
+        website_id?: string | null;
+        cache_ttl?: number;
+        contract_type?: string | null;
+    };
+    schedule: {
+        data_window: {
+            from: string | null;
+            until: string | null;
+        };
+        countdown_target_at: string | null;
+        countdown_target_source: string | null;
+    };
+    meta: {
+        inactive: boolean;
+        inactive_reason: "disabled" | "before_start" | "after_end" | null;
+    };
+}
+/** Remaining-time snapshot for a countdown. */
+export interface CampaignCountdownState {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    /** True when targetAt is null or already in the past. */
+    expired: boolean;
+    targetAt: string | null;
+}
+//# sourceMappingURL=campaign.d.ts.map

package/dist/types/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../src/types/campaign.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,+CAA+C;IAC/C,uBAAuB,EACnB,mBAAmB,GACnB,oCAAoC,GACpC,cAAc,GACd,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE;gBAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAA;SAAE,CAAC;QAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QAC3D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,CAAC;IACF,IAAI,EAAE;QACJ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,IAAI,CAAC;KACnE,CAAC;CACH;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/types/campaign.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=campaign.js.map

package/dist/types/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/types/campaign.ts"],"names":[],"mappings":""}

package/dist/types/cart.d.ts

@@ -0,0 +1,40 @@
+/** A line item inside a Cart. */
+export interface CartItem {
+    id: number;
+    product_variant_id: number;
+    quantity: number;
+    metadata?: {
+        name?: string | null;
+        slug?: string | null;
+        brand?: string | null;
+        image?: string | null;
+        unit_price?: number | null;
+        unit_price_string?: string | null;
+    } | null;
+}
+export interface CartTotals {
+    subtotal: number;
+    formatted_subtotal: string;
+    currency: string;
+}
+/** Shopping cart for a guest session or authenticated customer. */
+export interface Cart {
+    id: string;
+    session_id?: string | null;
+    customer_id?: number | null;
+    items: CartItem[];
+    totals: CartTotals;
+}
+/** Customer and shipping details submitted at checkout. */
+export interface CheckoutRequest {
+    customer_name: string;
+    customer_phone: string;
+    customer_email?: string | null;
+    shipping_address?: string | null;
+    notes?: string | null;
+    coupon_code?: string | null;
+    customer_doc_type?: number | null;
+    customer_doc_number?: string | null;
+    address_id?: number | null;
+}
+//# sourceMappingURL=cart.d.ts.map

package/dist/types/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/types/cart.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/types/cart.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cart.js.map

package/dist/types/cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/types/cart.ts"],"names":[],"mappings":""}

package/dist/types/catalog.d.ts

@@ -0,0 +1,164 @@
+/** Campaign / Promotion driving this product's price (or matching the
+ *  product by targeting rules when direct-sale ties campaign on price).
+ *  Sections rendering this product can pull badge / theme / countdown
+ *  from here instead of pinning to a campaign by slug. */
+export interface StorefrontAppliedCampaign {
+    id: number;
+    slug?: string | null;
+    name?: Record<string, string> | null;
+    badge_text?: string | null;
+    theme_color?: string | null;
+    active_until?: string | null;
+    hero_copy?: Record<string, string> | null;
+}
+/** Lightweight product representation used in listings, search results, and smart collections. */
+export interface StorefrontProductSummary {
+    id: number;
+    name: string;
+    slug: string;
+    price: number;
+    price_formatted?: string | null;
+    image_url: string;
+    brand_name?: string | null;
+    category_name?: string | null;
+    /** Promotional badge text, e.g. "OFERTA", "NUEVO" */
+    badge?: string | null;
+    rating: number;
+    currency?: string | null;
+    /** First variant id — use this when calling addToCart from a listing card */
+    default_variant_id?: number | null;
+    /** Campaign whose branding (badge, theme, countdown) should be shown
+     *  alongside this product. Populated automatically when an active
+     *  Promotion targets the product. */
+    applied_promotion?: StorefrontAppliedCampaign | null;
+}
+/** Pagination metadata returned by listing endpoints. */
+export interface StorefrontPagination {
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+}
+export interface StorefrontSortOption {
+    value: string;
+    label: string;
+}
+export interface StorefrontFacetOption {
+    value: string;
+    label: string;
+    count: number;
+}
+/** Response from GET /storefront/search */
+export interface StorefrontSearchResponse {
+    query: string;
+    hits: StorefrontProductSummary[];
+    total: number;
+}
+/** Response from GET /storefront/products (all-products listing with facets) */
+export interface StorefrontProductListingResponse {
+    items: StorefrontProductSummary[];
+    pagination: StorefrontPagination;
+    sort_current: string;
+    sort_options: StorefrontSortOption[];
+    brand_facets: StorefrontFacetOption[];
+    category_facets: StorefrontFacetOption[];
+}
+export interface StorefrontCategorySummary {
+    id: number;
+    name: string;
+    slug: string;
+    image_url?: string | null;
+}
+export interface StorefrontBrandSummary {
+    id: number;
+    name: string;
+    slug: string;
+    logo_url?: string | null;
+}
+/** Response from GET /storefront/categories/{slug}/products */
+export interface StorefrontCategoryListingResponse {
+    category: StorefrontCategorySummary;
+    items: StorefrontProductSummary[];
+    pagination: StorefrontPagination;
+    sort_current: string;
+    sort_options: StorefrontSortOption[];
+    brand_facets: StorefrontFacetOption[];
+}
+/** Response from GET /storefront/brands/{slug}/products */
+export interface StorefrontBrandListingResponse {
+    brand: StorefrontBrandSummary;
+    items: StorefrontProductSummary[];
+    pagination: StorefrontPagination;
+    sort_current: string;
+    sort_options: StorefrontSortOption[];
+    category_facets: StorefrontFacetOption[];
+}
+export interface StorefrontCategoryDirectoryItem {
+    id: number;
+    name: string;
+    slug: string;
+    href: string;
+    image_url?: string | null;
+    description?: string | null;
+    product_count: number;
+}
+export interface StorefrontBrandDirectoryItem {
+    id: number;
+    name: string;
+    slug: string;
+    href: string;
+    logo_url?: string | null;
+    product_count: number;
+}
+export interface StorefrontCategoryDirectoryResponse {
+    items: StorefrontCategoryDirectoryItem[];
+    total: number;
+}
+export interface StorefrontBrandDirectoryResponse {
+    items: StorefrontBrandDirectoryItem[];
+    total: number;
+}
+/** Shared params for product listing endpoints — sort, pagination, filters. */
+export interface StorefrontListingParams {
+    /** Page number, starting at 1 */
+    page?: number;
+    /** Items per page (1–60). Default: 24 */
+    pageSize?: number;
+    /** "newest" | "price_asc" | "price_desc" | "popular". Default: "newest" */
+    sort?: string;
+    /** Locale for translated names, e.g. "es", "en" */
+    locale?: string;
+    /** ISO currency code, e.g. "PEN", "USD" */
+    currency?: string;
+}
+/** Coupon validation result from GET /storefront/coupons/validate */
+export interface CouponValidationResult {
+    valid: boolean;
+    code?: string;
+    /** Amount to deduct from the order total */
+    discount_amount?: number;
+    /** "percentage" | "fixed" */
+    discount_type?: string;
+    discount_value?: number;
+    /** Error message when valid=false */
+    error?: string;
+}
+/**
+ * A single node in the category navigation tree.
+ * `children` contains nodes at the next depth level (up to `max_depth`).
+ */
+export interface CategoryNavNode {
+    id: number;
+    slug: string;
+    name: string;
+    /** Storefront href — always `/categoria/{slug}` */
+    href: string;
+    image_url?: string | null;
+    product_count: number;
+    children: CategoryNavNode[];
+}
+export interface CategoryNavTreeResponse {
+    nodes: CategoryNavNode[];
+    total: number;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/types/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/types/catalog.ts"],"names":[],"mappings":"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"}

package/dist/types/catalog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog.js.map

package/dist/types/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/types/catalog.ts"],"names":[],"mappings":""}