@launchdarkly/react-sdk 0.0.0 → 0.1.0

package/dist/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/client/LDClient.ts":{"bytes":3178,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@launchdarkly/js-client-sdk","kind":"import-statement","external":true}],"format":"esm"},"src/client/LDOptions.ts":{"bytes":3039,"imports":[{"path":"@launchdarkly/js-client-sdk","kind":"import-statement","external":true},{"path":"./LDClient","kind":"import-statement","external":true}],"format":"esm"},"src/client/provider/LDReactContext.tsx":{"bytes":656,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"../browser/dist/index.js":{"bytes":87384,"imports":[],"format":"esm"},"src/client/LDReactClient.tsx":{"bytes":6302,"imports":[{"path":"../browser/dist/index.js","kind":"import-statement","original":"@launchdarkly/js-client-sdk"},{"path":"./LDClient","kind":"import-statement","external":true},{"path":"./LDOptions","kind":"import-statement","external":true},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/client/provider/LDReactProvider.tsx":{"bytes":4490,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@launchdarkly/js-client-sdk","kind":"import-statement","external":true},{"path":"../LDOptions","kind":"import-statement","external":true},{"path":"src/client/LDReactClient.tsx","kind":"import-statement","original":"../LDReactClient"},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"./LDReactContext"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/client/deprecated-hooks/flagKeyUtils.ts":{"bytes":710,"imports":[],"format":"esm"},"src/client/deprecated-hooks/useFlags.ts":{"bytes":3849,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"../provider/LDReactContext"},{"path":"src/client/deprecated-hooks/flagKeyUtils.ts","kind":"import-statement","original":"./flagKeyUtils"}],"format":"esm"},"src/client/deprecated-hooks/index.ts":{"bytes":39,"imports":[{"path":"src/client/deprecated-hooks/useFlags.ts","kind":"import-statement","original":"./useFlags"}],"format":"esm"},"src/client/hooks/useInitializationStatus.ts":{"bytes":1060,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"../provider/LDReactContext"}],"format":"esm"},"src/client/hooks/useLDClient.ts":{"bytes":613,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"../provider/LDReactContext"}],"format":"esm"},"src/client/hooks/useVariationCore.ts":{"bytes":1520,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"../provider/LDReactContext"}],"format":"esm"},"src/client/hooks/useVariation.ts":{"bytes":2669,"imports":[{"path":"src/client/hooks/useVariationCore.ts","kind":"import-statement","original":"./useVariationCore"}],"format":"esm"},"src/client/hooks/useVariationDetail.ts":{"bytes":3180,"imports":[{"path":"src/client/hooks/useVariationCore.ts","kind":"import-statement","original":"./useVariationCore"}],"format":"esm"},"src/client/hooks/index.ts":{"bytes":451,"imports":[{"path":"src/client/hooks/useInitializationStatus.ts","kind":"import-statement","original":"./useInitializationStatus"},{"path":"src/client/hooks/useLDClient.ts","kind":"import-statement","original":"./useLDClient"},{"path":"src/client/hooks/useVariation.ts","kind":"import-statement","original":"./useVariation"},{"path":"src/client/hooks/useVariationDetail.ts","kind":"import-statement","original":"./useVariationDetail"}],"format":"esm"},"src/client/index.ts":{"bytes":399,"imports":[{"path":"src/client/LDClient.ts","kind":"import-statement","original":"./LDClient"},{"path":"src/client/LDOptions.ts","kind":"import-statement","original":"./LDOptions"},{"path":"src/client/provider/LDReactContext.tsx","kind":"import-statement","original":"./provider/LDReactContext"},{"path":"src/client/provider/LDReactProvider.tsx","kind":"import-statement","original":"./provider/LDReactProvider"},{"path":"src/client/LDReactClient.tsx","kind":"import-statement","original":"./LDReactClient"},{"path":"src/client/deprecated-hooks/index.ts","kind":"import-statement","original":"./deprecated-hooks"},{"path":"src/client/hooks/index.ts","kind":"import-statement","original":"./hooks"}],"format":"esm"}},"outputs":{"dist/index.js":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["LDReactContext","createClient","createLDReactProvider","createLDReactProviderWithClient","initLDReactContext","useBoolVariation","useBoolVariationDetail","useFlags","useInitializationStatus","useJsonVariation","useJsonVariationDetail","useLDClient","useNumberVariation","useNumberVariationDetail","useStringVariation","useStringVariationDetail"],"entryPoint":"src/client/index.ts","inputs":{"src/client/index.ts":{"bytesInOutput":0},"src/client/provider/LDReactContext.tsx":{"bytesInOutput":80},"src/client/provider/LDReactProvider.tsx":{"bytesInOutput":802},"../browser/dist/index.js":{"bytesInOutput":87201},"src/client/LDReactClient.tsx":{"bytesInOutput":1807},"src/client/deprecated-hooks/useFlags.ts":{"bytesInOutput":901},"src/client/deprecated-hooks/flagKeyUtils.ts":{"bytesInOutput":233},"src/client/deprecated-hooks/index.ts":{"bytesInOutput":0},"src/client/hooks/useInitializationStatus.ts":{"bytesInOutput":156},"src/client/hooks/index.ts":{"bytesInOutput":0},"src/client/hooks/useLDClient.ts":{"bytesInOutput":90},"src/client/hooks/useVariationCore.ts":{"bytesInOutput":393},"src/client/hooks/useVariation.ts":{"bytesInOutput":264},"src/client/hooks/useVariationDetail.ts":{"bytesInOutput":288}},"bytes":93092}}}

package/dist/server.cjs

@@ -0,0 +1 @@
+"use strict";var t=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var p=(r,i)=>{for(var e in i)t(r,e,{get:i[e],enumerable:!0})},L=(r,i,e,o)=>{if(i&&typeof i=="object"||typeof i=="function")for(let n of u(i))!m.call(r,n)&&n!==e&&t(r,n,{get:()=>i[n],enumerable:!(o=S(i,n))||o.enumerable});return r};var f=r=>L(t({},"__esModule",{value:!0}),r);var b={};p(b,{createLDServerSession:()=>v,createLDServerWrapper:()=>D,useLDServerSession:()=>V});module.exports=f(b);var a=require("react"),s=(0,a.cache)(()=>({session:null}));function l(){return typeof window=="undefined"}function D(r,i){if(!l())throw new Error("createLDServerWrapper must only be called on the server. Ensure this module is not imported from client components.");return{initialized:()=>r.initialized(),getContext:()=>i,boolVariation:(e,o)=>r.boolVariation(e,i,o),numberVariation:(e,o)=>r.numberVariation(e,i,o),stringVariation:(e,o)=>r.stringVariation(e,i,o),jsonVariation:(e,o)=>r.jsonVariation(e,i,o),boolVariationDetail:(e,o)=>r.boolVariationDetail(e,i,o),numberVariationDetail:(e,o)=>r.numberVariationDetail(e,i,o),stringVariationDetail:(e,o)=>r.stringVariationDetail(e,i,o),jsonVariationDetail:(e,o)=>r.jsonVariationDetail(e,i,o),allFlagsState:e=>r.allFlagsState(i,e)}}function v(r,i){let e=D(r,i);return s().session=e,e}function V(){if(!l())throw new Error("useLDServerSession must only be called on the server. Ensure this module is not imported from client components.");let{session:r}=s();return r||null}0&&(module.exports={createLDServerSession,createLDServerWrapper,useLDServerSession});

package/dist/server.d.cts

@@ -0,0 +1,197 @@
+import { LDContext, LDEvaluationDetailTyped, LDFlagsStateOptions, LDFlagsState } from '@launchdarkly/js-server-sdk-common';
+
+/**
+ * A per-request evaluation scope that binds an {@link LDServerBaseClient} to a specific
+ * {@link LDContext}.
+ *
+ * @remarks
+ * This is idiomatic for React Server Components, where the context comes from the incoming
+ * request (headers, cookies, auth tokens) and does not change during the render.
+ *
+ * Create a session with {@link createLDServerSession}.
+ */
+interface LDServerSession {
+    /**
+     * Tests whether the underlying server client has completed initialization.
+     *
+     * @returns True if the client has successfully initialized.
+     */
+    initialized(): boolean;
+    /**
+     * Returns the context bound to this session.
+     */
+    getContext(): LDContext;
+    /**
+     * Determines the boolean variation of a feature flag for this session's context.
+     */
+    boolVariation(key: string, defaultValue: boolean): Promise<boolean>;
+    /**
+     * Determines the numeric variation of a feature flag for this session's context.
+     */
+    numberVariation(key: string, defaultValue: number): Promise<number>;
+    /**
+     * Determines the string variation of a feature flag for this session's context.
+     */
+    stringVariation(key: string, defaultValue: string): Promise<string>;
+    /**
+     * Determines the JSON variation of a feature flag for this session's context.
+     *
+     * This version is preferred in TypeScript because it returns `unknown` instead of `any`,
+     * requiring an explicit cast before use.
+     */
+    jsonVariation(key: string, defaultValue: unknown): Promise<unknown>;
+    /**
+     * Determines the boolean variation of a feature flag, along with evaluation details.
+     */
+    boolVariationDetail(key: string, defaultValue: boolean): Promise<LDEvaluationDetailTyped<boolean>>;
+    /**
+     * Determines the numeric variation of a feature flag, along with evaluation details.
+     */
+    numberVariationDetail(key: string, defaultValue: number): Promise<LDEvaluationDetailTyped<number>>;
+    /**
+     * Determines the string variation of a feature flag, along with evaluation details.
+     */
+    stringVariationDetail(key: string, defaultValue: string): Promise<LDEvaluationDetailTyped<string>>;
+    /**
+     * Determines the JSON variation of a feature flag, along with evaluation details.
+     */
+    jsonVariationDetail(key: string, defaultValue: unknown): Promise<LDEvaluationDetailTyped<unknown>>;
+    /**
+     * Builds an object encapsulating the state of all feature flags for this session's context.
+     *
+     * The most common use case is bootstrapping client-side flags from a back-end service.
+     * Call `toJSON()` on the returned object to get the data structure used by the client SDK.
+     */
+    allFlagsState(options?: LDFlagsStateOptions): Promise<LDFlagsState>;
+}
+
+/**
+ * A minimal structural interface that any LaunchDarkly server SDK that can be used with
+ * {@link createLDServerSession} should satisfy.
+ *
+ * @remarks
+ * This interface decouples the React SDK from the concrete `LDClient` type in
+ * `@launchdarkly/js-server-sdk-common`, allowing edge SDKs and other custom
+ * server client implementations to be used with {@link createLDServerSession}.
+ *
+ * @see {@link https://launchdarkly.github.io/js-core/packages/shared/sdk-server/docs/interfaces/LDClient.html}
+ * for more information.
+ */
+interface LDServerBaseClient {
+    /**
+     * Tests whether the client has completed initialization.
+     *
+     * @returns True if the client has successfully initialized.
+     */
+    initialized(): boolean;
+    /**
+     * Determines the boolean variation of a feature flag for a context.
+     */
+    boolVariation(key: string, context: LDContext, defaultValue: boolean): Promise<boolean>;
+    /**
+     * Determines the numeric variation of a feature flag for a context.
+     */
+    numberVariation(key: string, context: LDContext, defaultValue: number): Promise<number>;
+    /**
+     * Determines the string variation of a feature flag for a context.
+     */
+    stringVariation(key: string, context: LDContext, defaultValue: string): Promise<string>;
+    /**
+     * Determines the JSON variation of a feature flag for a context.
+     *
+     * This version is preferred in TypeScript because it returns `unknown` instead of `any`,
+     * requiring an explicit cast before use.
+     */
+    jsonVariation(key: string, context: LDContext, defaultValue: unknown): Promise<unknown>;
+    /**
+     * Determines the boolean variation of a feature flag, along with evaluation details.
+     */
+    boolVariationDetail(key: string, context: LDContext, defaultValue: boolean): Promise<LDEvaluationDetailTyped<boolean>>;
+    /**
+     * Determines the numeric variation of a feature flag, along with evaluation details.
+     */
+    numberVariationDetail(key: string, context: LDContext, defaultValue: number): Promise<LDEvaluationDetailTyped<number>>;
+    /**
+     * Determines the string variation of a feature flag, along with evaluation details.
+     */
+    stringVariationDetail(key: string, context: LDContext, defaultValue: string): Promise<LDEvaluationDetailTyped<string>>;
+    /**
+     * Determines the JSON variation of a feature flag, along with evaluation details.
+     */
+    jsonVariationDetail(key: string, context: LDContext, defaultValue: unknown): Promise<LDEvaluationDetailTyped<unknown>>;
+    /**
+     * Builds an object encapsulating the state of all feature flags for a given context.
+     */
+    allFlagsState(context: LDContext, options?: LDFlagsStateOptions): Promise<LDFlagsState>;
+}
+
+/**
+ * Creates a LaunchDarkly server SDK client that is scoped to a specific context.
+ *
+ * @remarks
+ * **NOTE:** We recommend using the {@link createLDServerSession} function to create your server session
+ * instead of directly calling this function.
+ *
+ * This function is provided to allow the caller to have more control over handling their scoped LD client.
+ * If using this function, the caller is responsible for managing the lifecycle of the created wrapped client.
+ *
+ * @throws {Error} If called in a browser environment. This function must only be called on the
+ *   server. Ensure the module that calls this is not imported from client components.
+ *
+ * @example
+ * ```ts
+ * // lib/ld-server.ts
+ * import { init } from '@launchdarkly/node-server-sdk';
+ * import { createLDServerSession } from '@launchdarkly/react-sdk/server';
+ *
+ * const ldBaseClient = await init(process.env.LAUNCHDARKLY_SDK_KEY || '');
+ * export const serverSession = createLDServerSession(ldBaseClient, defaultContext);
+ * ```
+ *
+ * @param client Any LaunchDarkly server SDK client that satisfies {@link LDServerBaseClient}.
+ * @param context The context to bind to this session. Typically resolved from the request
+ *   (e.g. from auth tokens, cookies, or headers).
+ * @returns An {@link LDServerSession} scoped to the given context.
+ */
+declare function createLDServerWrapper(client: LDServerBaseClient, context: LDContext): LDServerSession;
+/**
+ * Creates a per-request evaluation scope by binding an {@link LDServerBaseClient} to a specific
+ * context.
+ *
+ * @param client Any LaunchDarkly server SDK client that satisfies {@link LDServerBaseClient}.
+ * @param context The context to bind to this session. Typically resolved from the request
+ *   (e.g. from auth tokens, cookies, or headers).
+ * @returns An {@link LDServerSession} scoped to the given context.
+ */
+declare function createLDServerSession(client: LDServerBaseClient, context: LDContext): LDServerSession;
+/**
+ * Returns the {@link LDServerSession} scoped to the current request.
+ *
+ * @remarks
+ * **NOTE:** This function is only used to retrieve the session stored by {@link createLDServerSession}.
+ * You must call {@link createLDServerSession} before calling this function or it will return a null value.
+ *
+ * @example
+ * ```ts
+ * // app.tsx (entry point)
+ * import { createLDServerSession } from '@launchdarkly/react-sdk/server';
+ * const session = createLDServerSession(client, context);
+ *
+ * // component.ts
+ * import { useLDServerSession } from '@launchdarkly/react-sdk/server';
+ *
+ * export default function MyComponent() {
+ *   const session = useLDServerSession();
+ *   if (session) {
+ *     const flagValue = await session.boolVariation('my-flag', false);
+ *     return <div>{flagValue ? 'Yes' : 'No'}</div>;
+ *   }
+ *   return <div>Loading...</div>;
+ * }
+ * ```
+ *
+ * @returns The {@link LDServerSession} scoped to the current request, or `null` if no session has been created.
+ */
+declare function useLDServerSession(): LDServerSession | null;
+
+export { type LDServerBaseClient, type LDServerSession, createLDServerSession, createLDServerWrapper, useLDServerSession };

package/dist/server.d.ts

@@ -0,0 +1,197 @@
+import { LDContext, LDEvaluationDetailTyped, LDFlagsStateOptions, LDFlagsState } from '@launchdarkly/js-server-sdk-common';
+
+/**
+ * A per-request evaluation scope that binds an {@link LDServerBaseClient} to a specific
+ * {@link LDContext}.
+ *
+ * @remarks
+ * This is idiomatic for React Server Components, where the context comes from the incoming
+ * request (headers, cookies, auth tokens) and does not change during the render.
+ *
+ * Create a session with {@link createLDServerSession}.
+ */
+interface LDServerSession {
+    /**
+     * Tests whether the underlying server client has completed initialization.
+     *
+     * @returns True if the client has successfully initialized.
+     */
+    initialized(): boolean;
+    /**
+     * Returns the context bound to this session.
+     */
+    getContext(): LDContext;
+    /**
+     * Determines the boolean variation of a feature flag for this session's context.
+     */
+    boolVariation(key: string, defaultValue: boolean): Promise<boolean>;
+    /**
+     * Determines the numeric variation of a feature flag for this session's context.
+     */
+    numberVariation(key: string, defaultValue: number): Promise<number>;
+    /**
+     * Determines the string variation of a feature flag for this session's context.
+     */
+    stringVariation(key: string, defaultValue: string): Promise<string>;
+    /**
+     * Determines the JSON variation of a feature flag for this session's context.
+     *
+     * This version is preferred in TypeScript because it returns `unknown` instead of `any`,
+     * requiring an explicit cast before use.
+     */
+    jsonVariation(key: string, defaultValue: unknown): Promise<unknown>;
+    /**
+     * Determines the boolean variation of a feature flag, along with evaluation details.
+     */
+    boolVariationDetail(key: string, defaultValue: boolean): Promise<LDEvaluationDetailTyped<boolean>>;
+    /**
+     * Determines the numeric variation of a feature flag, along with evaluation details.
+     */
+    numberVariationDetail(key: string, defaultValue: number): Promise<LDEvaluationDetailTyped<number>>;
+    /**
+     * Determines the string variation of a feature flag, along with evaluation details.
+     */
+    stringVariationDetail(key: string, defaultValue: string): Promise<LDEvaluationDetailTyped<string>>;
+    /**
+     * Determines the JSON variation of a feature flag, along with evaluation details.
+     */
+    jsonVariationDetail(key: string, defaultValue: unknown): Promise<LDEvaluationDetailTyped<unknown>>;
+    /**
+     * Builds an object encapsulating the state of all feature flags for this session's context.
+     *
+     * The most common use case is bootstrapping client-side flags from a back-end service.
+     * Call `toJSON()` on the returned object to get the data structure used by the client SDK.
+     */
+    allFlagsState(options?: LDFlagsStateOptions): Promise<LDFlagsState>;
+}
+
+/**
+ * A minimal structural interface that any LaunchDarkly server SDK that can be used with
+ * {@link createLDServerSession} should satisfy.
+ *
+ * @remarks
+ * This interface decouples the React SDK from the concrete `LDClient` type in
+ * `@launchdarkly/js-server-sdk-common`, allowing edge SDKs and other custom
+ * server client implementations to be used with {@link createLDServerSession}.
+ *
+ * @see {@link https://launchdarkly.github.io/js-core/packages/shared/sdk-server/docs/interfaces/LDClient.html}
+ * for more information.
+ */
+interface LDServerBaseClient {
+    /**
+     * Tests whether the client has completed initialization.
+     *
+     * @returns True if the client has successfully initialized.
+     */
+    initialized(): boolean;
+    /**
+     * Determines the boolean variation of a feature flag for a context.
+     */
+    boolVariation(key: string, context: LDContext, defaultValue: boolean): Promise<boolean>;
+    /**
+     * Determines the numeric variation of a feature flag for a context.
+     */
+    numberVariation(key: string, context: LDContext, defaultValue: number): Promise<number>;
+    /**
+     * Determines the string variation of a feature flag for a context.
+     */
+    stringVariation(key: string, context: LDContext, defaultValue: string): Promise<string>;
+    /**
+     * Determines the JSON variation of a feature flag for a context.
+     *
+     * This version is preferred in TypeScript because it returns `unknown` instead of `any`,
+     * requiring an explicit cast before use.
+     */
+    jsonVariation(key: string, context: LDContext, defaultValue: unknown): Promise<unknown>;
+    /**
+     * Determines the boolean variation of a feature flag, along with evaluation details.
+     */
+    boolVariationDetail(key: string, context: LDContext, defaultValue: boolean): Promise<LDEvaluationDetailTyped<boolean>>;
+    /**
+     * Determines the numeric variation of a feature flag, along with evaluation details.
+     */
+    numberVariationDetail(key: string, context: LDContext, defaultValue: number): Promise<LDEvaluationDetailTyped<number>>;
+    /**
+     * Determines the string variation of a feature flag, along with evaluation details.
+     */
+    stringVariationDetail(key: string, context: LDContext, defaultValue: string): Promise<LDEvaluationDetailTyped<string>>;
+    /**
+     * Determines the JSON variation of a feature flag, along with evaluation details.
+     */
+    jsonVariationDetail(key: string, context: LDContext, defaultValue: unknown): Promise<LDEvaluationDetailTyped<unknown>>;
+    /**
+     * Builds an object encapsulating the state of all feature flags for a given context.
+     */
+    allFlagsState(context: LDContext, options?: LDFlagsStateOptions): Promise<LDFlagsState>;
+}
+
+/**
+ * Creates a LaunchDarkly server SDK client that is scoped to a specific context.
+ *
+ * @remarks
+ * **NOTE:** We recommend using the {@link createLDServerSession} function to create your server session
+ * instead of directly calling this function.
+ *
+ * This function is provided to allow the caller to have more control over handling their scoped LD client.
+ * If using this function, the caller is responsible for managing the lifecycle of the created wrapped client.
+ *
+ * @throws {Error} If called in a browser environment. This function must only be called on the
+ *   server. Ensure the module that calls this is not imported from client components.
+ *
+ * @example
+ * ```ts
+ * // lib/ld-server.ts
+ * import { init } from '@launchdarkly/node-server-sdk';
+ * import { createLDServerSession } from '@launchdarkly/react-sdk/server';
+ *
+ * const ldBaseClient = await init(process.env.LAUNCHDARKLY_SDK_KEY || '');
+ * export const serverSession = createLDServerSession(ldBaseClient, defaultContext);
+ * ```
+ *
+ * @param client Any LaunchDarkly server SDK client that satisfies {@link LDServerBaseClient}.
+ * @param context The context to bind to this session. Typically resolved from the request
+ *   (e.g. from auth tokens, cookies, or headers).
+ * @returns An {@link LDServerSession} scoped to the given context.
+ */
+declare function createLDServerWrapper(client: LDServerBaseClient, context: LDContext): LDServerSession;
+/**
+ * Creates a per-request evaluation scope by binding an {@link LDServerBaseClient} to a specific
+ * context.
+ *
+ * @param client Any LaunchDarkly server SDK client that satisfies {@link LDServerBaseClient}.
+ * @param context The context to bind to this session. Typically resolved from the request
+ *   (e.g. from auth tokens, cookies, or headers).
+ * @returns An {@link LDServerSession} scoped to the given context.
+ */
+declare function createLDServerSession(client: LDServerBaseClient, context: LDContext): LDServerSession;
+/**
+ * Returns the {@link LDServerSession} scoped to the current request.
+ *
+ * @remarks
+ * **NOTE:** This function is only used to retrieve the session stored by {@link createLDServerSession}.
+ * You must call {@link createLDServerSession} before calling this function or it will return a null value.
+ *
+ * @example
+ * ```ts
+ * // app.tsx (entry point)
+ * import { createLDServerSession } from '@launchdarkly/react-sdk/server';
+ * const session = createLDServerSession(client, context);
+ *
+ * // component.ts
+ * import { useLDServerSession } from '@launchdarkly/react-sdk/server';
+ *
+ * export default function MyComponent() {
+ *   const session = useLDServerSession();
+ *   if (session) {
+ *     const flagValue = await session.boolVariation('my-flag', false);
+ *     return <div>{flagValue ? 'Yes' : 'No'}</div>;
+ *   }
+ *   return <div>Loading...</div>;
+ * }
+ * ```
+ *
+ * @returns The {@link LDServerSession} scoped to the current request, or `null` if no session has been created.
+ */
+declare function useLDServerSession(): LDServerSession | null;
+
+export { type LDServerBaseClient, type LDServerSession, createLDServerSession, createLDServerWrapper, useLDServerSession };

package/dist/server.js

@@ -0,0 +1 @@
+import{cache as a}from"react";var n=a(()=>({session:null}));function t(){return typeof window=="undefined"}function s(r,o){if(!t())throw new Error("createLDServerWrapper must only be called on the server. Ensure this module is not imported from client components.");return{initialized:()=>r.initialized(),getContext:()=>o,boolVariation:(e,i)=>r.boolVariation(e,o,i),numberVariation:(e,i)=>r.numberVariation(e,o,i),stringVariation:(e,i)=>r.stringVariation(e,o,i),jsonVariation:(e,i)=>r.jsonVariation(e,o,i),boolVariationDetail:(e,i)=>r.boolVariationDetail(e,o,i),numberVariationDetail:(e,i)=>r.numberVariationDetail(e,o,i),stringVariationDetail:(e,i)=>r.stringVariationDetail(e,o,i),jsonVariationDetail:(e,i)=>r.jsonVariationDetail(e,o,i),allFlagsState:e=>r.allFlagsState(o,e)}}function D(r,o){let e=s(r,o);return n().session=e,e}function S(){if(!t())throw new Error("useLDServerSession must only be called on the server. Ensure this module is not imported from client components.");let{session:r}=n();return r||null}export{D as createLDServerSession,s as createLDServerWrapper,S as useLDServerSession};

package/package.json

@@ -1,5 +1,78 @@
 {
   "name": "@launchdarkly/react-sdk",
-  "version": "0.0.0",
-  "description": ""
-}
+  "version": "0.1.0",
+  "description": "LaunchDarkly SDK for React frameworks",
+  "homepage": "https://github.com/launchdarkly/js-core/tree/main/packages/sdk/react",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/launchdarkly/js-core.git"
+  },
+  "license": "Apache-2.0",
+  "packageManager": "yarn@4.2.2",
+  "keywords": [
+    "launchdarkly",
+    "react",
+    "isomorphic",
+    "nextjs",
+    "remix"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsup",
+    "test": "npx jest --ci",
+    "lint": "eslint . --ext .ts,.tsx",
+    "prettier": "prettier --write '**/*.@(js|ts|tsx|json|css)' --ignore-path ../../../.prettierignore"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs",
+      "default": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.0.0",
+    "@trivago/prettier-plugin-sort-imports": "^4.1.1",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^6.20.0",
+    "@typescript-eslint/parser": "^6.20.0",
+    "eslint": "^8.45.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-airbnb-typescript": "^17.1.0",
+    "eslint-config-prettier": "^8.8.0",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-jest": "^27.6.3",
+    "eslint-plugin-prettier": "^5.0.0",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.0.0",
+    "prettier": "^3.8.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tsup": "^8.5.1",
+    "tsup-plugin-prepend-directive": "^0.1.2",
+    "typedoc": "0.25.0",
+    "typescript": "5.1.6"
+  },
+  "dependencies": {
+    "@launchdarkly/js-client-sdk": "^4.4.1",
+    "@launchdarkly/js-server-sdk-common": "^2.18.3"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  }
+}