@aws-sdk/util-user-agent-node

// ESM import
import { 
  createDefaultUserAgentProvider,
  defaultUserAgent,
  crtAvailability,
  DefaultUserAgentOptions,
  PreviouslyResolved,
  UA_APP_ID_ENV_NAME,
  UA_APP_ID_INI_NAME,
  NODE_APP_ID_CONFIG_OPTIONS
} from "@aws-sdk/util-user-agent-node";

// CommonJS import
const { 
  createDefaultUserAgentProvider,
  defaultUserAgent,
  crtAvailability,
  DefaultUserAgentOptions,
  PreviouslyResolved,
  UA_APP_ID_ENV_NAME,
  UA_APP_ID_INI_NAME,
  NODE_APP_ID_CONFIG_OPTIONS
} = require("@aws-sdk/util-user-agent-node");

import { createDefaultUserAgentProvider } from "@aws-sdk/util-user-agent-node";

// Create a user agent provider for a specific AWS service
const userAgentProvider = createDefaultUserAgentProvider({
  serviceId: "s3",
  clientVersion: "3.879.0"
});

// Generate user agent with optional app ID configuration
const userAgent = await userAgentProvider({
  userAgentAppId: async () => "my-application-id"
});
// Returns: [["aws-sdk-js", "3.879.0"], ["ua", "2.1"], ["os/linux", "5.4.0"], ...]

function createDefaultUserAgentProvider(options: DefaultUserAgentOptions): (config?: PreviouslyResolved) => Promise<UserAgent>;

interface DefaultUserAgentOptions {
  serviceId?: string;
  clientVersion: string;
}

interface PreviouslyResolved {
  userAgentAppId: Provider<string | undefined>;
}

const provider = createDefaultUserAgentProvider({
  serviceId: "dynamodb",
  clientVersion: "3.879.0"
});

const userAgent = await provider();
// Generates: [["aws-sdk-js", "3.879.0"], ["ua", "2.1"], ["os/darwin", "22.1.0"], ["lang/js"], ["md/nodejs", "18.19.0"], ["api/dynamodb", "3.879.0"]]

const provider = createDefaultUserAgentProvider({
  serviceId: "s3",
  clientVersion: "3.879.0"
});

const userAgent = await provider({
  userAgentAppId: async () => "my-app-v1.0"
});
// Adds: ["app/my-app-v1.0"] to the user agent array

const provider = createDefaultUserAgentProvider({
  clientVersion: "3.879.0"
});

const userAgent = await provider();
// Excludes the ["api/{serviceId}", clientVersion] section

const crtAvailability: {
  isCrtAvailable: boolean;
};

import { crtAvailability } from "@aws-sdk/util-user-agent-node";

// Check if CRT is available
if (crtAvailability.isCrtAvailable) {
  console.log("AWS CRT is available");
}

// This object is mutated by aws-crt package when loaded
// Default value: { isCrtAvailable: false }

const UA_APP_ID_ENV_NAME: string;
const UA_APP_ID_INI_NAME: string;
const NODE_APP_ID_CONFIG_OPTIONS: LoadedConfigSelectors<string | undefined>;

import { UA_APP_ID_ENV_NAME, UA_APP_ID_INI_NAME } from "@aws-sdk/util-user-agent-node";

console.log(UA_APP_ID_ENV_NAME); // "AWS_SDK_UA_APP_ID"
console.log(UA_APP_ID_INI_NAME);  // "sdk_ua_app_id"

import { NODE_APP_ID_CONFIG_OPTIONS } from "@aws-sdk/util-user-agent-node";

// Used internally by AWS SDK for loading app ID from:
// 1. Environment variable: AWS_SDK_UA_APP_ID
// 2. INI config file: sdk_ua_app_id (or deprecated sdk-ua-app-id)
// 3. Default fallback value

// The configuration object provides standardized loading behavior
// for the @smithy/node-config-provider system

function defaultUserAgent(options: DefaultUserAgentOptions): (config?: PreviouslyResolved) => Promise<UserAgent>;

import { defaultUserAgent } from "@aws-sdk/util-user-agent-node";

// ⚠️ Deprecated - use createDefaultUserAgentProvider instead
const provider = defaultUserAgent({
  serviceId: "s3",
  clientVersion: "3.879.0"
});

// From @smithy/types
type UserAgent = UserAgentPair[];
type UserAgentPair = [string, string];
type Provider<T> = () => Promise<T> | T;

// From @smithy/node-config-provider  
interface LoadedConfigSelectors<T> {
  environmentVariableSelector: (env: NodeJS.ProcessEnv) => T | undefined;
  configFileSelector: (profile: any) => T | undefined;
  default: T;
}