@getpara/cli 2.15.0

package/dist/diagnostics/checks/chain-dependencies.js

@@ -0,0 +1,130 @@
+import { defineCheck } from "../types.js";
+import { hasDependency, getInstallCommand } from "../utils/package-json.js";
+const EVM_DEPENDENCIES = ["viem", "wagmi"];
+const SOLANA_DEPENDENCIES = ["@solana/web3.js", "@solana/wallet-adapter-react"];
+const COSMOS_DEPENDENCIES = ["@cosmjs/stargate", "graz"];
+const WALLET_CONNECTOR_PATTERNS = [
+  "@getpara/evm-wallet-connectors",
+  "@getpara/solana-wallet-connectors",
+  "@getpara/cosmos-wallet-connectors",
+  "@getpara/bitcoin-wallet-connectors",
+  "@getpara/graz-wallet-connectors",
+  "@getpara/rainbowkit-wallet-connectors"
+];
+const chainDependenciesCheck = defineCheck({
+  metadata: {
+    id: "chain-dependencies",
+    name: "Chain Dependencies",
+    description: "Checks if required chain dependencies are installed",
+    category: "dependencies",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType !== "none" && context.packageJson !== null;
+  },
+  async run(context) {
+    if (!context.packageJson) {
+      return [];
+    }
+    const results = [];
+    if (context.sdkType === "@getpara/react-sdk") {
+      results.push(...checkReactSDKDependencies(context, this.metadata.id));
+    } else if (context.sdkType === "@getpara/react-sdk-lite") {
+      results.push(...checkReactSDKLiteDependencies(context, this.metadata.id));
+    }
+    return results;
+  }
+});
+function checkReactSDKDependencies(context, checkId) {
+  const results = [];
+  const packageJson = context.packageJson;
+  const install = getInstallCommand(context.packageManager);
+  const hasEvm = EVM_DEPENDENCIES.some((dep) => hasDependency(packageJson, dep));
+  if (!hasEvm) {
+    results.push({
+      checkId,
+      passed: false,
+      severity: "warning",
+      message: "EVM chain dependencies not installed",
+      details: `Missing: ${EVM_DEPENDENCIES.join(", ")}`,
+      recommendation: `Install EVM dependencies: ${install} ${EVM_DEPENDENCIES.join(" ")}`
+    });
+  }
+  const hasSolana = SOLANA_DEPENDENCIES.some((dep) => hasDependency(packageJson, dep));
+  if (!hasSolana) {
+    results.push({
+      checkId,
+      passed: false,
+      severity: "warning",
+      message: "Solana chain dependencies not installed",
+      details: `Missing: ${SOLANA_DEPENDENCIES.join(", ")}`,
+      recommendation: `Install Solana dependencies: ${install} ${SOLANA_DEPENDENCIES.join(" ")}`
+    });
+  }
+  const hasCosmos = COSMOS_DEPENDENCIES.some((dep) => hasDependency(packageJson, dep));
+  if (!hasCosmos) {
+    results.push({
+      checkId,
+      passed: false,
+      severity: "warning",
+      message: "Cosmos chain dependencies not installed",
+      details: `Missing: ${COSMOS_DEPENDENCIES.join(", ")}`,
+      recommendation: `Install Cosmos dependencies: ${install} ${COSMOS_DEPENDENCIES.join(" ")}`
+    });
+  }
+  if (hasEvm && hasSolana && hasCosmos) {
+    results.push({
+      checkId,
+      passed: true,
+      severity: "error",
+      message: "All chain dependencies installed"
+    });
+  }
+  return results;
+}
+function checkReactSDKLiteDependencies(context, checkId) {
+  const results = [];
+  const packageJson = context.packageJson;
+  const installedConnectors = WALLET_CONNECTOR_PATTERNS.filter((connector) => hasDependency(packageJson, connector));
+  if (installedConnectors.length === 0) {
+    results.push({
+      checkId,
+      passed: false,
+      severity: "error",
+      message: "No wallet connector packages installed",
+      details: `react-sdk-lite requires at least one @getpara/*-wallet-connectors package`,
+      recommendation: `Install a wallet connector, e.g.: npm install @getpara/evm-wallet-connectors`
+    });
+  } else {
+    results.push({
+      checkId,
+      passed: true,
+      severity: "error",
+      message: `Wallet connector(s) installed: ${installedConnectors.map((c) => c.replace("@getpara/", "")).join(", ")}`
+    });
+  }
+  const postinstallScript = packageJson.scripts?.postinstall || "";
+  const hasSetupPara = postinstallScript.includes("setup-para");
+  if (!hasSetupPara) {
+    results.push({
+      checkId,
+      passed: false,
+      severity: "error",
+      message: "Missing setup-para in postinstall script",
+      details: "react-sdk-lite requires setup-para to stub unused chain packages",
+      recommendation: 'Add to package.json scripts: "postinstall": "npx setup-para"'
+    });
+  } else {
+    results.push({
+      checkId,
+      passed: true,
+      severity: "error",
+      message: "setup-para configured in postinstall script"
+    });
+  }
+  return results;
+}
+export {
+  chainDependenciesCheck
+};

package/dist/diagnostics/checks/css-import.d.ts

@@ -0,0 +1,2 @@
+export declare const cssImportCheck: import("../types.js").Check;
+//# sourceMappingURL=css-import.d.ts.map

package/dist/diagnostics/checks/css-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-import.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/css-import.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,6BAwDzB,CAAC"}

package/dist/diagnostics/checks/css-import.js

@@ -0,0 +1,57 @@
+import { defineCheck } from "../types.js";
+import { getCSSImportPath } from "../detectors/sdk.js";
+import { findImportInFiles } from "../utils/code-search.js";
+const cssImportCheck = defineCheck({
+  metadata: {
+    id: "css-import",
+    name: "CSS Styles Import",
+    description: "Checks if Para SDK CSS styles are imported",
+    category: "setup",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType === "@getpara/react-sdk" || context.sdkType === "@getpara/react-sdk-lite";
+  },
+  async run(context) {
+    const cssImportPath = getCSSImportPath(context.sdkType);
+    if (!cssImportPath) {
+      return [];
+    }
+    const found = await findImportInFiles(context.files, cssImportPath, context.shouldIgnoreFile);
+    if (found) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: "Para SDK styles imported correctly",
+          location: found
+        }
+      ];
+    }
+    const entryPointHints = [];
+    if (context.framework === "nextjs") {
+      entryPointHints.push("app/layout.tsx", "pages/_app.tsx");
+    } else if (context.framework === "vite" || context.framework === "create-react-app") {
+      entryPointHints.push("src/main.tsx", "src/index.tsx", "src/App.tsx");
+    } else if (context.framework === "vue") {
+      entryPointHints.push("src/main.ts", "src/App.vue");
+    } else if (context.framework === "svelte") {
+      entryPointHints.push("src/main.ts", "src/App.svelte");
+    }
+    return [
+      {
+        checkId: this.metadata.id,
+        passed: false,
+        severity: this.metadata.severity,
+        message: "Para SDK styles not imported",
+        details: `Missing import in entry point (${entryPointHints.join(" or ")})`,
+        recommendation: `Add: import "${cssImportPath}"`
+      }
+    ];
+  }
+});
+export {
+  cssImportCheck
+};

package/dist/diagnostics/checks/deprecated-packages.d.ts

@@ -0,0 +1,2 @@
+export declare const deprecatedPackagesCheck: import("../types.js").Check;
+//# sourceMappingURL=deprecated-packages.d.ts.map

package/dist/diagnostics/checks/deprecated-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-packages.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/deprecated-packages.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,uBAAuB,6BAyElC,CAAC"}

package/dist/diagnostics/checks/deprecated-packages.js

@@ -0,0 +1,93 @@
+import { defineCheck } from "../types.js";
+import { hasDependency, getAllDependencies, getInstallCommand, getRemoveCommand } from "../utils/package-json.js";
+const DEPRECATED_PACKAGES = [
+  {
+    name: "@getpara/graz",
+    reason: "@getpara/graz is deprecated \u2014 the official graz package now has native Para support",
+    replacement: "graz"
+  }
+];
+const USECAPSULE_MIGRATION = {
+  "@usecapsule/react-sdk": "@getpara/react-sdk",
+  "@usecapsule/web-sdk": "@getpara/web-sdk",
+  "@usecapsule/core-sdk": "@getpara/core-sdk",
+  "@usecapsule/server-sdk": "@getpara/server-sdk",
+  "@usecapsule/react-sdk-lite": "@getpara/react-sdk-lite",
+  "@usecapsule/react-native-wallet": "@getpara/react-native-wallet",
+  "@usecapsule/evm-wallet-connectors": "@getpara/evm-wallet-connectors",
+  "@usecapsule/solana-wallet-connectors": "@getpara/solana-wallet-connectors",
+  "@usecapsule/cosmos-wallet-connectors": "@getpara/cosmos-wallet-connectors",
+  "@usecapsule/rainbowkit-wallet": "@getpara/rainbowkit-wallet",
+  "@usecapsule/wagmi-v2-integration": "@getpara/wagmi-v2-integration",
+  "@usecapsule/viem-v2-integration": "@getpara/viem-v2-integration",
+  "@usecapsule/ethers-v6-integration": "@getpara/ethers-v6-integration",
+  "@usecapsule/cosmjs-v0-integration": "@getpara/cosmjs-v0-integration"
+};
+const deprecatedPackagesCheck = defineCheck({
+  metadata: {
+    id: "deprecated-packages",
+    name: "Deprecated Packages",
+    description: "Checks for deprecated @getpara/* packages that should be removed",
+    category: "dependencies",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.packageJson !== null;
+  },
+  async run(context) {
+    if (!context.packageJson) {
+      return [];
+    }
+    const results = [];
+    const install = getInstallCommand(context.packageManager);
+    const remove = getRemoveCommand(context.packageManager);
+    for (const deprecated of DEPRECATED_PACKAGES) {
+      if (hasDependency(context.packageJson, deprecated.name)) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: `Deprecated package found: ${deprecated.name}`,
+          details: deprecated.reason,
+          recommendation: `Replace with: ${install} ${deprecated.replacement}`
+        });
+      }
+    }
+    const allDeps = getAllDependencies(context.packageJson);
+    for (const depName of Object.keys(allDeps)) {
+      const replacement = USECAPSULE_MIGRATION[depName];
+      if (replacement) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: `Legacy package found: ${depName}`,
+          details: "@usecapsule/* packages have been renamed to @getpara/*",
+          recommendation: `Migrate: ${install} ${replacement} && ${remove} ${depName}`
+        });
+      } else if (depName.startsWith("@usecapsule/")) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: "warning",
+          message: `Legacy package found: ${depName}`,
+          details: "@usecapsule/* packages have been renamed to @getpara/*",
+          recommendation: `Check docs.getpara.com for the @getpara/* equivalent`
+        });
+      }
+    }
+    if (results.length === 0) {
+      results.push({
+        checkId: this.metadata.id,
+        passed: true,
+        severity: this.metadata.severity,
+        message: "No deprecated packages found"
+      });
+    }
+    return results;
+  }
+});
+export {
+  deprecatedPackagesCheck
+};

package/dist/diagnostics/checks/env-api-key.d.ts

@@ -0,0 +1,2 @@
+export declare const envApiKeyCheck: import("../types.js").Check;
+//# sourceMappingURL=env-api-key.d.ts.map

package/dist/diagnostics/checks/env-api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-api-key.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/env-api-key.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,6BA4EzB,CAAC"}

package/dist/diagnostics/checks/env-api-key.js

@@ -0,0 +1,75 @@
+import path from "node:path";
+import { defineCheck } from "../types.js";
+import { getEnvVarPrefix } from "../detectors/framework.js";
+import { readFile, findEnvFiles } from "../utils/file-system.js";
+const envApiKeyCheck = defineCheck({
+  metadata: {
+    id: "env-api-key",
+    name: "API Key Configuration",
+    description: "Checks if Para API key is defined in environment files",
+    category: "configuration",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType !== "none";
+  },
+  async run(context) {
+    const prefix = getEnvVarPrefix(context.framework);
+    const expectedVar = `${prefix}PARA_API_KEY`;
+    const envFiles = await findEnvFiles(context.projectRoot);
+    let foundIn = null;
+    let hasPlaceholder = false;
+    for (const file of envFiles) {
+      const content = await readFile(file);
+      if (!content) continue;
+      const lines = content.split("\n");
+      for (const line of lines) {
+        if (line.startsWith(expectedVar + "=")) {
+          foundIn = path.basename(file);
+          const value = line.substring(line.indexOf("=") + 1).trim();
+          if (value === "" || value === "your_api_key_here" || value === "your-api-key-here" || value === "YOUR_API_KEY") {
+            hasPlaceholder = true;
+          }
+          break;
+        }
+      }
+      if (foundIn) break;
+    }
+    if (foundIn && !hasPlaceholder) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: `API key ${expectedVar} found in ${foundIn}`
+        }
+      ];
+    }
+    if (foundIn && hasPlaceholder) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: false,
+          severity: "warning",
+          message: `API key ${expectedVar} found but has placeholder value`,
+          details: `Replace the placeholder in ${foundIn} with your actual Para API key`,
+          recommendation: "Get your API key from the Para dashboard and update the environment file"
+        }
+      ];
+    }
+    return [
+      {
+        checkId: this.metadata.id,
+        passed: false,
+        severity: this.metadata.severity,
+        message: `API key ${expectedVar} not found in environment files`,
+        details: `Add ${expectedVar}=your_api_key to .env.local or similar`,
+        recommendation: `Create .env.local and add: ${expectedVar}=your_api_key_here`
+      }
+    ];
+  }
+});
+export {
+  envApiKeyCheck
+};

package/dist/diagnostics/checks/env-var-prefix.d.ts

@@ -0,0 +1,2 @@
+export declare const envVarPrefixCheck: import("../types.js").Check;
+//# sourceMappingURL=env-var-prefix.d.ts.map

package/dist/diagnostics/checks/env-var-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-var-prefix.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/env-var-prefix.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,6BAsD5B,CAAC"}

package/dist/diagnostics/checks/env-var-prefix.js

@@ -0,0 +1,52 @@
+import { defineCheck } from "../types.js";
+import { getEnvVarPrefix, getEnvAccessPattern } from "../detectors/framework.js";
+import { findPatternInFiles } from "../utils/code-search.js";
+const envVarPrefixCheck = defineCheck({
+  metadata: {
+    id: "env-var-prefix",
+    name: "Environment Variable Prefix",
+    description: "Checks if environment variables use the correct prefix for the framework",
+    category: "configuration",
+    severity: "warning",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType !== "none" && context.framework !== "unknown";
+  },
+  async run(context) {
+    const correctPrefix = getEnvVarPrefix(context.framework);
+    const correctAccess = getEnvAccessPattern(context.framework);
+    const wrongPrefixes = ["NEXT_PUBLIC_", "VITE_", "REACT_APP_"].filter((p) => p !== correctPrefix);
+    const results = [];
+    for (const wrongPrefix of wrongPrefixes) {
+      const pattern = new RegExp(`${wrongPrefix}PARA_API_KEY`);
+      const locations = await findPatternInFiles(context.files, pattern, context.shouldIgnoreFile);
+      if (locations.length > 0) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: `Found ${wrongPrefix}PARA_API_KEY but framework expects ${correctPrefix}PARA_API_KEY`,
+          location: locations[0],
+          recommendation: `Use ${correctAccess}.${correctPrefix}PARA_API_KEY for ${context.framework}`
+        });
+      }
+    }
+    if (results.length === 0) {
+      const correctPattern = new RegExp(`${correctPrefix}PARA_API_KEY`);
+      const locations = await findPatternInFiles(context.files, correctPattern, context.shouldIgnoreFile);
+      if (locations.length > 0) {
+        results.push({
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: `Environment variable prefix ${correctPrefix} is correct for ${context.framework}`
+        });
+      }
+    }
+    return results;
+  }
+});
+export {
+  envVarPrefixCheck
+};

package/dist/diagnostics/checks/index.d.ts

@@ -0,0 +1,13 @@
+import type { Check } from '../types.js';
+import { envApiKeyCheck } from './env-api-key.js';
+import { cssImportCheck } from './css-import.js';
+import { paraProviderCheck } from './para-provider.js';
+import { queryClientCheck } from './query-client.js';
+import { versionConsistencyCheck } from './version-consistency.js';
+import { useClientDirectiveCheck } from './use-client-directive.js';
+import { envVarPrefixCheck } from './env-var-prefix.js';
+import { chainDependenciesCheck } from './chain-dependencies.js';
+import { deprecatedPackagesCheck } from './deprecated-packages.js';
+export declare const allChecks: Check[];
+export { envApiKeyCheck, cssImportCheck, paraProviderCheck, queryClientCheck, versionConsistencyCheck, useClientDirectiveCheck, envVarPrefixCheck, chainDependenciesCheck, deprecatedPackagesCheck, };
+//# sourceMappingURL=index.d.ts.map

package/dist/diagnostics/checks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,eAAO,MAAM,SAAS,EAAE,KAAK,EAU5B,CAAC;AAEF,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,CAAC"}

package/dist/diagnostics/checks/index.js

@@ -0,0 +1,32 @@
+import { envApiKeyCheck } from "./env-api-key.js";
+import { cssImportCheck } from "./css-import.js";
+import { paraProviderCheck } from "./para-provider.js";
+import { queryClientCheck } from "./query-client.js";
+import { versionConsistencyCheck } from "./version-consistency.js";
+import { useClientDirectiveCheck } from "./use-client-directive.js";
+import { envVarPrefixCheck } from "./env-var-prefix.js";
+import { chainDependenciesCheck } from "./chain-dependencies.js";
+import { deprecatedPackagesCheck } from "./deprecated-packages.js";
+const allChecks = [
+  envApiKeyCheck,
+  cssImportCheck,
+  paraProviderCheck,
+  queryClientCheck,
+  versionConsistencyCheck,
+  useClientDirectiveCheck,
+  envVarPrefixCheck,
+  chainDependenciesCheck,
+  deprecatedPackagesCheck
+];
+export {
+  allChecks,
+  chainDependenciesCheck,
+  cssImportCheck,
+  deprecatedPackagesCheck,
+  envApiKeyCheck,
+  envVarPrefixCheck,
+  paraProviderCheck,
+  queryClientCheck,
+  useClientDirectiveCheck,
+  versionConsistencyCheck
+};

package/dist/diagnostics/checks/para-provider.d.ts

@@ -0,0 +1,2 @@
+export declare const paraProviderCheck: import("../types.js").Check;
+//# sourceMappingURL=para-provider.d.ts.map

package/dist/diagnostics/checks/para-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"para-provider.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/para-provider.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,6BA6C5B,CAAC"}

package/dist/diagnostics/checks/para-provider.js

@@ -0,0 +1,42 @@
+import { defineCheck } from "../types.js";
+import { findPatternInFiles } from "../utils/code-search.js";
+const paraProviderCheck = defineCheck({
+  metadata: {
+    id: "para-provider",
+    name: "ParaProvider Setup",
+    description: "Checks if ParaProvider is imported from Para SDK",
+    category: "setup",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType === "@getpara/react-sdk" || context.sdkType === "@getpara/react-sdk-lite";
+  },
+  async run(context) {
+    const importPattern = /import\s*\{[\s\S]*?\bParaProvider\b[\s\S]*?\}\s*from\s*['"]@getpara\/(react-sdk|react-sdk-lite)['"]/;
+    const importLocations = await findPatternInFiles(context.files, importPattern, context.shouldIgnoreFile);
+    if (importLocations.length > 0) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: "ParaProvider is imported",
+          location: importLocations[0]
+        }
+      ];
+    }
+    return [
+      {
+        checkId: this.metadata.id,
+        passed: false,
+        severity: this.metadata.severity,
+        message: "ParaProvider not imported",
+        recommendation: `Import ParaProvider from ${context.sdkType} and wrap your app with it`
+      }
+    ];
+  }
+});
+export {
+  paraProviderCheck
+};

package/dist/diagnostics/checks/query-client.d.ts

@@ -0,0 +1,2 @@
+export declare const queryClientCheck: import("../types.js").Check;
+//# sourceMappingURL=query-client.d.ts.map

package/dist/diagnostics/checks/query-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-client.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/query-client.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,6BA0D3B,CAAC"}

package/dist/diagnostics/checks/query-client.js

@@ -0,0 +1,58 @@
+import { defineCheck } from "../types.js";
+import { findPatternInFiles } from "../utils/code-search.js";
+import { hasDependency, getInstallCommand } from "../utils/package-json.js";
+const queryClientCheck = defineCheck({
+  metadata: {
+    id: "query-client",
+    name: "QueryClientProvider Setup",
+    description: "Checks if QueryClientProvider wraps ParaProvider",
+    category: "setup",
+    severity: "error",
+    enabled: true
+  },
+  shouldRun(context) {
+    return context.sdkType === "@getpara/react-sdk" || context.sdkType === "@getpara/react-sdk-lite";
+  },
+  async run(context) {
+    if (!context.packageJson) {
+      return [];
+    }
+    const hasReactQuery = hasDependency(context.packageJson, "@tanstack/react-query");
+    if (!hasReactQuery) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: false,
+          severity: this.metadata.severity,
+          message: "@tanstack/react-query is not installed",
+          recommendation: `Install: ${getInstallCommand(context.packageManager)} @tanstack/react-query`
+        }
+      ];
+    }
+    const queryClientPattern = /QueryClientProvider/;
+    const locations = await findPatternInFiles(context.files, queryClientPattern, context.shouldIgnoreFile);
+    if (locations.length > 0) {
+      return [
+        {
+          checkId: this.metadata.id,
+          passed: true,
+          severity: this.metadata.severity,
+          message: "QueryClientProvider is configured",
+          location: locations[0]
+        }
+      ];
+    }
+    return [
+      {
+        checkId: this.metadata.id,
+        passed: false,
+        severity: this.metadata.severity,
+        message: "QueryClientProvider not found",
+        recommendation: "Wrap ParaProvider with QueryClientProvider from @tanstack/react-query"
+      }
+    ];
+  }
+});
+export {
+  queryClientCheck
+};

package/dist/diagnostics/checks/use-client-directive.d.ts

@@ -0,0 +1,2 @@
+export declare const useClientDirectiveCheck: import("../types.js").Check;
+//# sourceMappingURL=use-client-directive.d.ts.map

package/dist/diagnostics/checks/use-client-directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-client-directive.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/checks/use-client-directive.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,6BAwElC,CAAC"}