@appstrata/dev 0.1.0

package/dist/logging-hmr.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Logging HMR handler for AppStrata apps.
+ *
+ * Injected by the Vite plugin during `serve` for both "embedded" and "none"
+ * player modes. Keeps the app's logging configuration in sync when
+ * `app.logging` or `dev.logging` changes in `appstrata.config.ts`.
+ *
+ * This is a standalone concern — separate from the Dev Player — because
+ * logging configuration is owned by the plugin (which injects the logging
+ * IIFE and profiles JSON tag), not by the player.
+ *
+ * Note on `dev.logging`: this module reconfigures both `app.logging`
+ * (profiles) and `dev.logging` (active preset), but the `dev.logging`
+ * path is only meaningful for the embedded player. In standalone mode,
+ * `dev.logging` is delivered via URL params on the iframe src, and the
+ * standalone player handles changes by reloading the iframe with updated
+ * params — so this module's `dev.logging` update is redundant in that case.
+ */
+export {};
+//# sourceMappingURL=logging-hmr.d.ts.map

package/dist/logging-hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-hmr.d.ts","sourceRoot":"","sources":["../src/logging-hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/logging-hmr.js

@@ -0,0 +1,28 @@
+/**
+ * Logging HMR handler for AppStrata apps.
+ *
+ * Injected by the Vite plugin during `serve` for both "embedded" and "none"
+ * player modes. Keeps the app's logging configuration in sync when
+ * `app.logging` or `dev.logging` changes in `appstrata.config.ts`.
+ *
+ * This is a standalone concern — separate from the Dev Player — because
+ * logging configuration is owned by the plugin (which injects the logging
+ * IIFE and profiles JSON tag), not by the player.
+ *
+ * Note on `dev.logging`: this module reconfigures both `app.logging`
+ * (profiles) and `dev.logging` (active preset), but the `dev.logging`
+ * path is only meaningful for the embedded player. In standalone mode,
+ * `dev.logging` is delivered via URL params on the iframe src, and the
+ * standalone player handles changes by reloading the iframe with updated
+ * params — so this module's `dev.logging` update is redundant in that case.
+ */
+/// <reference types="vite/client" />
+import { configureLogging } from "@appstrata/core";
+import { buildLoggingConfig } from "@appstrata/utils";
+import { CONFIG_CHANGE_EVENT } from "./types.js";
+if (import.meta.hot) {
+    import.meta.hot.on(CONFIG_CHANGE_EVENT, (data) => {
+        configureLogging(buildLoggingConfig({ profiles: data.app?.logging, preset: data.dev?.logging }));
+    });
+}
+//# sourceMappingURL=logging-hmr.js.map

package/dist/logging-hmr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-hmr.js","sourceRoot":"","sources":["../src/logging-hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qCAAqC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAkC,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,IAA4H,EAAE,EAAE;QACvK,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mock-init.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mock Player Initialization for AppStrata Development.
+ *
+ * This module is loaded as a virtual module by the Vite plugin.
+ * It fetches mock context from the dev server and initializes a mock player
+ * using createAppHost from @appstrata/player-lib.
+ */
+export {};
+//# sourceMappingURL=mock-init.d.ts.map

package/dist/mock-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-init.d.ts","sourceRoot":"","sources":["../src/mock-init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/mock-init.js

@@ -0,0 +1,171 @@
+/**
+ * Mock Player Initialization for AppStrata Development.
+ *
+ * This module is loaded as a virtual module by the Vite plugin.
+ * It fetches mock context from the dev server and initializes a mock player
+ * using createAppHost from @appstrata/player-lib.
+ */
+/// <reference types="vite/client" />
+import { createMockPlayer, buildAppContext, buildCapabilityServices, resolveCapabilities, } from "./mock-player.js";
+import { showCompletionNotification } from "./completion-notification.js";
+import { createDevOverlay } from "./dev-overlay.js";
+import { createInterceptingTransport } from "./intercepting-transport.js";
+import { createPostMessageTransport } from "@appstrata/protocol";
+import { createLogger } from "@appstrata/core";
+import { scaleToFit, setDocumentResolution } from "@appstrata/utils";
+import { CONFIG_CHANGE_EVENT } from "./types.js";
+if (window.parent !== window) {
+    throw new Error("[AppStrata] The embedded dev player cannot run inside an iframe. " +
+        "This usually means the standalone dev player loaded an app that has the " +
+        "appstrata() Vite plugin enabled in embedded mode. To fix, set " +
+        '`player: "none"` in the appstrata() plugin config when using the standalone player.');
+}
+const logger = createLogger("EmbeddedDevPlayer");
+logger.info("Initializing the development mock player...");
+// Fetch configuration from dev server
+const response = await fetch("/__appstrata__/context");
+const { context: contextConfig, capabilities: capabilityConfig, lifecycle, app, dev: devConfig } = (await response.json());
+const overlay = createDevOverlay({
+    container: document.body,
+    measureElement: document.documentElement,
+    context: { ...contextConfig, autoZoom: app?.autoZoom },
+    dropLogMessages: !(devConfig?.messages?.showLogMessages ?? false),
+});
+// Create transport with interceptor so the overlay can track messages
+const rawTransport = createPostMessageTransport({ targetWindow: window });
+const transport = createInterceptingTransport(rawTransport, (msg, dir) => {
+    overlay.logMessage(dir, msg);
+});
+// Create mock player
+const host = createMockPlayer({
+    capabilities: capabilityConfig,
+    transport,
+    notifyComplete: () => {
+        logger.info("App called notifyComplete()");
+        const hideDelay = lifecycle?.hideDelay ?? 100;
+        const stopDelay = lifecycle?.stopDelay ?? 50;
+        setTimeout(() => {
+            logger.debug("fireHide");
+            host.fireHide();
+        }, hideDelay);
+        setTimeout(() => {
+            logger.debug("fireStop");
+            host.fireStop();
+        }, hideDelay + stopDelay);
+    },
+    notifyEstimatedEnd: (expectedFinishTime) => {
+        const secsUntil = Math.round((expectedFinishTime - Date.now()) / 1000);
+        logger.info(`App called notifyEstimatedEnd() — finishes in ~${secsUntil}s (${new Date(expectedFinishTime).toISOString()})`);
+    },
+    notifyNoContent: (options) => {
+        const parts = ["App called notifyNoContent()"];
+        if (options?.reason)
+            parts.push(`reason="${options.reason}"`);
+        if (options?.retryNotBefore) {
+            const secsUntil = Math.round((options.retryNotBefore - Date.now()) / 1000);
+            parts.push(`retry in ~${secsUntil}s`);
+        }
+        logger.info(parts.join(" — "));
+        const hideDelay = lifecycle?.hideDelay ?? 100;
+        const stopDelay = lifecycle?.stopDelay ?? 50;
+        setTimeout(() => {
+            logger.debug("fireHide");
+            host.fireHide();
+        }, hideDelay);
+        setTimeout(() => {
+            logger.debug("fireStop");
+            host.fireStop();
+        }, hideDelay + stopDelay);
+    },
+    log: (level, message, data) => {
+        console[level](`[Embedded Dev Player Log Service] ${message}`, data !== undefined ? data : "");
+    },
+});
+host.player.onStop(() => {
+    overlay.setCompleted();
+    showCompletionNotification();
+});
+// Build initial AppContext
+const capabilities = resolveCapabilities(capabilityConfig);
+const appContext = buildAppContext(contextConfig, capabilities);
+// Fire lifecycle events with configured timing
+const initDelay = lifecycle.initDelay ?? 0;
+const showDelay = lifecycle.showDelay ?? 50;
+const startDelay = lifecycle.startDelay ?? 50;
+setTimeout(() => {
+    logger.debug("fireInit");
+    host.fireInit(appContext);
+}, initDelay);
+setTimeout(() => {
+    logger.debug("fireShow");
+    host.fireShow();
+}, initDelay + showDelay);
+setTimeout(() => {
+    logger.debug("fireStart");
+    host.fireStart();
+}, initDelay + showDelay + startDelay);
+let autoZoomCleanup = null;
+function applyAutoZoom(mode, targetWidth, targetHeight) {
+    if (autoZoomCleanup) {
+        autoZoomCleanup();
+        autoZoomCleanup = null;
+    }
+    if (!mode || mode === 'none')
+        return;
+    const el = document.documentElement;
+    let apply;
+    let reset;
+    switch (mode) {
+        case 'contain':
+        case 'cover':
+            apply = () => scaleToFit(el, el.clientWidth, el.clientHeight, targetWidth, targetHeight, mode);
+            reset = () => scaleToFit(el);
+            break;
+        case 'auto-width': {
+            apply = () => {
+                const portrait = el.clientWidth < el.clientHeight;
+                const designPortrait = targetWidth < targetHeight;
+                const [tw, th] = (portrait !== designPortrait)
+                    ? [targetHeight, targetWidth]
+                    : [targetWidth, targetHeight];
+                setDocumentResolution(tw, th, 'width');
+            };
+            reset = () => setDocumentResolution();
+            break;
+        }
+        default:
+            apply = () => setDocumentResolution(targetWidth, targetHeight, mode);
+            reset = () => setDocumentResolution();
+            break;
+    }
+    apply();
+    window.addEventListener("resize", apply);
+    autoZoomCleanup = () => {
+        window.removeEventListener("resize", apply);
+        reset();
+    };
+}
+applyAutoZoom(app?.autoZoom, contextConfig.viewportWidth || 1920, contextConfig.viewportHeight || 1080);
+window.addEventListener("resize", () => overlay.flashResizeToast());
+// Listen for HMR context changes
+if (import.meta.hot) {
+    import.meta.hot.on(CONFIG_CHANGE_EVENT, (data) => {
+        // console.info (not logger) so E2E tests can always detect HMR events
+        // regardless of the active log level.
+        console.log(">> [EmbeddedDevPlayer] Config changed via HMR");
+        // Resolve new capabilities and hot-swap services
+        const newCapabilities = resolveCapabilities(data.capabilities);
+        const newServices = buildCapabilityServices(newCapabilities);
+        host.updateServices(newServices);
+        // Build new context and update
+        const newContext = buildAppContext(data.context, newCapabilities);
+        host.updateContext(newContext);
+        overlay.updateContext({ ...data.context, autoZoom: data.app?.autoZoom });
+        overlay.setDropLogMessages(!(data.dev?.messages?.showLogMessages ?? false));
+        applyAutoZoom(data.app?.autoZoom, data.context.viewportWidth || 1920, data.context.viewportHeight || 1080);
+    });
+}
+logger.info("Mock player ready");
+logger.debug("Context", appContext);
+logger.debug("Capabilities", capabilities);
+//# sourceMappingURL=mock-init.js.map

package/dist/mock-init.js.map

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

package/dist/mock-player.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Mock player creation for development mode.
+ *
+ * Uses createAppHost from @appstrata/player-lib with mock services.
+ * Provides composable helpers for building mock contexts and capabilities.
+ */
+import type { AppContext, DeviceInfo, Capability, LogLevel } from "@appstrata/core";
+import { type AppHost, type CapabilityServices } from "@appstrata/player-lib";
+import type { Transport } from "@appstrata/protocol";
+import type { DevContextConfig, LifecycleConfig } from "./types.js";
+/**
+ * Configuration for creating a mock player.
+ */
+export interface MockPlayerConfig {
+    /**
+     * Enabled capabilities.
+     * @default ["storage", "proxy"]
+     */
+    capabilities?: string[];
+    /**
+     * Lifecycle timing configuration.
+     */
+    lifecycle?: LifecycleConfig;
+    /**
+     * Target window for communication.
+     * @default window
+     */
+    target?: Window;
+    /**
+     * Target origin for postMessage transport.
+     * @default "*"
+     */
+    targetOrigin?: string;
+    /**
+     * Pre-created transport to use instead of the default postMessage transport.
+     * When provided, `target` and `targetOrigin` are ignored for transport creation.
+     */
+    transport?: Transport;
+    /**
+     * Callback when app calls notifyComplete().
+     */
+    notifyComplete: () => void;
+    /**
+     * Callback when app calls notifyEstimatedEnd().
+     */
+    notifyEstimatedEnd: (expectedFinishTime: number) => void;
+    /**
+     * Callback when app calls notifyNoContent().
+     */
+    notifyNoContent: (options?: {
+        retryNotBefore?: number;
+        reason?: string;
+    }) => void;
+    /**
+     * Callback for app logging.
+     */
+    log: (level: LogLevel, message: string, data?: unknown) => void;
+}
+/**
+ * Build device info by merging defaults with user config.
+ *
+ * @param deviceConfig - Partial device configuration from user
+ * @returns Complete DeviceInfo object
+ */
+export declare function buildDevice(deviceConfig?: Partial<DeviceInfo>): DeviceInfo;
+/**
+ * Resolve capabilities from config into a list of enabled capabilities.
+ *
+ * @param capabilities - Capability config (can be undefined, ["all"], or specific list)
+ * @returns Array of enabled capability names
+ *
+ * @example
+ * ```typescript
+ * resolveCapabilities(["all"]) // => ["storage", "proxy", "mediaCache", "static"]
+ * resolveCapabilities(["storage"]) // => ["storage"]
+ * resolveCapabilities() // => ["storage", "proxy"] (default)
+ * ```
+ */
+export declare function resolveCapabilities(capabilities?: string[]): Capability[];
+/**
+ * Create capability services based on enabled capabilities.
+ *
+ * @param capabilities - List of capabilities to enable
+ * @returns Object with initialized service APIs
+ */
+export declare function buildCapabilityServices(capabilities: Capability[]): CapabilityServices;
+/**
+ * Build AppContext from dev configuration and capabilities.
+ *
+ * @param config - Context configuration from appstrata.config.ts
+ * @param capabilities - List of enabled capabilities
+ * @returns Complete AppContext object
+ *
+ */
+export declare function buildAppContext(config: DevContextConfig, capabilities: Capability[]): AppContext;
+/**
+ * Create a mock player for development.
+ *
+ * This creates an AppHost using the player-lib factory with mock services.
+ * The AppHost can be used to fire lifecycle events and update context.
+ *
+ * @param config - Mock player configuration
+ * @returns AppHost instance
+ *
+ * @example
+ * ```typescript
+ * const host = createMockPlayer({
+ *   target: iframe.contentWindow,
+ *   targetOrigin: "http://localhost:3000",
+ *   capabilities: ["storage", "proxy"],
+ *   notifyComplete: () => {},
+ *   log: (level, msg) => console.log(msg),
+ * });
+ * ```
+ */
+export declare function createMockPlayer(config: MockPlayerConfig): AppHost;
+//# sourceMappingURL=mock-player.d.ts.map

package/dist/mock-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-player.d.ts","sourceRoot":"","sources":["../src/mock-player.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;OAEG;IACH,kBAAkB,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAElF;;OAEG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAcD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAQ1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAWzE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAoBtF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,UAAU,EAAE,GACzB,UAAU,CAKZ;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CA6BlE"}

package/dist/mock-player.js

@@ -0,0 +1,132 @@
+/**
+ * Mock player creation for development mode.
+ *
+ * Uses createAppHost from @appstrata/player-lib with mock services.
+ * Provides composable helpers for building mock contexts and capabilities.
+ */
+import { createAppHost } from "@appstrata/player-lib";
+import { createMockStorage, createMockProxy, createMockMediaCache, createMockStatic, } from "./mock-services.js";
+/**
+ * Default device info for development.
+ */
+const DEFAULT_DEVICE = {
+    id: "dev-player",
+    name: "Development Player",
+    type: "web-player",
+    platformName: "AppStrata Dev",
+    locale: "en-US",
+    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+};
+/**
+ * Build device info by merging defaults with user config.
+ *
+ * @param deviceConfig - Partial device configuration from user
+ * @returns Complete DeviceInfo object
+ */
+export function buildDevice(deviceConfig) {
+    return {
+        ...DEFAULT_DEVICE,
+        ...deviceConfig,
+        // Ensure required fields are present
+        locale: deviceConfig?.locale || DEFAULT_DEVICE.locale,
+        timezone: deviceConfig?.timezone || DEFAULT_DEVICE.timezone,
+    };
+}
+/**
+ * Resolve capabilities from config into a list of enabled capabilities.
+ *
+ * @param capabilities - Capability config (can be undefined, ["all"], or specific list)
+ * @returns Array of enabled capability names
+ *
+ * @example
+ * ```typescript
+ * resolveCapabilities(["all"]) // => ["storage", "proxy", "mediaCache", "static"]
+ * resolveCapabilities(["storage"]) // => ["storage"]
+ * resolveCapabilities() // => ["storage", "proxy"] (default)
+ * ```
+ */
+export function resolveCapabilities(capabilities) {
+    if (!capabilities || capabilities.length === 0) {
+        // Default: enable storage and proxy
+        return ["storage", "proxy"];
+    }
+    if (capabilities.includes("all")) {
+        return ["storage", "proxy", "mediaCache", "static"];
+    }
+    return capabilities;
+}
+/**
+ * Create capability services based on enabled capabilities.
+ *
+ * @param capabilities - List of capabilities to enable
+ * @returns Object with initialized service APIs
+ */
+export function buildCapabilityServices(capabilities) {
+    const services = {};
+    if (capabilities.includes("storage")) {
+        services.storage = createMockStorage();
+    }
+    if (capabilities.includes("proxy")) {
+        services.proxy = createMockProxy();
+    }
+    if (capabilities.includes("mediaCache")) {
+        services.mediaCache = createMockMediaCache();
+    }
+    if (capabilities.includes("static")) {
+        services.static = createMockStatic();
+    }
+    return services;
+}
+/**
+ * Build AppContext from dev configuration and capabilities.
+ *
+ * @param config - Context configuration from appstrata.config.ts
+ * @param capabilities - List of enabled capabilities
+ * @returns Complete AppContext object
+ *
+ */
+export function buildAppContext(config, capabilities) {
+    return {
+        ...config,
+        hasCapability: (cap) => capabilities.includes(cap),
+    };
+}
+/**
+ * Create a mock player for development.
+ *
+ * This creates an AppHost using the player-lib factory with mock services.
+ * The AppHost can be used to fire lifecycle events and update context.
+ *
+ * @param config - Mock player configuration
+ * @returns AppHost instance
+ *
+ * @example
+ * ```typescript
+ * const host = createMockPlayer({
+ *   target: iframe.contentWindow,
+ *   targetOrigin: "http://localhost:3000",
+ *   capabilities: ["storage", "proxy"],
+ *   notifyComplete: () => {},
+ *   log: (level, msg) => console.log(msg),
+ * });
+ * ```
+ */
+export function createMockPlayer(config) {
+    const { capabilities, target = window, targetOrigin, transport, notifyComplete, notifyEstimatedEnd, notifyNoContent, log, } = config;
+    // Resolve capabilities and create services
+    const enabledCapabilities = resolveCapabilities(capabilities);
+    const services = buildCapabilityServices(enabledCapabilities);
+    // Create the AppHost (same factory used by real players)
+    const host = createAppHost({
+        services,
+        target,
+        notifyComplete,
+        notifyEstimatedEnd,
+        notifyNoContent,
+        log,
+        ...(transport !== undefined && { transport }),
+        ...(targetOrigin !== undefined && { targetOrigin }),
+    });
+    return host;
+}
+//# sourceMappingURL=mock-player.js.map

package/dist/mock-player.js.map

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

package/dist/mock-services.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Mock implementations of capability services for development.
+ */
+import type { StorageApi, ProxyApi, MediaCacheApi, StaticApi } from "@appstrata/core";
+/**
+ * Create an in-memory mock storage service.
+ *
+ * Data is stored in a Map and persists only for the current page session.
+ * Refreshing the page clears all storage.
+ */
+export declare function createMockStorage(): StorageApi;
+/**
+ * Create a passthrough mock proxy service.
+ *
+ * Uses native fetch directly. In dev mode, Vite's dev server can be configured
+ * to proxy API requests if CORS is an issue.
+ */
+export declare function createMockProxy(): ProxyApi;
+/**
+ * Create a mock media cache service.
+ *
+ * In dev mode, media files are not actually cached locally.
+ * This mock returns the original URLs as "local paths".
+ */
+export declare function createMockMediaCache(): MediaCacheApi;
+/**
+ * Create a mock static API service.
+ *
+ * In dev mode, static optimization is disabled (no screenshots taken).
+ */
+export declare function createMockStatic(): StaticApi;
+//# sourceMappingURL=mock-services.d.ts.map

package/dist/mock-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-services.d.ts","sourceRoot":"","sources":["../src/mock-services.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EAGR,aAAa,EAGb,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAwB9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CA8C1C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAgDpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAW5C"}