@weaverse/hydrogen 5.3.4 → 5.4.1-beta.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { SelectedOptionInput } from '@shopify/hydrogen/storefront-api-types';
-import { EventEmitter, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData, Weaverse, PlatformTypeEnum, WeaverseItemStore } from '@weaverse/react';
+import { EventEmitter, Weaverse, PlatformTypeEnum, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
 export { PositionInputValue, WeaverseImage, WeaverseVideo, isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
 import { PageType, InspectorGroup, SchemaType, ComponentPresets, SchemaValidationResult } from '@weaverse/schema';
 export * from '@weaverse/schema';
@@ -7,7 +7,7 @@ export { BasicInput, HeadingInput, InputType, InspectorGroup, PageType, SchemaVa
 import { createWithCache, I18nBase, HydrogenContext, HydrogenEnv } from '@shopify/hydrogen';
 import { LoaderFunctionArgs, AppLoadContext } from '@shopify/remix-oxygen';
 import * as React$1 from 'react';
-import { ForwardRefExoticComponent, ComponentType, JSX } from 'react';
+import { ComponentType, JSX, ForwardRefExoticComponent } from 'react';
 import { NavigateFunction } from 'react-router';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -26,8 +26,42 @@ declare class ThemeSettingsStore extends EventEmitter {
     getServerSnapshot: () => HydrogenThemeSettings;
 }
 
+declare class WeaverseHydrogenItem extends WeaverseItemStore {
+    weaverse: WeaverseHydrogen;
+    constructor(initialData: HydrogenComponentData, weaverse: WeaverseHydrogen);
+    get Element(): HydrogenElement;
+}
+declare class WeaverseHydrogen extends Weaverse {
+    platformType: PlatformTypeEnum;
+    pageId: string;
+    internal: Partial<WeaverseInternal>;
+    requestInfo: WeaverseLoaderRequestInfo;
+    projectId: string;
+    weaverseHost: string;
+    weaverseApiBase: string;
+    weaverseApiKey: string;
+    weaverseVersion: string;
+    isDesignMode: boolean;
+    isPreviewMode: boolean;
+    sectionType: string;
+    ItemConstructor: typeof WeaverseHydrogenItem;
+    data: HydrogenPageData;
+    static itemInstances: Map<string, WeaverseHydrogenItem>;
+    static elementRegistry: Map<string, HydrogenElement>;
+    constructor(params: WeaverseHydrogenParams);
+}
+declare function registerComponent(element: HydrogenElement): void;
+declare let WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
+    components: HydrogenComponent[];
+    errorComponent?: React.FC<{
+        error: any;
+    }>;
+}) => react_jsx_runtime.JSX.Element>;
+declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
+declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
+
 declare class WeaverseClient {
-    API: string;
+    API: "v1";
     basePageConfigs: Omit<WeaverseProjectConfigs, 'requestInfo'>;
     basePageRequestBody: Omit<FetchProjectRequestBody, 'url'>;
     configs: WeaverseProjectConfigs;
@@ -40,11 +74,12 @@ declare class WeaverseClient {
     cache: WeaverseClientArgs['cache'];
     waitUntil: WeaverseClientArgs['waitUntil'];
     constructor(args: WeaverseClientArgs);
-    private directFetch;
-    fetchWithCache: <T extends object>(url: string, options?: RequestInit & {
+    private readonly directFetch;
+    private getApiUrl;
+    fetchWithCache: <T = unknown>(url: string, options?: RequestInit & {
         strategy?: AllCacheOptions;
     }) => Promise<T>;
-    loadThemeSettings: (strategy?: AllCacheOptions) => Promise<any>;
+    loadThemeSettings: (strategy?: AllCacheOptions) => Promise<ThemeSettingsResponse>;
     generateFallbackPage: (message: string) => HydrogenPageData;
     loadPage: (params?: {
         type?: PageType;
@@ -55,14 +90,14 @@ declare class WeaverseClient {
     execComponentLoader: (item: HydrogenComponentData) => Promise<HydrogenComponentData>;
 }
 
-interface AllCacheOptions {
-    mode?: string;
+type AllCacheOptions = {
+    mode?: 'must-revalidate' | 'no-cache' | 'no-store' | 'private' | 'public' | string;
     maxAge?: number;
     staleWhileRevalidate?: number;
     sMaxAge?: number;
     staleIfError?: number;
-}
-type ComponentLoaderArgs<T = any, E = any> = {
+};
+type ComponentLoaderArgs<T = any, _E = any> = {
     data: T;
     weaverse: WeaverseClient;
 };
@@ -120,25 +155,33 @@ type WeaverseInternal = {
  * Optimized: Use direct type alias to maintain consistency
  */
 type HydrogenComponentPresets = ComponentPresets;
-interface HydrogenElement {
+type HydrogenElement = {
     Component: ForwardRefExoticComponent<HydrogenComponentProps> | ((props: HydrogenComponentProps) => React$1.JSX.Element);
     type: string;
     schema?: HydrogenComponentSchema;
     /** Optional data loader function for server-side data fetching */
     loader?: (args: ComponentLoaderArgs) => Promise<unknown>;
-}
+};
 interface WeaverseHydrogenParams extends Omit<WeaverseCoreParams, 'ItemConstructor'> {
     data: HydrogenPageData;
     pageId: string;
     internal: Partial<WeaverseInternal>;
     requestInfo: WeaverseLoaderRequestInfo;
+    projectId: string;
+    weaverseHost: string;
+    weaverseApiBase: string;
+    weaverseApiKey: string;
+    weaverseVersion?: string;
+    isDesignMode?: boolean;
+    isPreviewMode?: boolean;
+    sectionType?: string;
 }
-interface HydrogenComponent<T extends HydrogenComponentProps = any> {
+type HydrogenComponent<T extends HydrogenComponentProps = any> = {
     default: ForwardRefExoticComponent<T> | ((props: T) => React$1.JSX.Element);
     schema: HydrogenComponentSchema;
     /** Optional data loader function for server-side data fetching */
     loader?: (args: ComponentLoaderArgs) => Promise<unknown>;
-}
+};
 type WeaverseStudioQueries = {
     weaverseProjectId: string;
     weaverseApiKey: string;
@@ -155,6 +198,7 @@ type PublicEnv = {
 type WeaverseProjectConfigs = {
     projectId: string;
     weaverseHost: string;
+    weaverseApiBase: string;
     weaverseApiKey: string;
     weaverseVersion?: string;
     isDesignMode?: boolean;
@@ -168,14 +212,14 @@ type HydrogenPageAssignment = {
     handle: string;
     locale: string;
 };
-interface WeaverseLoaderData {
+type WeaverseLoaderData = {
     configs: Omit<WeaverseProjectConfigs, 'publicEnv'> & {
         requestInfo: WeaverseLoaderRequestInfo;
     };
     page: HydrogenPageData;
     project: HydrogenProjectType;
     pageAssignment: HydrogenPageAssignment;
-}
+};
 interface HydrogenPageData extends WeaverseProjectDataType {
     id: string;
     name: string;
@@ -188,7 +232,7 @@ type WeaverseI18n = I18nBase & {
     pathPrefix?: string;
     [key: string]: any;
 };
-interface HydrogenThemeSchema {
+type HydrogenThemeSchema = {
     info: {
         name: string;
         version: string;
@@ -205,7 +249,7 @@ interface HydrogenThemeSchema {
         defaultLocale: WeaverseI18n;
         shopLocales: WeaverseI18n[];
     };
-}
+};
 type FetchProjectRequestBody = {
     projectId: string;
     url: string;
@@ -218,10 +262,11 @@ type FetchProjectRequestBody = {
     isDesignMode?: boolean;
 };
 type FetchProjectPayload = {
-    page: HydrogenPageData;
-    project: HydrogenProjectType;
-    pageAssignment: HydrogenPageAssignment;
+    page?: HydrogenPageData;
+    project?: HydrogenProjectType;
+    pageAssignment?: HydrogenPageAssignment;
     error?: string;
+    [key: string]: any;
 };
 type WeaverseClientArgs = HydrogenContext & {
     components: HydrogenComponent[];
@@ -234,6 +279,38 @@ type WeaverseCollection = WeaverseResourcePickerData;
 type WeaverseBlog = WeaverseResourcePickerData;
 type WeaverseArticle = WeaverseResourcePickerData;
 type WeaverseMetaObject = WeaverseResourcePickerData;
+/**
+ * Response types for improved type safety
+ */
+type WithCacheFetchResponse<T> = {
+    data: T;
+    response: Response;
+};
+type ThemeSettingsResponse = {
+    theme?: HydrogenThemeSettings;
+    schema?: HydrogenThemeSchema;
+    publicEnv?: PublicEnv;
+};
+type DirectFetchResponse<T = unknown> = {
+    data?: T;
+    error?: string;
+};
+type CacheResponseValidator<T = unknown> = (response: WithCacheFetchResponse<T> | T) => boolean;
+declare class WeaverseError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code?: string, statusCode?: number, context?: Record<string, unknown>);
+}
+/**
+ * Type guards for response validation
+ */
+declare function isWithCacheFetchResponse<T>(response: unknown): response is WithCacheFetchResponse<T>;
+declare function isFetchProjectPayload(payload: unknown): payload is FetchProjectPayload;
+declare function hasError(response: unknown): response is {
+    error: string;
+};
+declare function isThemeSettingsResponse(data: unknown): data is ThemeSettingsResponse;
 /**
  * Enhanced type utilities for better development experience
  */
@@ -266,11 +343,6 @@ declare global {
         __weaverses: Record<string, WeaverseHydrogen>;
         __weaverseThemeSettingsStore: ThemeSettingsStore;
     }
-    interface Env {
-        WEAVERSE_PROJECT_ID: string;
-        WEAVERSE_HOST: string;
-        WEAVERSE_API_KEY: string;
-    }
 }
 declare module '@shopify/remix-oxygen' {
     interface AppLoadContext {
@@ -281,7 +353,10 @@ declare module '@shopify/hydrogen' {
     interface HydrogenEnv {
         WEAVERSE_PROJECT_ID: string;
         WEAVERSE_HOST?: string;
+        WEAVERSE_API_BASE?: string;
         WEAVERSE_API_KEY: string;
+        PUBLIC_STORE_DOMAIN: string;
+        PUBLIC_STOREFRONT_API_TOKEN: string;
         PUBLIC_GOOGLE_GTM_ID: string;
         JUDGEME_PRIVATE_API_TOKEN: string;
         CUSTOM_COLLECTION_BANNER_METAFIELD: string;
@@ -300,32 +375,6 @@ declare function getWeaverseConfigs(request: Request, env: HydrogenEnv): Weavers
 declare function generateDataFromSchema(schema: HydrogenComponentSchema | HydrogenThemeSchema): Record<string, any>;
 declare function getPreviewData(type: string, components: HydrogenComponent[], weaverseHost: string): WeaverseLoaderData;
 
-declare class WeaverseHydrogenItem extends WeaverseItemStore {
-    weaverse: WeaverseHydrogen;
-    constructor(initialData: HydrogenComponentData, weaverse: WeaverseHydrogen);
-    get Element(): HydrogenElement;
-}
-declare class WeaverseHydrogen extends Weaverse {
-    platformType: PlatformTypeEnum;
-    pageId: string;
-    internal: Partial<WeaverseInternal>;
-    requestInfo: WeaverseLoaderRequestInfo;
-    ItemConstructor: typeof WeaverseHydrogenItem;
-    data: HydrogenPageData;
-    static itemInstances: Map<string, WeaverseHydrogenItem>;
-    static elementRegistry: Map<string, HydrogenElement>;
-    constructor(params: WeaverseHydrogenParams);
-}
-declare function registerComponent(element: HydrogenElement): void;
-declare let WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
-    components: HydrogenComponent[];
-    errorComponent?: React.FC<{
-        error: any;
-    }>;
-}) => react_jsx_runtime.JSX.Element>;
-declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
-declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
-
 declare function getSelectedProductOptions(request: Request): SelectedOptionInput[];
 declare const IMAGES_PLACEHOLDERS: {
     logo_white: string;
@@ -359,4 +408,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type AllCacheOptions, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type PublicEnv, type RouteLoaderArgs, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, isValidHydrogenSchema, registerComponent, useThemeSettings, withWeaverse };
+export { type AllCacheOptions, type CacheResponseValidator, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, isFetchProjectPayload, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, withWeaverse };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { SelectedOptionInput } from '@shopify/hydrogen/storefront-api-types';
-import { EventEmitter, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData, Weaverse, PlatformTypeEnum, WeaverseItemStore } from '@weaverse/react';
+import { EventEmitter, Weaverse, PlatformTypeEnum, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
 export { PositionInputValue, WeaverseImage, WeaverseVideo, isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
 import { PageType, InspectorGroup, SchemaType, ComponentPresets, SchemaValidationResult } from '@weaverse/schema';
 export * from '@weaverse/schema';
@@ -7,7 +7,7 @@ export { BasicInput, HeadingInput, InputType, InspectorGroup, PageType, SchemaVa
 import { createWithCache, I18nBase, HydrogenContext, HydrogenEnv } from '@shopify/hydrogen';
 import { LoaderFunctionArgs, AppLoadContext } from '@shopify/remix-oxygen';
 import * as React$1 from 'react';
-import { ForwardRefExoticComponent, ComponentType, JSX } from 'react';
+import { ComponentType, JSX, ForwardRefExoticComponent } from 'react';
 import { NavigateFunction } from 'react-router';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -26,8 +26,42 @@ declare class ThemeSettingsStore extends EventEmitter {
     getServerSnapshot: () => HydrogenThemeSettings;
 }
 
+declare class WeaverseHydrogenItem extends WeaverseItemStore {
+    weaverse: WeaverseHydrogen;
+    constructor(initialData: HydrogenComponentData, weaverse: WeaverseHydrogen);
+    get Element(): HydrogenElement;
+}
+declare class WeaverseHydrogen extends Weaverse {
+    platformType: PlatformTypeEnum;
+    pageId: string;
+    internal: Partial<WeaverseInternal>;
+    requestInfo: WeaverseLoaderRequestInfo;
+    projectId: string;
+    weaverseHost: string;
+    weaverseApiBase: string;
+    weaverseApiKey: string;
+    weaverseVersion: string;
+    isDesignMode: boolean;
+    isPreviewMode: boolean;
+    sectionType: string;
+    ItemConstructor: typeof WeaverseHydrogenItem;
+    data: HydrogenPageData;
+    static itemInstances: Map<string, WeaverseHydrogenItem>;
+    static elementRegistry: Map<string, HydrogenElement>;
+    constructor(params: WeaverseHydrogenParams);
+}
+declare function registerComponent(element: HydrogenElement): void;
+declare let WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
+    components: HydrogenComponent[];
+    errorComponent?: React.FC<{
+        error: any;
+    }>;
+}) => react_jsx_runtime.JSX.Element>;
+declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
+declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
+
 declare class WeaverseClient {
-    API: string;
+    API: "v1";
     basePageConfigs: Omit<WeaverseProjectConfigs, 'requestInfo'>;
     basePageRequestBody: Omit<FetchProjectRequestBody, 'url'>;
     configs: WeaverseProjectConfigs;
@@ -40,11 +74,12 @@ declare class WeaverseClient {
     cache: WeaverseClientArgs['cache'];
     waitUntil: WeaverseClientArgs['waitUntil'];
     constructor(args: WeaverseClientArgs);
-    private directFetch;
-    fetchWithCache: <T extends object>(url: string, options?: RequestInit & {
+    private readonly directFetch;
+    private getApiUrl;
+    fetchWithCache: <T = unknown>(url: string, options?: RequestInit & {
         strategy?: AllCacheOptions;
     }) => Promise<T>;
-    loadThemeSettings: (strategy?: AllCacheOptions) => Promise<any>;
+    loadThemeSettings: (strategy?: AllCacheOptions) => Promise<ThemeSettingsResponse>;
     generateFallbackPage: (message: string) => HydrogenPageData;
     loadPage: (params?: {
         type?: PageType;
@@ -55,14 +90,14 @@ declare class WeaverseClient {
     execComponentLoader: (item: HydrogenComponentData) => Promise<HydrogenComponentData>;
 }
 
-interface AllCacheOptions {
-    mode?: string;
+type AllCacheOptions = {
+    mode?: 'must-revalidate' | 'no-cache' | 'no-store' | 'private' | 'public' | string;
     maxAge?: number;
     staleWhileRevalidate?: number;
     sMaxAge?: number;
     staleIfError?: number;
-}
-type ComponentLoaderArgs<T = any, E = any> = {
+};
+type ComponentLoaderArgs<T = any, _E = any> = {
     data: T;
     weaverse: WeaverseClient;
 };
@@ -120,25 +155,33 @@ type WeaverseInternal = {
  * Optimized: Use direct type alias to maintain consistency
  */
 type HydrogenComponentPresets = ComponentPresets;
-interface HydrogenElement {
+type HydrogenElement = {
     Component: ForwardRefExoticComponent<HydrogenComponentProps> | ((props: HydrogenComponentProps) => React$1.JSX.Element);
     type: string;
     schema?: HydrogenComponentSchema;
     /** Optional data loader function for server-side data fetching */
     loader?: (args: ComponentLoaderArgs) => Promise<unknown>;
-}
+};
 interface WeaverseHydrogenParams extends Omit<WeaverseCoreParams, 'ItemConstructor'> {
     data: HydrogenPageData;
     pageId: string;
     internal: Partial<WeaverseInternal>;
     requestInfo: WeaverseLoaderRequestInfo;
+    projectId: string;
+    weaverseHost: string;
+    weaverseApiBase: string;
+    weaverseApiKey: string;
+    weaverseVersion?: string;
+    isDesignMode?: boolean;
+    isPreviewMode?: boolean;
+    sectionType?: string;
 }
-interface HydrogenComponent<T extends HydrogenComponentProps = any> {
+type HydrogenComponent<T extends HydrogenComponentProps = any> = {
     default: ForwardRefExoticComponent<T> | ((props: T) => React$1.JSX.Element);
     schema: HydrogenComponentSchema;
     /** Optional data loader function for server-side data fetching */
     loader?: (args: ComponentLoaderArgs) => Promise<unknown>;
-}
+};
 type WeaverseStudioQueries = {
     weaverseProjectId: string;
     weaverseApiKey: string;
@@ -155,6 +198,7 @@ type PublicEnv = {
 type WeaverseProjectConfigs = {
     projectId: string;
     weaverseHost: string;
+    weaverseApiBase: string;
     weaverseApiKey: string;
     weaverseVersion?: string;
     isDesignMode?: boolean;
@@ -168,14 +212,14 @@ type HydrogenPageAssignment = {
     handle: string;
     locale: string;
 };
-interface WeaverseLoaderData {
+type WeaverseLoaderData = {
     configs: Omit<WeaverseProjectConfigs, 'publicEnv'> & {
         requestInfo: WeaverseLoaderRequestInfo;
     };
     page: HydrogenPageData;
     project: HydrogenProjectType;
     pageAssignment: HydrogenPageAssignment;
-}
+};
 interface HydrogenPageData extends WeaverseProjectDataType {
     id: string;
     name: string;
@@ -188,7 +232,7 @@ type WeaverseI18n = I18nBase & {
     pathPrefix?: string;
     [key: string]: any;
 };
-interface HydrogenThemeSchema {
+type HydrogenThemeSchema = {
     info: {
         name: string;
         version: string;
@@ -205,7 +249,7 @@ interface HydrogenThemeSchema {
         defaultLocale: WeaverseI18n;
         shopLocales: WeaverseI18n[];
     };
-}
+};
 type FetchProjectRequestBody = {
     projectId: string;
     url: string;
@@ -218,10 +262,11 @@ type FetchProjectRequestBody = {
     isDesignMode?: boolean;
 };
 type FetchProjectPayload = {
-    page: HydrogenPageData;
-    project: HydrogenProjectType;
-    pageAssignment: HydrogenPageAssignment;
+    page?: HydrogenPageData;
+    project?: HydrogenProjectType;
+    pageAssignment?: HydrogenPageAssignment;
     error?: string;
+    [key: string]: any;
 };
 type WeaverseClientArgs = HydrogenContext & {
     components: HydrogenComponent[];
@@ -234,6 +279,38 @@ type WeaverseCollection = WeaverseResourcePickerData;
 type WeaverseBlog = WeaverseResourcePickerData;
 type WeaverseArticle = WeaverseResourcePickerData;
 type WeaverseMetaObject = WeaverseResourcePickerData;
+/**
+ * Response types for improved type safety
+ */
+type WithCacheFetchResponse<T> = {
+    data: T;
+    response: Response;
+};
+type ThemeSettingsResponse = {
+    theme?: HydrogenThemeSettings;
+    schema?: HydrogenThemeSchema;
+    publicEnv?: PublicEnv;
+};
+type DirectFetchResponse<T = unknown> = {
+    data?: T;
+    error?: string;
+};
+type CacheResponseValidator<T = unknown> = (response: WithCacheFetchResponse<T> | T) => boolean;
+declare class WeaverseError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code?: string, statusCode?: number, context?: Record<string, unknown>);
+}
+/**
+ * Type guards for response validation
+ */
+declare function isWithCacheFetchResponse<T>(response: unknown): response is WithCacheFetchResponse<T>;
+declare function isFetchProjectPayload(payload: unknown): payload is FetchProjectPayload;
+declare function hasError(response: unknown): response is {
+    error: string;
+};
+declare function isThemeSettingsResponse(data: unknown): data is ThemeSettingsResponse;
 /**
  * Enhanced type utilities for better development experience
  */
@@ -266,11 +343,6 @@ declare global {
         __weaverses: Record<string, WeaverseHydrogen>;
         __weaverseThemeSettingsStore: ThemeSettingsStore;
     }
-    interface Env {
-        WEAVERSE_PROJECT_ID: string;
-        WEAVERSE_HOST: string;
-        WEAVERSE_API_KEY: string;
-    }
 }
 declare module '@shopify/remix-oxygen' {
     interface AppLoadContext {
@@ -281,7 +353,10 @@ declare module '@shopify/hydrogen' {
     interface HydrogenEnv {
         WEAVERSE_PROJECT_ID: string;
         WEAVERSE_HOST?: string;
+        WEAVERSE_API_BASE?: string;
         WEAVERSE_API_KEY: string;
+        PUBLIC_STORE_DOMAIN: string;
+        PUBLIC_STOREFRONT_API_TOKEN: string;
         PUBLIC_GOOGLE_GTM_ID: string;
         JUDGEME_PRIVATE_API_TOKEN: string;
         CUSTOM_COLLECTION_BANNER_METAFIELD: string;
@@ -300,32 +375,6 @@ declare function getWeaverseConfigs(request: Request, env: HydrogenEnv): Weavers
 declare function generateDataFromSchema(schema: HydrogenComponentSchema | HydrogenThemeSchema): Record<string, any>;
 declare function getPreviewData(type: string, components: HydrogenComponent[], weaverseHost: string): WeaverseLoaderData;
 
-declare class WeaverseHydrogenItem extends WeaverseItemStore {
-    weaverse: WeaverseHydrogen;
-    constructor(initialData: HydrogenComponentData, weaverse: WeaverseHydrogen);
-    get Element(): HydrogenElement;
-}
-declare class WeaverseHydrogen extends Weaverse {
-    platformType: PlatformTypeEnum;
-    pageId: string;
-    internal: Partial<WeaverseInternal>;
-    requestInfo: WeaverseLoaderRequestInfo;
-    ItemConstructor: typeof WeaverseHydrogenItem;
-    data: HydrogenPageData;
-    static itemInstances: Map<string, WeaverseHydrogenItem>;
-    static elementRegistry: Map<string, HydrogenElement>;
-    constructor(params: WeaverseHydrogenParams);
-}
-declare function registerComponent(element: HydrogenElement): void;
-declare let WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
-    components: HydrogenComponent[];
-    errorComponent?: React.FC<{
-        error: any;
-    }>;
-}) => react_jsx_runtime.JSX.Element>;
-declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
-declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
-
 declare function getSelectedProductOptions(request: Request): SelectedOptionInput[];
 declare const IMAGES_PLACEHOLDERS: {
     logo_white: string;
@@ -359,4 +408,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type AllCacheOptions, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type PublicEnv, type RouteLoaderArgs, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, isValidHydrogenSchema, registerComponent, useThemeSettings, withWeaverse };
+export { type AllCacheOptions, type CacheResponseValidator, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, isFetchProjectPayload, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, withWeaverse };