add CI, docs, and missing build files

Author: jsonbailey

.github/workflows/manual-publish.yml

@@ -35,6 +35,7 @@ on:
           - packages/tooling/jest
           - packages/sdk/browser
           - packages/sdk/server-ai
+          - packages/ai-providers/server-ai-openai
           - packages/telemetry/browser-telemetry
           - packages/sdk/combined-browser
       prerelease:

.github/workflows/server-ai-openai.yml

@@ -0,0 +1,27 @@
+name: ai-providers/server-ai-openai
+
+on:
+  push:
+    branches: [main, 'feat/**']
+    paths-ignore:
+      - '**.md' #Do not need to run CI for markdown changes.
+  pull_request:
+    branches: [main, 'feat/**']
+    paths-ignore:
+      - '**.md'
+
+jobs:
+  build-test-openai-provider:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version: 22.x
+          registry-url: 'https://registry.npmjs.org'
+      - id: shared
+        name: Shared CI Steps
+        uses: ./actions/ci
+        with:
+          workspace_name: '@launchdarkly/server-sdk-ai-openai'
+          workspace_path: packages/ai-providers/server-ai-openai

packages/ai-providers/server-ai-openai/README.md

@@ -0,0 +1,115 @@
+# LaunchDarkly AI SDK OpenAI Provider for Server-Side JavaScript
+
+[![NPM][server-ai-openai-npm-badge]][server-ai-openai-npm-link]
+[![Actions Status][server-ai-openai-ci-badge]][server-ai-openai-ci]
+[![Documentation][server-ai-openai-ghp-badge]][server-ai-openai-ghp-link]
+[![NPM][server-ai-openai-dm-badge]][server-ai-openai-npm-link]
+[![NPM][server-ai-openai-dt-badge]][server-ai-openai-npm-link]
+
+# ⛔️⛔️⛔️⛔️
+
+> [!CAUTION]
+> This library is a alpha version and should not be considered ready for production use while this message is visible.
+
+# ☝️☝️☝️☝️☝️☝️
+
+## LaunchDarkly overview
+
+[LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves over 100 billion feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/launchdarkly.svg?style=social&label=Follow&maxAge=2592000)](https://twitter.com/intent/follow?screen_name=launchdarkly)
+
+## Quick Setup
+
+This package provides OpenAI integration for the LaunchDarkly AI SDK. The simplest way to use it is with the LaunchDarkly AI SDK's `initChat` method:
+
+1. Install the required packages:
+
+```shell
+npm install @launchdarkly/server-sdk-ai @launchdarkly/server-sdk-ai-openai --save
+```
+
+2. Create a chat session and use it:
+
+```typescript
+import { init } from '@launchdarkly/node-server-sdk';
+import { initAi } from '@launchdarkly/server-sdk-ai';
+
+// Initialize LaunchDarkly client
+const ldClient = init(sdkKey);
+const aiClient = initAi(ldClient);
+
+// Create a chat session
+const defaultConfig = { 
+  enabled: true, 
+  model: { name: 'gpt-4' },
+  provider: { name: 'openai' }
+};
+const chat = await aiClient.initChat('my-chat-config', context, defaultConfig);
+
+if (chat) {
+  const response = await chat.invoke("What is the capital of France?");
+  console.log(response.message.content);
+}
+```
+
+For more information about using the LaunchDarkly AI SDK, see the [LaunchDarkly AI SDK documentation](https://github.com/launchdarkly/js-core/tree/main/packages/sdk/server-ai/README.md).
+
+## Advanced Usage
+
+For more control, you can use the OpenAI provider package directly with LaunchDarkly configurations:
+
+```typescript
+import { OpenAIProvider } from '@launchdarkly/server-sdk-ai-openai';
+import { OpenAI } from 'openai';
+
+// Create an OpenAI client
+const client = new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+// Combine LaunchDarkly AI Config messages with user message
+const configMessages = aiConfig.messages || [];
+const userMessage = { role: 'user', content: 'What is the capital of France?' };
+const allMessages = [...configMessages, userMessage];
+
+// Track the model call with LaunchDarkly tracking
+const response = await aiConfig.tracker.trackMetricsOf(
+  (result) => OpenAIProvider.createAIMetrics(result),
+  () => client.chat.completions.create({
+    model: 'gpt-4',
+    messages: allMessages,
+    temperature: 0.7,
+  })
+);
+
+console.log('AI Response:', response.choices[0].message.content);
+```
+
+## Contributing
+
+We encourage pull requests and other contributions from the community. Check out our [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute to this SDK.
+
+## About LaunchDarkly
+
+- LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard. With LaunchDarkly, you can:
+  - Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
+  - Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
+  - Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
+  - Grant access to certain features based on user attributes, like payment plan (eg: users on the 'gold' plan get access to more features than users in the 'silver' plan).
+  - Disable parts of your application to facilitate maintenance, without taking everything offline.
+- LaunchDarkly provides feature flag SDKs for a wide variety of languages and technologies. Check out [our documentation](https://docs.launchdarkly.com/sdk) for a complete list.
+- Explore LaunchDarkly
+  - [launchdarkly.com](https://www.launchdarkly.com/ 'LaunchDarkly Main Website') for more information
+  - [docs.launchdarkly.com](https://docs.launchdarkly.com/ 'LaunchDarkly Documentation') for our documentation and SDK reference guides
+  - [apidocs.launchdarkly.com](https://apidocs.launchdarkly.com/ 'LaunchDarkly API Documentation') for our API documentation
+  - [blog.launchdarkly.com](https://blog.launchdarkly.com/ 'LaunchDarkly Blog Documentation') for the latest product updates
+
+[server-ai-openai-ci-badge]: https://github.com/launchdarkly/js-core/actions/workflows/server-ai-openai.yml/badge.svg
+[server-ai-openai-ci]: https://github.com/launchdarkly/js-core/actions/workflows/server-ai-openai.yml
+[server-ai-openai-npm-badge]: https://img.shields.io/npm/v/@launchdarkly/server-sdk-ai-openai.svg?style=flat-square
+[server-ai-openai-npm-link]: https://www.npmjs.com/package/@launchdarkly/server-sdk-ai-openai
+[server-ai-openai-ghp-badge]: https://img.shields.io/static/v1?label=GitHub+Pages&message=API+reference&color=00add8
+[server-ai-openai-ghp-link]: https://launchdarkly.github.io/js-core/packages/ai-providers/server-ai-openai/docs/
+[server-ai-openai-dm-badge]: https://img.shields.io/npm/dm/@launchdarkly/server-sdk-ai-openai.svg?style=flat-square
+[server-ai-openai-dt-badge]: https://img.shields.io/npm/dt/@launchdarkly/server-sdk-ai-openai.svg?style=flat-square

packages/ai-providers/server-ai-openai/jest.config.js

@@ -1,14 +1,7 @@
 module.exports = {
-  preset: 'ts-jest',
+  transform: { '^.+\\.ts?$': 'ts-jest' },
+  testMatch: ['**/__tests__/**/*test.ts?(x)'],
   testEnvironment: 'node',
-  roots: ['<rootDir>'],
-  testMatch: ['**/__tests__/**/*.test.ts'],
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.d.ts',
-    '!src/**/*.test.ts',
-    '!src/**/*.spec.ts',
-  ],
-  coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov', 'html'],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  collectCoverageFrom: ['src/**/*.ts'],
 };

packages/ai-providers/server-ai-openai/tsconfig.ref.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["src/**/*"],
+  "compilerOptions": {
+    "composite": true
+  }
+}

packages/ai-providers/server-ai-openai/typedoc.json

@@ -0,0 +1,5 @@
+{
+  "extends": ["../../../typedoc.base.json"],
+  "entryPoints": ["src/index.ts"],
+  "out": "docs"
+}

tsconfig.json

@@ -81,6 +81,9 @@
     },
     {
       "path": "./packages/ai-providers/server-ai-langchain/tsconfig.ref.json"
+    },
+    {
+      "path": "./packages/ai-providers/server-ai-openai/tsconfig.ref.json"
     }
   ]
 }