fix: correct global type augmentation for ImportMeta.env

  - Remove duplicate environment.d.ts file, consolidate into env.d.ts
  - Add proper declare global wrapper with export {} for module context
  - Define ImportMetaEnv interface with documented Klever SDK env vars
  - Use triple-slash reference in index.ts to include global augmentation
  - Add eslint-disable comment for required triple-slash reference usage
  - Keep sideEffects: false to allow proper tree-shaking

  This fixes the esbuild warning about ignored bare imports while ensuring
  TypeScript correctly picks up the global ImportMeta.env types across
  all packages. The global augmentation now properly extends ImportMeta
  with optional env property containing Klever-specific environment variables.

  Fixes build warning: "Ignoring this import because src/types/env.d.ts was marked as having no side effects"

Author: fbsobreira

packages/connect-core/src/types/env.d.ts

@@ -1,11 +1,37 @@
-/// <reference types="vite/client" />
+/**
+ * Global type augmentations for cross-platform compatibility
+ * Augments ImportMeta to support env properties from Vite and other bundlers
+ *
+ * Note: This is a library, so we don't reference vite/client.
+ * Consumers using Vite will get these types merged with Vite's types automatically.
+ */
 
-interface ImportMetaEnv {
-  readonly VITE_KLEVER_LOG_LEVEL?: string
-  readonly KLEVER_LOG_LEVEL?: string
-  // Add more env vars as needed
-}
+declare global {
+  interface ImportMetaEnv {
+    /**
+     * Log level for Klever SDK (Vite convention)
+     * @example 'debug' | 'info' | 'warn' | 'error' | 'silent'
+     */
+    readonly VITE_KLEVER_LOG_LEVEL?: string
+
+    /**
+     * Log level for Klever SDK (non-Vite environments)
+     * @example 'debug' | 'info' | 'warn' | 'error' | 'silent'
+     */
+    readonly KLEVER_LOG_LEVEL?: string
 
-interface ImportMeta {
-  readonly env: ImportMetaEnv
+    // Allow any other env variables
+    [key: string]: string | undefined
+  }
+
+  interface ImportMeta {
+    /**
+     * Environment variables (available in Vite and other modern bundlers)
+     */
+    readonly env?: ImportMetaEnv
+  }
 }
+
+// This export {} makes TypeScript treat this file as a module
+// which is required for declare global to work properly
+export {}

packages/connect-core/src/types/environment.d.ts

@@ -3,12 +3,12 @@
  * Inspired by ethers.js, CosmJS, and @solana/web3.js
  */
 
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference
+/// <reference path="./env.d.ts" />
+
 // Environment types
 export type Environment = 'browser' | 'node' | 'react-native' | 'unknown'
 
-// Import global type augmentations
-import './environment.d.ts'
-
 export * from './branded'
 export * from './proposals'
 export * from './transactions'