@qvac/sdk 0.8.0 → 1.0.0

package/dist/client/api/registry.js

@@ -1,37 +0,0 @@
-import { send } from "../rpc/rpc-client.js";
-import { ModelRegistryQueryFailedError } from "../../utils/errors-client.js";
-function validateRegistryResponse(response, fallbackError) {
-    if (!response.success) {
-        throw new ModelRegistryQueryFailedError(response.error ?? fallbackError ?? "Unknown registry error");
-    }
-}
-async function modelRegistryList() {
-    const request = {
-        type: "modelRegistryList",
-    };
-    const response = (await send(request));
-    validateRegistryResponse(response);
-    return response.models;
-}
-async function modelRegistrySearch(params = {}) {
-    const { modelType, ...rest } = params;
-    const request = {
-        type: "modelRegistrySearch",
-        ...rest,
-        addon: modelType ?? rest.addon,
-    };
-    const response = (await send(request));
-    validateRegistryResponse(response);
-    return response.models;
-}
-async function modelRegistryGetModel(registryPath, registrySource) {
-    const request = {
-        type: "modelRegistryGetModel",
-        registryPath,
-        registrySource,
-    };
-    const response = (await send(request));
-    validateRegistryResponse(response, `Model not found: ${registrySource}/${registryPath}`);
-    return response.model;
-}
-export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel };

package/dist/client/config-loader/config-utils.d.ts

@@ -1,5 +0,0 @@
-import { type QvacConfig } from "../../schemas/index";
-export type { QvacConfig };
-export declare function validateConfig(config: unknown): QvacConfig;
-export declare function parseJsonConfig(content: string, filePath: string): unknown;
-//# sourceMappingURL=config-utils.d.ts.map

package/dist/client/config-loader/config-utils.js

@@ -1,20 +0,0 @@
-import { qvacConfigSchema } from "../../schemas/index.js";
-import { ConfigValidationFailedError } from "../../utils/errors-client.js";
-export function validateConfig(config) {
-    const result = qvacConfigSchema.safeParse(config);
-    if (!result.success) {
-        const errors = result.error.issues
-            .map((e) => `${String(e.path.join("."))}:  ${e.message}`)
-            .join(", ");
-        throw new ConfigValidationFailedError(errors);
-    }
-    return result.data;
-}
-export function parseJsonConfig(content, filePath) {
-    try {
-        return JSON.parse(content);
-    }
-    catch {
-        throw new ConfigValidationFailedError(`Invalid JSON in config file: ${filePath}`);
-    }
-}

package/dist/client/config-loader/resolve-config.bare.d.ts

@@ -1,9 +0,0 @@
-import { type QvacConfig } from "./config-utils";
-/**
- * Resolution order for Bare:
- * 1. QVAC_CONFIG_PATH environment variable
- * 2. Config file in project root (qvac.config.ts, qvac.config.js, qvac.config.json)
- * 3. SDK defaults
- */
-export declare function resolveConfig(): Promise<QvacConfig | undefined>;
-//# sourceMappingURL=resolve-config.bare.d.ts.map

package/dist/client/config-loader/resolve-config.bare.js

@@ -1,87 +0,0 @@
-/**
- * Config loader for Bare runtime
- * Uses bare-fs and bare-path modules
- */
-import fs from "bare-fs";
-import path from "bare-path";
-import process from "bare-process";
-import { validateConfig, parseJsonConfig, } from "./config-utils.js";
-import { ConfigFileParseFailedError } from "../../utils/errors-client.js";
-import { getClientLogger } from "../../logging/index.js";
-const logger = getClientLogger();
-function findProjectRoot() {
-    return process.cwd();
-}
-function fileExists(filePath) {
-    return fs.existsSync(filePath);
-}
-function readFile(filePath) {
-    const result = fs.readFileSync(filePath, "utf-8");
-    return typeof result === "string" ? result : result.toString("utf-8");
-}
-function loadJsonConfig(filePath) {
-    const content = readFile(filePath);
-    const parsed = parseJsonConfig(content, filePath);
-    return validateConfig(parsed);
-}
-async function loadJsConfig(filePath) {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const configModule = await import(filePath);
-        return validateConfig(configModule.default || configModule);
-    }
-    catch (error) {
-        throw new ConfigFileParseFailedError(filePath, error instanceof Error ? error.message : String(error), error);
-    }
-}
-function findConfigFile(searchDir) {
-    const configFiles = [
-        { name: "qvac.config.ts", type: "ts" },
-        { name: "qvac.config.js", type: "js" },
-        { name: "qvac.config.json", type: "json" },
-    ];
-    for (const { name, type } of configFiles) {
-        const filePath = path.resolve(searchDir, name);
-        if (fileExists(filePath)) {
-            return { path: filePath, type };
-        }
-    }
-    return undefined;
-}
-/**
- * Resolution order for Bare:
- * 1. QVAC_CONFIG_PATH environment variable
- * 2. Config file in project root (qvac.config.ts, qvac.config.js, qvac.config.json)
- * 3. SDK defaults
- */
-export async function resolveConfig() {
-    const configPath = process.env["QVAC_CONFIG_PATH"];
-    if (configPath) {
-        const normalizedPath = path.resolve(configPath);
-        if (fileExists(normalizedPath)) {
-            const ext = normalizedPath.endsWith(".json")
-                ? "json"
-                : normalizedPath.endsWith(".ts")
-                    ? "ts"
-                    : "js";
-            const config = ext === "json"
-                ? loadJsonConfig(normalizedPath)
-                : await loadJsConfig(normalizedPath);
-            logger.info(`✅ Loaded config from: ${normalizedPath}`);
-            return config;
-        }
-    }
-    const projectRoot = findProjectRoot();
-    if (projectRoot) {
-        const configFile = findConfigFile(projectRoot);
-        if (configFile) {
-            const config = configFile.type === "json"
-                ? loadJsonConfig(configFile.path)
-                : await loadJsConfig(configFile.path);
-            logger.info(`✅ Loaded config from: ${configFile.path}`);
-            return config;
-        }
-    }
-    logger.info("ℹ️ No config file found, using SDK defaults");
-    return undefined;
-}

package/dist/client/config-loader/resolve-config.expo.d.ts

@@ -1,11 +0,0 @@
-import { type QvacConfig } from "./config-utils";
-/**
- * Resolution order for Expo:
- * 1. QVAC_CONFIG_PATH environment variable (if set)
- * 2. Default Expo path: ${Paths.document.uri}qvac.config.json
- * 3. SDK defaults
- *
- * Note: Only JSON config files are supported in React Native
- */
-export declare function resolveConfig(): Promise<QvacConfig | undefined>;
-//# sourceMappingURL=resolve-config.expo.d.ts.map

package/dist/client/config-loader/resolve-config.expo.js

@@ -1,62 +0,0 @@
-/**
- * Config loader for Expo/React Native runtime
- * Only uses expo-file-system - no Node.js or Bare imports
- */
-import { File, Paths } from "expo-file-system";
-import { validateConfig, parseJsonConfig, } from "./config-utils.js";
-import { getClientLogger } from "../../logging/index.js";
-const logger = getClientLogger();
-function fileExists(filePath) {
-    try {
-        const file = new File(filePath);
-        return file.exists;
-    }
-    catch {
-        return false;
-    }
-}
-async function readFile(filePath) {
-    const file = new File(filePath);
-    return await file.text();
-}
-async function loadJsonConfig(filePath) {
-    const content = await readFile(filePath);
-    const parsed = parseJsonConfig(content, filePath);
-    return validateConfig(parsed);
-}
-/**
- * Resolution order for Expo:
- * 1. QVAC_CONFIG_PATH environment variable (if set)
- * 2. Default Expo path: ${Paths.document.uri}qvac.config.json
- * 3. SDK defaults
- *
- * Note: Only JSON config files are supported in React Native
- */
-export async function resolveConfig() {
-    // Check environment variable first
-    const configPath = typeof process !== "undefined"
-        ? process.env?.["QVAC_CONFIG_PATH"]
-        : undefined;
-    if (configPath) {
-        if (fileExists(configPath)) {
-            logger.info(`✅ Loaded config from: ${configPath}`);
-            return await loadJsonConfig(configPath);
-        }
-    }
-    // Try default Expo document directory path
-    try {
-        const documentDir = Paths.document.uri;
-        if (documentDir) {
-            const defaultExpoConfigPath = `${documentDir}qvac.config.json`;
-            if (fileExists(defaultExpoConfigPath)) {
-                logger.info(`✅ Loaded config from: ${defaultExpoConfigPath}`);
-                return await loadJsonConfig(defaultExpoConfigPath);
-            }
-        }
-    }
-    catch {
-        // Paths not available
-    }
-    logger.info("ℹ️ No config file found, using SDK defaults");
-    return undefined;
-}

package/dist/client/config-loader/resolve-config.node.d.ts

@@ -1,10 +0,0 @@
-import { type QvacConfig } from "./config-utils";
-/**
- * Resolution order for Node.js:
- * 1. QVAC_CONFIG_PATH environment variable
- * 2. Packaged Electron app (via process.resourcesPath)
- * 3. Config file in project root (qvac.config.ts, qvac.config.js, qvac.config.json)
- * 4. SDK defaults
- */
-export declare function resolveConfig(): Promise<QvacConfig | undefined>;
-//# sourceMappingURL=resolve-config.node.d.ts.map

package/dist/client/config-loader/resolve-config.node.js

@@ -1,145 +0,0 @@
-/**
- * Config loader for Node.js runtime
- * Uses Node.js fs/promises and path modules
- */
-import { promises as fs } from "fs";
-import path from "path";
-import { pathToFileURL } from "url";
-import { validateConfig, parseJsonConfig, } from "./config-utils.js";
-import { ConfigFileParseFailedError } from "../../utils/errors-client.js";
-import { getClientLogger } from "../../logging/index.js";
-const logger = getClientLogger();
-async function findProjectRoot() {
-    try {
-        let currentDir = path.resolve(process.cwd());
-        const root = path.parse(currentDir).root;
-        while (currentDir !== root) {
-            try {
-                const packageJsonPath = path.join(currentDir, "package.json");
-                await fs.access(packageJsonPath);
-                return currentDir;
-            }
-            catch {
-                const parentDir = path.dirname(currentDir);
-                if (parentDir === currentDir) {
-                    break;
-                }
-                currentDir = parentDir;
-            }
-        }
-    }
-    catch (error) {
-        logger.debug("Project root search failed, using cwd:", { error });
-    }
-    return process.cwd();
-}
-async function fileExists(filePath) {
-    try {
-        await fs.access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function readFile(filePath) {
-    return await fs.readFile(filePath, { encoding: "utf-8" });
-}
-async function loadJsonConfig(filePath) {
-    const content = await readFile(filePath);
-    const parsed = parseJsonConfig(content, filePath);
-    return validateConfig(parsed);
-}
-async function loadJsConfig(filePath) {
-    try {
-        let importPath = filePath;
-        // Windows requires file:// URLs for dynamic imports
-        if (process.platform === "win32" && !process.env["JEST_WORKER_ID"]) {
-            importPath = pathToFileURL(filePath).toString();
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const configModule = await import(importPath);
-        return validateConfig(configModule.default || configModule);
-    }
-    catch (error) {
-        throw new ConfigFileParseFailedError(filePath, error instanceof Error ? error.message : String(error), error);
-    }
-}
-async function findConfigFile(searchDir) {
-    const configFiles = [
-        { name: "qvac.config.ts", type: "ts" },
-        { name: "qvac.config.js", type: "js" },
-        { name: "qvac.config.json", type: "json" },
-    ];
-    for (const { name, type } of configFiles) {
-        const filePath = path.resolve(searchDir, name);
-        if (await fileExists(filePath)) {
-            return { path: filePath, type };
-        }
-    }
-    return undefined;
-}
-function getResourcesPath() {
-    const { resourcesPath } = process;
-    return typeof resourcesPath === "string" ? resourcesPath : undefined;
-}
-async function findPackagedConfig() {
-    const resourcesPath = getResourcesPath();
-    if (!resourcesPath)
-        return undefined;
-    const candidates = [
-        path.join(resourcesPath, "app", "qvac.config.json"),
-        path.join(resourcesPath, "app.asar.unpacked", "qvac.config.json"),
-        path.join(resourcesPath, "qvac.config.json"),
-    ];
-    for (const candidate of candidates) {
-        if (await fileExists(candidate)) {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-/**
- * Resolution order for Node.js:
- * 1. QVAC_CONFIG_PATH environment variable
- * 2. Packaged Electron app (via process.resourcesPath)
- * 3. Config file in project root (qvac.config.ts, qvac.config.js, qvac.config.json)
- * 4. SDK defaults
- */
-export async function resolveConfig() {
-    const configPath = process.env["QVAC_CONFIG_PATH"];
-    if (configPath) {
-        const normalizedPath = path.resolve(configPath);
-        if (await fileExists(normalizedPath)) {
-            const ext = normalizedPath.endsWith(".json")
-                ? "json"
-                : normalizedPath.endsWith(".ts")
-                    ? "ts"
-                    : "js";
-            const config = ext === "json"
-                ? await loadJsonConfig(normalizedPath)
-                : await loadJsConfig(normalizedPath);
-            logger.info(`✅ Loaded config from: ${normalizedPath}`);
-            return config;
-        }
-    }
-    const packagedConfig = await findPackagedConfig();
-    if (packagedConfig) {
-        const config = await loadJsonConfig(packagedConfig);
-        logger.info(`✅ Loaded config from packaged app: ${packagedConfig}`);
-        return config;
-    }
-    const projectRoot = await findProjectRoot();
-    if (projectRoot) {
-        const configFile = await findConfigFile(projectRoot);
-        if (configFile) {
-            const config = configFile.type === "json"
-                ? await loadJsonConfig(configFile.path)
-                : await loadJsConfig(configFile.path);
-            logger.info(`✅ Loaded config from: ${configFile.path}`);
-            return config;
-        }
-    }
-    logger.info("ℹ️ No config file found, using SDK defaults");
-    return undefined;
-}

package/dist/client/init-hooks.d.ts

@@ -1,21 +0,0 @@
-import type { QvacConfig, RuntimeContext } from "../schemas/index";
-type ResolveConfigFn = () => Promise<QvacConfig | undefined>;
-interface RPCClient {
-    request(command: number): any;
-}
-/**
- * Initializes SDK configuration and runtime context.
- * Config is loaded once and becomes immutable on the worker side.
- *
- * @param rpc - The RPC client instance
- * @param resolveConfig - Runtime-specific config resolver function
- * @param runtimeContext - Optional runtime context (platform, device info)
- */
-export declare function initializeConfig(rpc: RPCClient, resolveConfig: ResolveConfigFn, runtimeContext?: RuntimeContext): Promise<void>;
-/**
- * Legacy function for backward compatibility
- * @deprecated Use initializeConfig instead
- */
-export declare function replayConfigIfCached(): void;
-export {};
-//# sourceMappingURL=init-hooks.d.ts.map

package/dist/client/init-hooks.js

@@ -1,66 +0,0 @@
-import { getClientLogger, setGlobalLogLevel, setGlobalConsoleOutput, } from "../logging/index.js";
-import { SetConfigFailedError } from "../utils/errors-client.js";
-const logger = getClientLogger();
-function applyClientLoggerSettings(config) {
-    if (config.loggerLevel !== undefined) {
-        setGlobalLogLevel(config.loggerLevel);
-    }
-    if (config.loggerConsoleOutput !== undefined) {
-        setGlobalConsoleOutput(config.loggerConsoleOutput);
-    }
-}
-async function sendInitMessage(rpc, config, runtimeContext) {
-    const initMessage = {
-        type: "__init_config",
-        config,
-        runtimeContext,
-    };
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    const req = rpc.request(1);
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-    req.send(JSON.stringify(initMessage), "utf8");
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-    const response = await req.reply("utf8");
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-argument
-    const parsed = JSON.parse(response.toString());
-    if (!parsed.success) {
-        throw new SetConfigFailedError(parsed.error ?? "Unknown error");
-    }
-}
-/**
- * Initializes SDK configuration and runtime context.
- * Config is loaded once and becomes immutable on the worker side.
- *
- * @param rpc - The RPC client instance
- * @param resolveConfig - Runtime-specific config resolver function
- * @param runtimeContext - Optional runtime context (platform, device info)
- */
-export async function initializeConfig(rpc, resolveConfig, runtimeContext) {
-    const config = await resolveConfig();
-    // Nothing to initialize
-    if (!config && !runtimeContext) {
-        return;
-    }
-    // Apply client-side logger settings
-    if (config) {
-        applyClientLoggerSettings(config);
-        logger.info("📦 Initializing SDK config");
-    }
-    if (runtimeContext) {
-        logger.info("📱 Runtime context:", runtimeContext);
-    }
-    try {
-        await sendInitMessage(rpc, config, runtimeContext);
-        logger.info("✅ Initialization complete");
-    }
-    catch (error) {
-        logger.error("❌ Initialization failed:", error);
-    }
-}
-/**
- * Legacy function for backward compatibility
- * @deprecated Use initializeConfig instead
- */
-export function replayConfigIfCached() {
-    logger.warn("⚠️ replayConfigIfCached is deprecated and has no effect. Config is now loaded from file during initialization.");
-}

package/dist/client/rpc/expo-device-info.d.ts

@@ -1,6 +0,0 @@
-export declare function getDeviceInfo(): Promise<{
-    platform: "android" | "ios" | undefined;
-    deviceModel: string | undefined;
-    deviceBrand: string | undefined;
-}>;
-//# sourceMappingURL=expo-device-info.d.ts.map

package/dist/client/rpc/expo-device-info.js

@@ -1,32 +0,0 @@
-import { getClientLogger } from "../../logging/index.js";
-const logger = getClientLogger();
-export async function getDeviceInfo() {
-    try {
-        const expoModulesCore = await import("expo-modules-core");
-        // this looks odd, but is necessary to ensure that import can be used safely.
-        // It will crash the app if the module is not installed, but the node dependency is present.
-        const nativeDeviceModule = expoModulesCore.requireOptionalNativeModule("ExpoDevice");
-        if (nativeDeviceModule) {
-            const Device = await import("expo-device");
-            logger.info(`Device: ${Device.modelName} ${Device.brand} ${Device.osName}`);
-            const osName = Device?.osName?.toLowerCase();
-            return {
-                platform: osName?.includes("ios")
-                    ? "ios"
-                    : osName?.includes("android")
-                        ? "android"
-                        : undefined,
-                deviceModel: Device.modelName ?? undefined,
-                deviceBrand: Device.brand ?? undefined,
-            };
-        }
-    }
-    catch {
-        logger.debug("expo-device not available, device info will be omitted");
-    }
-    return {
-        platform: undefined,
-        deviceModel: undefined,
-        deviceBrand: undefined,
-    };
-}

package/dist/client/rpc/profiling/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./profiler";
-//# sourceMappingURL=index.d.ts.map

package/dist/client/rpc/profiling/index.js

@@ -1 +0,0 @@
-export * from "./profiler.js";

package/dist/client/rpc/profiling/profiler.d.ts

@@ -1,27 +0,0 @@
-import { type BaseTimings } from "../../../profiling/index";
-import type { ProfilingResponseMeta } from "../../../schemas/index";
-interface BaseClientTimings extends BaseTimings {
-    requestZodValidationMs?: number;
-    requestStringifyMs?: number;
-    sendStart?: number;
-    requestEnd?: number;
-}
-export interface ClientTimings extends BaseClientTimings {
-    firstResponseAt?: number;
-    responseJsonParseMs?: number;
-    responseZodValidationMs?: number;
-}
-export interface ClientStreamTimings extends BaseClientTimings {
-    firstChunkAt?: number;
-    lastChunkAt?: number;
-    chunkCount: number;
-}
-export declare function createClientTimings(profileId: string, requestType: string): ClientTimings;
-export declare function createClientStreamTimings(profileId: string, requestType: string): ClientStreamTimings;
-export declare function cacheConnectionTime(durationMs: number): void;
-export declare function flushConnectionTime(): void;
-export declare function recordClientEvents(timings: ClientTimings, serverMeta?: ProfilingResponseMeta): void;
-export declare function recordClientStreamEvents(timings: ClientStreamTimings, serverMeta?: ProfilingResponseMeta): void;
-export declare function resetConnectionTracking(): void;
-export {};
-//# sourceMappingURL=profiler.d.ts.map