chore(setup): add SDK init/injection library and templates

internal/setup/installer_test.go

@@ -372,3 +372,34 @@ func TestCsprojFiles_SkipsBuildOutput(t *testing.T) {
 
 	assert.Equal(t, []string{filepath.Join(dir, "src/MyApp/MyApp.csproj")}, csprojFiles(dir))
 }
+
+// The templates import the package InstallArgs installs; a mismatch means the user
+// installs one package and the snippet requires another. These are the pairs where
+// LaunchDarkly ships both a scoped and an unscoped package for the same SDK.
+func TestInstallArgs_PackageMatchesTemplateImport(t *testing.T) {
+	tests := []struct {
+		sdkID      string
+		wantImport string
+	}{
+		{"node-server", "@launchdarkly/node-server-sdk"},
+		{"react-client-sdk", "launchdarkly-react-client-sdk"},
+		{"react-native", "@launchdarkly/react-native-client-sdk"},
+		{"js-client-sdk", "launchdarkly-js-client-sdk"},
+	}
+	for _, tt := range tests {
+		t.Run(tt.sdkID, func(t *testing.T) {
+			_, pkg := InstallArgs(tt.sdkID, "npm")
+			assert.Equal(t, tt.wantImport, pkg)
+
+			rendered, err := RenderTemplate(tt.sdkID, InitConfig{})
+			require.NoError(t, err)
+			assert.Contains(t, rendered, "'"+tt.wantImport+"'",
+				"template must import the package we install")
+
+			esm, err := RenderTemplateForEntry(tt.sdkID, "src/main.ts", InitConfig{})
+			require.NoError(t, err)
+			assert.Contains(t, esm, "'"+tt.wantImport+"'",
+				"ESM template must import the package we install")
+		})
+	}
+}

internal/setup/sdk_init_templates/android.tmpl

@@ -0,0 +1,11 @@
+import com.launchdarkly.sdk.android.*;
+import com.launchdarkly.sdk.android.LDConfig.Builder.AutoEnvAttributes;
+import com.launchdarkly.sdk.*;
+// --- init ---
+LDConfig ldConfig = new LDConfig.Builder(AutoEnvAttributes.Enabled)
+    .mobileKey("{{.MobileKey}}")
+    .build();
+LDContext ldContext = LDContext.builder(ContextKind.DEFAULT, "example-user-key")
+    .name("Example User")
+    .build();
+LDClient ldClient = LDClient.init(this.getApplication(), ldConfig, ldContext, 5);

internal/setup/sdk_init_templates/dotnet-server-sdk.tmpl

@@ -0,0 +1,11 @@
+using LaunchDarkly.Sdk;
+using LaunchDarkly.Sdk.Server;
+// --- init ---
+var ldClient = new LdClient("{{.SDKKey}}");
+
+var context = Context.Builder("example-user-key")
+    .Name("Example User")
+    .Build();
+
+var flagValue = ldClient.BoolVariation("{{.FlagKey}}", context, false);
+Console.WriteLine($"Flag '{{.FlagKey}}' is {flagValue}");

internal/setup/sdk_init_templates/go-server-sdk.tmpl

@@ -0,0 +1,16 @@
+import (
+	"fmt"
+	"time"
+
+	"github.com/launchdarkly/go-sdk-common/v3/ldcontext"
+	ld "github.com/launchdarkly/go-server-sdk/v7"
+)
+// --- init ---
+ldClient, _ := ld.MakeClient("{{.SDKKey}}", 5*time.Second)
+
+context := ldcontext.NewBuilder("example-user-key").
+	Name("Example User").
+	Build()
+
+flagValue, _ := ldClient.BoolVariation("{{.FlagKey}}", context, false)
+fmt.Printf("Flag '{{.FlagKey}}' is %t\n", flagValue)

internal/setup/sdk_init_templates/java-server-sdk.tmpl

@@ -0,0 +1,11 @@
+import com.launchdarkly.sdk.*;
+import com.launchdarkly.sdk.server.*;
+// --- init ---
+LDClient ldClient = new LDClient("{{.SDKKey}}");
+
+LDContext context = LDContext.builder("example-user-key")
+    .name("Example User")
+    .build();
+
+boolean flagValue = ldClient.boolVariation("{{.FlagKey}}", context, false);
+System.out.println("Flag '{{.FlagKey}}' is " + flagValue);

internal/setup/sdk_init_templates/js-client-sdk.tmpl

@@ -0,0 +1,12 @@
+import * as LDClient from 'launchdarkly-js-client-sdk';
+// --- init ---
+const ldClient = LDClient.initialize('{{.ClientSideID}}', {
+  kind: 'user',
+  key: 'example-user-key',
+  name: 'Example User',
+});
+
+ldClient.on('ready', () => {
+  const flagValue = ldClient.variation('{{.FlagKey}}', false);
+  console.log(`Flag '{{.FlagKey}}' is ${flagValue}`);
+});

internal/setup/sdk_init_templates/node-server-esm.tmpl

@@ -0,0 +1,15 @@
+import * as LaunchDarkly from '@launchdarkly/node-server-sdk';
+// --- init ---
+const ldClient = LaunchDarkly.init('{{.SDKKey}}');
+
+const context = {
+  kind: 'user',
+  key: 'example-user-key',
+  name: 'Example User',
+};
+
+ldClient.on('ready', () => {
+  ldClient.variation('{{.FlagKey}}', context, false, (err, flagValue) => {
+    console.log(`Flag '{{.FlagKey}}' is ${flagValue}`);
+  });
+});

internal/setup/sdk_init_templates/node-server.tmpl

@@ -0,0 +1,15 @@
+const LaunchDarkly = require('@launchdarkly/node-server-sdk');
+// --- init ---
+const ldClient = LaunchDarkly.init('{{.SDKKey}}');
+
+const context = {
+  kind: 'user',
+  key: 'example-user-key',
+  name: 'Example User',
+};
+
+ldClient.on('ready', () => {
+  ldClient.variation('{{.FlagKey}}', context, false, (err, flagValue) => {
+    console.log(`Flag '{{.FlagKey}}' is ${flagValue}`);
+  });
+});

internal/setup/sdk_init_templates/python-server-sdk.tmpl

@@ -0,0 +1,11 @@
+import ldclient
+from ldclient import Context
+from ldclient.config import Config
+# --- init ---
+ldclient.set_config(Config("{{.SDKKey}}"))
+ld_client = ldclient.get()
+
+context = Context.builder("example-user-key").name("Example User").build()
+
+flag_value = ld_client.variation("{{.FlagKey}}", context, False)
+print(f"Flag '{{.FlagKey}}' is {flag_value}")

internal/setup/sdk_init_templates/react-client-sdk.tmpl

@@ -0,0 +1,10 @@
+import { asyncWithLDProvider } from 'launchdarkly-react-client-sdk';
+// --- init ---
+const LDProvider = await asyncWithLDProvider({
+  clientSideID: '{{.ClientSideID}}',
+  context: {
+    kind: 'user',
+    key: 'example-user-key',
+    name: 'Example User',
+  },
+});

internal/setup/sdk_init_templates/react-native.tmpl

@@ -0,0 +1,4 @@
+import { AutoEnvAttributes, ReactNativeLDClient } from '@launchdarkly/react-native-client-sdk';
+// --- init ---
+const featureClient = new ReactNativeLDClient('{{.MobileKey}}', AutoEnvAttributes.Enabled);
+await featureClient.identify({ kind: 'user', key: 'example-user-key', name: 'Example User' });

internal/setup/sdk_init_templates/ruby-server-sdk.tmpl

@@ -0,0 +1,12 @@
+require 'ldclient-rb'
+# --- init ---
+ld_client = LaunchDarkly::LDClient.new("{{.SDKKey}}")
+
+context = LaunchDarkly::LDContext.create({
+  key: "example-user-key",
+  kind: "user",
+  name: "Example User"
+})
+
+flag_value = ld_client.variation("{{.FlagKey}}", context, false)
+puts "Flag '{{.FlagKey}}' is #{flag_value}"

internal/setup/sdk_init_templates/swift-client-sdk.tmpl

@@ -0,0 +1,6 @@
+import LaunchDarkly
+// --- init ---
+let ldConfig = LDConfig(mobileKey: "{{.MobileKey}}", autoEnvAttributes: .enabled)
+guard case .success(let ldContext) = LDContextBuilder(key: "example-user-key").build()
+else { return }
+LDClient.start(config: ldConfig, context: ldContext)