@savvagent/solid 1.0.0 → 1.0.1

package/dist/index.d.mts

@@ -1,10 +1,39 @@
 import * as solid_js from 'solid-js';
 import { ParentProps, Accessor } from 'solid-js';
 import { FlagClientConfig, FlagClient, FlagContext, FlagEvaluationResult } from '@savvagent/sdk';
-export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';
+export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagDefinition, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';
 
+/**
+ * Default context values that apply to all flag evaluations
+ * Per SDK Developer Guide: https://docs.savvagent.com/sdk-developer-guide
+ */
+interface DefaultFlagContext {
+    /** Application ID for application-scoped flags */
+    applicationId?: string;
+    /** Environment (development, staging, production) */
+    environment?: string;
+    /** Organization ID for multi-tenant apps */
+    organizationId?: string;
+    /** Default user ID (required for percentage rollouts) */
+    userId?: string;
+    /** Default anonymous ID (alternative to userId for anonymous users) */
+    anonymousId?: string;
+    /** Session ID as fallback identifier */
+    sessionId?: string;
+    /** User's language code (e.g., "en", "es") */
+    language?: string;
+    /** Default attributes for targeting */
+    attributes?: Record<string, any>;
+}
+interface SavvagentContextValue {
+    client: FlagClient;
+    isReady: Accessor<boolean>;
+    defaultContext: Accessor<FlagContext>;
+}
 interface SavvagentProviderProps extends ParentProps {
     config: FlagClientConfig;
+    /** Default context values applied to all flag evaluations */
+    defaultContext?: DefaultFlagContext;
 }
 /**
  * Provider component that initializes and provides the Savvagent client.
@@ -15,7 +44,15 @@ interface SavvagentProviderProps extends ParentProps {
  *
  * function App() {
  *   return (
- *     <SavvagentProvider config={{ apiKey: 'sdk_...' }}>
+ *     <SavvagentProvider
+ *       config={{ apiKey: 'sdk_...' }}
+ *       defaultContext={{
+ *         applicationId: 'my-app-id',
+ *         environment: 'development',
+ *         userId: 'user-123',
+ *         attributes: { plan: 'pro' }
+ *       }}
+ *     >
  *       <MyApp />
  *     </SavvagentProvider>
  *   );
@@ -24,10 +61,10 @@ interface SavvagentProviderProps extends ParentProps {
  */
 declare function SavvagentProvider(props: SavvagentProviderProps): solid_js.JSX.Element;
 /**
- * Get the Savvagent client instance.
+ * Get the Savvagent context including client, ready state, and default context.
  * Must be used within a SavvagentProvider.
  *
- * @returns The FlagClient instance
+ * @returns The FlagClient instance, ready state accessor, and default context accessor
  * @throws Error if used outside of SavvagentProvider
  *
  * @example
@@ -35,13 +72,17 @@ declare function SavvagentProvider(props: SavvagentProviderProps): solid_js.JSX.
  * import { useSavvagent } from '@savvagent/solid';
  *
  * function MyComponent() {
- *   const client = useSavvagent();
- *   const enabled = await client.isEnabled('my-feature');
- *   return <div>Enabled: {enabled}</div>;
+ *   const { client, isReady, defaultContext } = useSavvagent();
+ *
+ *   return (
+ *     <Show when={isReady()}>
+ *       <div>Client ready!</div>
+ *     </Show>
+ *   );
  * }
  * ```
  */
-declare function useSavvagent(): FlagClient;
+declare function useSavvagent(): SavvagentContextValue;
 interface CreateFlagOptions {
     /** Context for flag evaluation */
     context?: FlagContext;
@@ -118,34 +159,178 @@ declare function createFlag(flagKey: string, options?: CreateFlagOptions): Creat
  * ```
  */
 declare function createFlagValue(flagKey: string, options?: CreateFlagOptions): Accessor<boolean>;
+interface CreateFlagsOptions {
+    /** Context for flag evaluation */
+    context?: FlagContext;
+    /** Default values for flags (keyed by flag key) */
+    defaultValues?: Record<string, boolean>;
+    /** Enable real-time updates */
+    realtime?: boolean;
+    /** Custom error handler */
+    onError?: (error: Error, flagKey: string) => void;
+}
+interface CreateFlagsReturn {
+    /** Map of flag keys to their current values */
+    values: Accessor<Record<string, boolean>>;
+    /** Whether any flag is currently being evaluated */
+    loading: Accessor<boolean>;
+    /** Map of flag keys to their errors (if any) */
+    errors: Accessor<Record<string, Error | null>>;
+    /** Map of flag keys to their detailed evaluation results */
+    results: Accessor<Record<string, FlagEvaluationResult | null>>;
+    /** Force re-evaluation of all flags */
+    refetch: () => void;
+}
 /**
- * Create signals for user identification.
+ * Create reactive flags for multiple flag keys with a single state update.
+ * This is more efficient than using multiple createFlag calls when you need
+ * several flags in the same component.
  *
- * @returns User ID management functions
+ * @param flagKeys - Array of feature flag keys to evaluate
+ * @param options - Configuration options
+ * @returns Reactive flag state for all flags
  *
  * @example
  * ```tsx
- * import { createUserSignals } from '@savvagent/solid';
+ * import { createFlags } from '@savvagent/solid';
+ * import { Show, For } from 'solid-js';
+ *
+ * function MyComponent() {
+ *   const flags = createFlags(
+ *     ['feature-a', 'feature-b', 'feature-c'],
+ *     {
+ *       context: { user_id: 'user-123' },
+ *       defaultValues: { 'feature-a': false, 'feature-b': true },
+ *       realtime: true
+ *     }
+ *   );
+ *
+ *   return (
+ *     <Show when={!flags.loading()} fallback={<Spinner />}>
+ *       <div>
+ *         <Show when={flags.values()['feature-a']}>
+ *           <FeatureA />
+ *         </Show>
+ *         <Show when={flags.values()['feature-b']}>
+ *           <FeatureB />
+ *         </Show>
+ *       </div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+declare function createFlags(flagKeys: string[], options?: CreateFlagsOptions): CreateFlagsReturn;
+/**
+ * Execute a callback conditionally based on a flag value.
+ *
+ * @param flagKey - The feature flag key to check
+ * @param callback - Function to execute if flag is enabled
+ * @param options - Configuration options
+ *
+ * @example
+ * ```tsx
+ * import { createWithFlag } from '@savvagent/solid';
+ *
+ * function MyComponent() {
+ *   createWithFlag('analytics-enabled', async () => {
+ *     await trackEvent('page_view');
+ *   });
+ *
+ *   return <div>Content</div>;
+ * }
+ * ```
+ */
+declare function createWithFlag(flagKey: string, callback: () => void | Promise<void>, options?: CreateFlagOptions): void;
+interface CreateUserReturn {
+    /** Current user ID */
+    userId: Accessor<string | null>;
+    /** Set user ID */
+    setUserId: (id: string | null) => void;
+    /** Get current user ID from client */
+    getUserId: () => string | null;
+    /** Current anonymous ID */
+    anonymousId: Accessor<string | null>;
+    /** Set anonymous ID */
+    setAnonymousId: (id: string) => void;
+    /** Get current anonymous ID from client */
+    getAnonymousId: () => string | null;
+}
+/**
+ * Create signals for user identification management.
+ *
+ * @returns User ID management functions and reactive signals
+ *
+ * @example
+ * ```tsx
+ * import { createUser } from '@savvagent/solid';
  * import { createEffect } from 'solid-js';
  *
  * function AuthHandler() {
- *   const [userId, setUserId] = createUserSignals();
+ *   const user = createUser();
  *
  *   createEffect(() => {
  *     if (currentUser()) {
- *       setUserId(currentUser().id);
+ *       user.setUserId(currentUser().id);
  *     } else {
- *       setUserId(null);
+ *       user.setUserId(null);
  *     }
  *   });
  *
- *   return null;
+ *   return <div>User ID: {user.userId()}</div>;
+ * }
+ * ```
+ */
+declare function createUser(): CreateUserReturn;
+/**
+ * Legacy function - use createUser() instead.
+ * Create signals for user identification.
+ *
+ * @returns User ID signal tuple [userId, setUserId]
+ * @deprecated Use createUser() for full user management
+ *
+ * @example
+ * ```tsx
+ * import { createUserSignals } from '@savvagent/solid';
+ *
+ * function AuthHandler() {
+ *   const [userId, setUserId] = createUserSignals();
+ *
+ *   return <div>User ID: {userId()}</div>;
  * }
  * ```
  */
 declare function createUserSignals(): readonly [Accessor<string | null>, (id: string | null) => void];
+/**
+ * Create an error tracking function for a specific flag.
+ *
+ * @param flagKey - The flag key associated with errors
+ * @param context - Optional context
+ * @returns Error tracking function
+ *
+ * @example
+ * ```tsx
+ * import { createTrackError } from '@savvagent/solid';
+ *
+ * function FeatureComponent() {
+ *   const trackError = createTrackError('new-feature');
+ *
+ *   const handleAction = async () => {
+ *     try {
+ *       await doSomething();
+ *     } catch (error) {
+ *       trackError(error as Error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleAction}>Try Feature</button>;
+ * }
+ * ```
+ */
+declare function createTrackError(flagKey: string, context?: FlagContext): (error: Error) => void;
 /**
  * Track an error with flag context.
+ * Direct function call (not reactive).
  *
  * @param flagKey - The flag key associated with the error
  * @param error - The error that occurred
@@ -170,4 +355,4 @@ declare function createUserSignals(): readonly [Accessor<string | null>, (id: st
  */
 declare function trackError(flagKey: string, error: Error, context?: FlagContext): void;
 
-export { type CreateFlagOptions, type CreateFlagReturn, SavvagentProvider, type SavvagentProviderProps, createFlag, createFlagValue, createUserSignals, trackError, useSavvagent };
+export { type CreateFlagOptions, type CreateFlagReturn, type CreateFlagsOptions, type CreateFlagsReturn, type CreateUserReturn, type DefaultFlagContext, SavvagentProvider, type SavvagentProviderProps, createFlag, createFlagValue, createFlags, createTrackError, createUser, createUserSignals, createWithFlag, trackError, useSavvagent };

package/dist/index.d.ts

@@ -1,10 +1,39 @@
 import * as solid_js from 'solid-js';
 import { ParentProps, Accessor } from 'solid-js';
 import { FlagClientConfig, FlagClient, FlagContext, FlagEvaluationResult } from '@savvagent/sdk';
-export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';
+export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagDefinition, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';
 
+/**
+ * Default context values that apply to all flag evaluations
+ * Per SDK Developer Guide: https://docs.savvagent.com/sdk-developer-guide
+ */
+interface DefaultFlagContext {
+    /** Application ID for application-scoped flags */
+    applicationId?: string;
+    /** Environment (development, staging, production) */
+    environment?: string;
+    /** Organization ID for multi-tenant apps */
+    organizationId?: string;
+    /** Default user ID (required for percentage rollouts) */
+    userId?: string;
+    /** Default anonymous ID (alternative to userId for anonymous users) */
+    anonymousId?: string;
+    /** Session ID as fallback identifier */
+    sessionId?: string;
+    /** User's language code (e.g., "en", "es") */
+    language?: string;
+    /** Default attributes for targeting */
+    attributes?: Record<string, any>;
+}
+interface SavvagentContextValue {
+    client: FlagClient;
+    isReady: Accessor<boolean>;
+    defaultContext: Accessor<FlagContext>;
+}
 interface SavvagentProviderProps extends ParentProps {
     config: FlagClientConfig;
+    /** Default context values applied to all flag evaluations */
+    defaultContext?: DefaultFlagContext;
 }
 /**
  * Provider component that initializes and provides the Savvagent client.
@@ -15,7 +44,15 @@ interface SavvagentProviderProps extends ParentProps {
  *
  * function App() {
  *   return (
- *     <SavvagentProvider config={{ apiKey: 'sdk_...' }}>
+ *     <SavvagentProvider
+ *       config={{ apiKey: 'sdk_...' }}
+ *       defaultContext={{
+ *         applicationId: 'my-app-id',
+ *         environment: 'development',
+ *         userId: 'user-123',
+ *         attributes: { plan: 'pro' }
+ *       }}
+ *     >
  *       <MyApp />
  *     </SavvagentProvider>
  *   );
@@ -24,10 +61,10 @@ interface SavvagentProviderProps extends ParentProps {
  */
 declare function SavvagentProvider(props: SavvagentProviderProps): solid_js.JSX.Element;
 /**
- * Get the Savvagent client instance.
+ * Get the Savvagent context including client, ready state, and default context.
  * Must be used within a SavvagentProvider.
  *
- * @returns The FlagClient instance
+ * @returns The FlagClient instance, ready state accessor, and default context accessor
  * @throws Error if used outside of SavvagentProvider
  *
  * @example
@@ -35,13 +72,17 @@ declare function SavvagentProvider(props: SavvagentProviderProps): solid_js.JSX.
  * import { useSavvagent } from '@savvagent/solid';
  *
  * function MyComponent() {
- *   const client = useSavvagent();
- *   const enabled = await client.isEnabled('my-feature');
- *   return <div>Enabled: {enabled}</div>;
+ *   const { client, isReady, defaultContext } = useSavvagent();
+ *
+ *   return (
+ *     <Show when={isReady()}>
+ *       <div>Client ready!</div>
+ *     </Show>
+ *   );
  * }
  * ```
  */
-declare function useSavvagent(): FlagClient;
+declare function useSavvagent(): SavvagentContextValue;
 interface CreateFlagOptions {
     /** Context for flag evaluation */
     context?: FlagContext;
@@ -118,34 +159,178 @@ declare function createFlag(flagKey: string, options?: CreateFlagOptions): Creat
  * ```
  */
 declare function createFlagValue(flagKey: string, options?: CreateFlagOptions): Accessor<boolean>;
+interface CreateFlagsOptions {
+    /** Context for flag evaluation */
+    context?: FlagContext;
+    /** Default values for flags (keyed by flag key) */
+    defaultValues?: Record<string, boolean>;
+    /** Enable real-time updates */
+    realtime?: boolean;
+    /** Custom error handler */
+    onError?: (error: Error, flagKey: string) => void;
+}
+interface CreateFlagsReturn {
+    /** Map of flag keys to their current values */
+    values: Accessor<Record<string, boolean>>;
+    /** Whether any flag is currently being evaluated */
+    loading: Accessor<boolean>;
+    /** Map of flag keys to their errors (if any) */
+    errors: Accessor<Record<string, Error | null>>;
+    /** Map of flag keys to their detailed evaluation results */
+    results: Accessor<Record<string, FlagEvaluationResult | null>>;
+    /** Force re-evaluation of all flags */
+    refetch: () => void;
+}
 /**
- * Create signals for user identification.
+ * Create reactive flags for multiple flag keys with a single state update.
+ * This is more efficient than using multiple createFlag calls when you need
+ * several flags in the same component.
  *
- * @returns User ID management functions
+ * @param flagKeys - Array of feature flag keys to evaluate
+ * @param options - Configuration options
+ * @returns Reactive flag state for all flags
  *
  * @example
  * ```tsx
- * import { createUserSignals } from '@savvagent/solid';
+ * import { createFlags } from '@savvagent/solid';
+ * import { Show, For } from 'solid-js';
+ *
+ * function MyComponent() {
+ *   const flags = createFlags(
+ *     ['feature-a', 'feature-b', 'feature-c'],
+ *     {
+ *       context: { user_id: 'user-123' },
+ *       defaultValues: { 'feature-a': false, 'feature-b': true },
+ *       realtime: true
+ *     }
+ *   );
+ *
+ *   return (
+ *     <Show when={!flags.loading()} fallback={<Spinner />}>
+ *       <div>
+ *         <Show when={flags.values()['feature-a']}>
+ *           <FeatureA />
+ *         </Show>
+ *         <Show when={flags.values()['feature-b']}>
+ *           <FeatureB />
+ *         </Show>
+ *       </div>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+declare function createFlags(flagKeys: string[], options?: CreateFlagsOptions): CreateFlagsReturn;
+/**
+ * Execute a callback conditionally based on a flag value.
+ *
+ * @param flagKey - The feature flag key to check
+ * @param callback - Function to execute if flag is enabled
+ * @param options - Configuration options
+ *
+ * @example
+ * ```tsx
+ * import { createWithFlag } from '@savvagent/solid';
+ *
+ * function MyComponent() {
+ *   createWithFlag('analytics-enabled', async () => {
+ *     await trackEvent('page_view');
+ *   });
+ *
+ *   return <div>Content</div>;
+ * }
+ * ```
+ */
+declare function createWithFlag(flagKey: string, callback: () => void | Promise<void>, options?: CreateFlagOptions): void;
+interface CreateUserReturn {
+    /** Current user ID */
+    userId: Accessor<string | null>;
+    /** Set user ID */
+    setUserId: (id: string | null) => void;
+    /** Get current user ID from client */
+    getUserId: () => string | null;
+    /** Current anonymous ID */
+    anonymousId: Accessor<string | null>;
+    /** Set anonymous ID */
+    setAnonymousId: (id: string) => void;
+    /** Get current anonymous ID from client */
+    getAnonymousId: () => string | null;
+}
+/**
+ * Create signals for user identification management.
+ *
+ * @returns User ID management functions and reactive signals
+ *
+ * @example
+ * ```tsx
+ * import { createUser } from '@savvagent/solid';
  * import { createEffect } from 'solid-js';
  *
  * function AuthHandler() {
- *   const [userId, setUserId] = createUserSignals();
+ *   const user = createUser();
  *
  *   createEffect(() => {
  *     if (currentUser()) {
- *       setUserId(currentUser().id);
+ *       user.setUserId(currentUser().id);
  *     } else {
- *       setUserId(null);
+ *       user.setUserId(null);
  *     }
  *   });
  *
- *   return null;
+ *   return <div>User ID: {user.userId()}</div>;
+ * }
+ * ```
+ */
+declare function createUser(): CreateUserReturn;
+/**
+ * Legacy function - use createUser() instead.
+ * Create signals for user identification.
+ *
+ * @returns User ID signal tuple [userId, setUserId]
+ * @deprecated Use createUser() for full user management
+ *
+ * @example
+ * ```tsx
+ * import { createUserSignals } from '@savvagent/solid';
+ *
+ * function AuthHandler() {
+ *   const [userId, setUserId] = createUserSignals();
+ *
+ *   return <div>User ID: {userId()}</div>;
  * }
  * ```
  */
 declare function createUserSignals(): readonly [Accessor<string | null>, (id: string | null) => void];
+/**
+ * Create an error tracking function for a specific flag.
+ *
+ * @param flagKey - The flag key associated with errors
+ * @param context - Optional context
+ * @returns Error tracking function
+ *
+ * @example
+ * ```tsx
+ * import { createTrackError } from '@savvagent/solid';
+ *
+ * function FeatureComponent() {
+ *   const trackError = createTrackError('new-feature');
+ *
+ *   const handleAction = async () => {
+ *     try {
+ *       await doSomething();
+ *     } catch (error) {
+ *       trackError(error as Error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleAction}>Try Feature</button>;
+ * }
+ * ```
+ */
+declare function createTrackError(flagKey: string, context?: FlagContext): (error: Error) => void;
 /**
  * Track an error with flag context.
+ * Direct function call (not reactive).
  *
  * @param flagKey - The flag key associated with the error
  * @param error - The error that occurred
@@ -170,4 +355,4 @@ declare function createUserSignals(): readonly [Accessor<string | null>, (id: st
  */
 declare function trackError(flagKey: string, error: Error, context?: FlagContext): void;
 
-export { type CreateFlagOptions, type CreateFlagReturn, SavvagentProvider, type SavvagentProviderProps, createFlag, createFlagValue, createUserSignals, trackError, useSavvagent };
+export { type CreateFlagOptions, type CreateFlagReturn, type CreateFlagsOptions, type CreateFlagsReturn, type CreateUserReturn, type DefaultFlagContext, SavvagentProvider, type SavvagentProviderProps, createFlag, createFlagValue, createFlags, createTrackError, createUser, createUserSignals, createWithFlag, trackError, useSavvagent };

package/dist/index.js

@@ -24,31 +24,87 @@ __export(index_exports, {
   SavvagentProvider: () => SavvagentProvider,
   createFlag: () => createFlag,
   createFlagValue: () => createFlagValue,
+  createFlags: () => createFlags,
+  createTrackError: () => createTrackError,
+  createUser: () => createUser,
   createUserSignals: () => createUserSignals,
+  createWithFlag: () => createWithFlag,
   trackError: () => trackError,
   useSavvagent: () => useSavvagent
 });
 module.exports = __toCommonJS(index_exports);
+var import_web = require("solid-js/web");
 var import_solid_js = require("solid-js");
 var import_sdk = require("@savvagent/sdk");
 var import_sdk2 = require("@savvagent/sdk");
 var SavvagentContext = (0, import_solid_js.createContext)();
 function SavvagentProvider(props) {
-  const client = new import_sdk.FlagClient(props.config);
+  const [isReady, setIsReady] = (0, import_solid_js.createSignal)(false);
+  let client;
+  try {
+    client = new import_sdk.FlagClient(props.config);
+    setIsReady(true);
+  } catch (error) {
+    console.error("[Savvagent] Failed to initialize client:", error);
+    props.config.onError?.(error);
+    client = new import_sdk.FlagClient({
+      ...props.config,
+      apiKey: ""
+    });
+  }
+  const normalizedDefaultContext = (0, import_solid_js.createMemo)(() => ({
+    application_id: props.defaultContext?.applicationId,
+    environment: props.defaultContext?.environment,
+    organization_id: props.defaultContext?.organizationId,
+    user_id: props.defaultContext?.userId,
+    anonymous_id: props.defaultContext?.anonymousId,
+    session_id: props.defaultContext?.sessionId,
+    language: props.defaultContext?.language,
+    attributes: props.defaultContext?.attributes
+  }));
   (0, import_solid_js.onCleanup)(() => {
     client.close();
   });
-  return /* @__PURE__ */ React.createElement(SavvagentContext.Provider, { value: client }, props.children);
+  const contextValue = {
+    client,
+    isReady,
+    defaultContext: normalizedDefaultContext
+  };
+  return (0, import_web.createComponent)(SavvagentContext.Provider, {
+    value: contextValue,
+    get children() {
+      return props.children;
+    }
+  });
 }
 function useSavvagent() {
-  const client = (0, import_solid_js.useContext)(SavvagentContext);
-  if (!client) {
+  const context = (0, import_solid_js.useContext)(SavvagentContext);
+  if (!context) {
     throw new Error("useSavvagent must be used within a SavvagentProvider");
   }
-  return client;
+  return context;
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return a === b;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!keysB.includes(key)) return false;
+    if (!deepEqual(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
 }
 function createFlag(flagKey, options = {}) {
-  const client = useSavvagent();
+  const {
+    client,
+    isReady,
+    defaultContext
+  } = useSavvagent();
   const {
     context,
     defaultValue = false,
@@ -56,23 +112,39 @@ function createFlag(flagKey, options = {}) {
     onError
   } = options;
   const [trigger, setTrigger] = (0, import_solid_js.createSignal)(0);
-  const [result] = (0, import_solid_js.createResource)(
-    trigger,
-    async () => {
-      try {
-        return await client.evaluate(flagKey, context);
-      } catch (err) {
-        const error2 = err;
-        onError?.(error2);
-        throw error2;
+  const mergedContext = (0, import_solid_js.createMemo)(() => {
+    const def = defaultContext();
+    return {
+      ...def,
+      ...context,
+      attributes: {
+        ...def?.attributes,
+        ...context?.attributes
       }
+    };
+  });
+  let prevContext;
+  const [result] = (0, import_solid_js.createResource)(() => ({
+    trigger: trigger(),
+    context: mergedContext(),
+    ready: isReady()
+  }), async (source) => {
+    if (!source.ready) {
+      return null;
     }
-  );
+    try {
+      return await client.evaluate(flagKey, source.context);
+    } catch (err) {
+      const error2 = err;
+      onError?.(error2);
+      throw error2;
+    }
+  });
   const value = () => result()?.value ?? defaultValue;
   const loading = () => result.loading;
   const error = () => result.error ?? null;
   (0, import_solid_js.createEffect)(() => {
-    if (!realtime) return;
+    if (!realtime || !isReady()) return;
     const unsubscribe = client.subscribe(flagKey, () => {
       setTrigger((t) => t + 1);
     });
@@ -80,6 +152,22 @@ function createFlag(flagKey, options = {}) {
       unsubscribe();
     });
   });
+  (0, import_solid_js.createEffect)(() => {
+    if (!isReady()) return;
+    const unsubscribe = client.onOverrideChange(() => {
+      setTrigger((t) => t + 1);
+    });
+    (0, import_solid_js.onCleanup)(() => {
+      unsubscribe();
+    });
+  });
+  (0, import_solid_js.createEffect)(() => {
+    const currentContext = mergedContext();
+    if (prevContext !== void 0 && !deepEqual(prevContext, currentContext)) {
+      setTrigger((t) => t + 1);
+    }
+    prevContext = currentContext;
+  });
   return {
     value,
     loading,
@@ -92,8 +180,158 @@ function createFlagValue(flagKey, options = {}) {
   const flag = createFlag(flagKey, options);
   return flag.value;
 }
+function createFlags(flagKeys, options = {}) {
+  const {
+    client,
+    isReady,
+    defaultContext
+  } = useSavvagent();
+  const {
+    context,
+    defaultValues = {},
+    realtime = true,
+    onError
+  } = options;
+  const [trigger, setTrigger] = (0, import_solid_js.createSignal)(0);
+  const mergedContext = (0, import_solid_js.createMemo)(() => {
+    const def = defaultContext();
+    return {
+      ...def,
+      ...context,
+      attributes: {
+        ...def?.attributes,
+        ...context?.attributes
+      }
+    };
+  });
+  const initialValues = {};
+  const initialErrors = {};
+  const initialResults = {};
+  for (const key of flagKeys) {
+    initialValues[key] = defaultValues[key] ?? false;
+    initialErrors[key] = null;
+    initialResults[key] = null;
+  }
+  const [values, setValues] = (0, import_solid_js.createSignal)(initialValues);
+  const [errors, setErrors] = (0, import_solid_js.createSignal)(initialErrors);
+  const [results, setResults] = (0, import_solid_js.createSignal)(initialResults);
+  const [loading, setLoading] = (0, import_solid_js.createSignal)(true);
+  let prevContext;
+  const evaluateFlags = async () => {
+    if (!isReady()) return;
+    setLoading(true);
+    const newValues = {};
+    const newErrors = {};
+    const newResults = {};
+    const ctx = mergedContext();
+    await Promise.all(flagKeys.map(async (flagKey) => {
+      try {
+        const evalResult = await client.evaluate(flagKey, ctx);
+        newValues[flagKey] = evalResult.value;
+        newErrors[flagKey] = null;
+        newResults[flagKey] = evalResult;
+      } catch (err) {
+        const error = err;
+        newValues[flagKey] = defaultValues[flagKey] ?? false;
+        newErrors[flagKey] = error;
+        newResults[flagKey] = null;
+        onError?.(error, flagKey);
+      }
+    }));
+    setValues(newValues);
+    setErrors(newErrors);
+    setResults(newResults);
+    setLoading(false);
+  };
+  (0, import_solid_js.createEffect)(() => {
+    trigger();
+    if (isReady()) {
+      evaluateFlags();
+    }
+  });
+  (0, import_solid_js.createEffect)(() => {
+    if (!realtime || !isReady()) return;
+    const unsubscribes = flagKeys.map((flagKey) => client.subscribe(flagKey, () => {
+      setTrigger((t) => t + 1);
+    }));
+    (0, import_solid_js.onCleanup)(() => {
+      unsubscribes.forEach((unsubscribe) => unsubscribe());
+    });
+  });
+  (0, import_solid_js.createEffect)(() => {
+    if (!isReady()) return;
+    const unsubscribe = client.onOverrideChange(() => {
+      setTrigger((t) => t + 1);
+    });
+    (0, import_solid_js.onCleanup)(() => {
+      unsubscribe();
+    });
+  });
+  (0, import_solid_js.createEffect)(() => {
+    const currentContext = mergedContext();
+    if (prevContext !== void 0 && !deepEqual(prevContext, currentContext)) {
+      setTrigger((t) => t + 1);
+    }
+    prevContext = currentContext;
+  });
+  return {
+    values,
+    loading,
+    errors,
+    results,
+    refetch: () => setTrigger((t) => t + 1)
+  };
+}
+function createWithFlag(flagKey, callback, options = {}) {
+  const {
+    client,
+    isReady
+  } = useSavvagent();
+  const {
+    context,
+    onError
+  } = options;
+  (0, import_solid_js.createEffect)(() => {
+    if (!isReady()) return;
+    client.withFlag(flagKey, callback, context).catch((error) => {
+      console.error(`[Savvagent] Error in withFlag callback for ${flagKey}:`, error);
+      onError?.(error);
+    });
+  });
+}
+function createUser() {
+  const {
+    client
+  } = useSavvagent();
+  const [userId, setUserIdSignal] = (0, import_solid_js.createSignal)(client.getUserId());
+  const [anonymousId, setAnonymousIdSignal] = (0, import_solid_js.createSignal)(client.getAnonymousId());
+  const setUserId = (id) => {
+    client.setUserId(id);
+    setUserIdSignal(id);
+  };
+  const getUserId = () => {
+    return client.getUserId();
+  };
+  const setAnonymousId = (id) => {
+    client.setAnonymousId(id);
+    setAnonymousIdSignal(id);
+  };
+  const getAnonymousId = () => {
+    return client.getAnonymousId();
+  };
+  return {
+    userId,
+    setUserId,
+    getUserId,
+    anonymousId,
+    setAnonymousId,
+    getAnonymousId
+  };
+}
 function createUserSignals() {
-  const client = useSavvagent();
+  const {
+    client
+  } = useSavvagent();
   const [userId, setUserIdSignal] = (0, import_solid_js.createSignal)(client.getUserId());
   const setUserId = (id) => {
     client.setUserId(id);
@@ -101,8 +339,18 @@ function createUserSignals() {
   };
   return [userId, setUserId];
 }
+function createTrackError(flagKey, context) {
+  const {
+    client
+  } = useSavvagent();
+  return (error) => {
+    client.trackError(flagKey, error, context);
+  };
+}
 function trackError(flagKey, error, context) {
-  const client = useSavvagent();
+  const {
+    client
+  } = useSavvagent();
   client.trackError(flagKey, error, context);
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -111,7 +359,11 @@ function trackError(flagKey, error, context) {
   SavvagentProvider,
   createFlag,
   createFlagValue,
+  createFlags,
+  createTrackError,
+  createUser,
   createUserSignals,
+  createWithFlag,
   trackError,
   useSavvagent
 });

package/dist/index.mjs

@@ -1,31 +1,76 @@
 // src/index.tsx
-import {
-  createContext,
-  useContext,
-  createSignal,
-  createResource,
-  createEffect,
-  onCleanup
-} from "solid-js";
+import { createComponent as _$createComponent } from "solid-js/web";
+import { createContext, useContext, createSignal, createResource, createEffect, createMemo, onCleanup } from "solid-js";
 import { FlagClient } from "@savvagent/sdk";
 import { FlagClient as FlagClient2 } from "@savvagent/sdk";
 var SavvagentContext = createContext();
 function SavvagentProvider(props) {
-  const client = new FlagClient(props.config);
+  const [isReady, setIsReady] = createSignal(false);
+  let client;
+  try {
+    client = new FlagClient(props.config);
+    setIsReady(true);
+  } catch (error) {
+    console.error("[Savvagent] Failed to initialize client:", error);
+    props.config.onError?.(error);
+    client = new FlagClient({
+      ...props.config,
+      apiKey: ""
+    });
+  }
+  const normalizedDefaultContext = createMemo(() => ({
+    application_id: props.defaultContext?.applicationId,
+    environment: props.defaultContext?.environment,
+    organization_id: props.defaultContext?.organizationId,
+    user_id: props.defaultContext?.userId,
+    anonymous_id: props.defaultContext?.anonymousId,
+    session_id: props.defaultContext?.sessionId,
+    language: props.defaultContext?.language,
+    attributes: props.defaultContext?.attributes
+  }));
   onCleanup(() => {
     client.close();
   });
-  return /* @__PURE__ */ React.createElement(SavvagentContext.Provider, { value: client }, props.children);
+  const contextValue = {
+    client,
+    isReady,
+    defaultContext: normalizedDefaultContext
+  };
+  return _$createComponent(SavvagentContext.Provider, {
+    value: contextValue,
+    get children() {
+      return props.children;
+    }
+  });
 }
 function useSavvagent() {
-  const client = useContext(SavvagentContext);
-  if (!client) {
+  const context = useContext(SavvagentContext);
+  if (!context) {
     throw new Error("useSavvagent must be used within a SavvagentProvider");
   }
-  return client;
+  return context;
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return a === b;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!keysB.includes(key)) return false;
+    if (!deepEqual(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
 }
 function createFlag(flagKey, options = {}) {
-  const client = useSavvagent();
+  const {
+    client,
+    isReady,
+    defaultContext
+  } = useSavvagent();
   const {
     context,
     defaultValue = false,
@@ -33,23 +78,39 @@ function createFlag(flagKey, options = {}) {
     onError
   } = options;
   const [trigger, setTrigger] = createSignal(0);
-  const [result] = createResource(
-    trigger,
-    async () => {
-      try {
-        return await client.evaluate(flagKey, context);
-      } catch (err) {
-        const error2 = err;
-        onError?.(error2);
-        throw error2;
+  const mergedContext = createMemo(() => {
+    const def = defaultContext();
+    return {
+      ...def,
+      ...context,
+      attributes: {
+        ...def?.attributes,
+        ...context?.attributes
       }
+    };
+  });
+  let prevContext;
+  const [result] = createResource(() => ({
+    trigger: trigger(),
+    context: mergedContext(),
+    ready: isReady()
+  }), async (source) => {
+    if (!source.ready) {
+      return null;
     }
-  );
+    try {
+      return await client.evaluate(flagKey, source.context);
+    } catch (err) {
+      const error2 = err;
+      onError?.(error2);
+      throw error2;
+    }
+  });
   const value = () => result()?.value ?? defaultValue;
   const loading = () => result.loading;
   const error = () => result.error ?? null;
   createEffect(() => {
-    if (!realtime) return;
+    if (!realtime || !isReady()) return;
     const unsubscribe = client.subscribe(flagKey, () => {
       setTrigger((t) => t + 1);
     });
@@ -57,6 +118,22 @@ function createFlag(flagKey, options = {}) {
       unsubscribe();
     });
   });
+  createEffect(() => {
+    if (!isReady()) return;
+    const unsubscribe = client.onOverrideChange(() => {
+      setTrigger((t) => t + 1);
+    });
+    onCleanup(() => {
+      unsubscribe();
+    });
+  });
+  createEffect(() => {
+    const currentContext = mergedContext();
+    if (prevContext !== void 0 && !deepEqual(prevContext, currentContext)) {
+      setTrigger((t) => t + 1);
+    }
+    prevContext = currentContext;
+  });
   return {
     value,
     loading,
@@ -69,8 +146,158 @@ function createFlagValue(flagKey, options = {}) {
   const flag = createFlag(flagKey, options);
   return flag.value;
 }
+function createFlags(flagKeys, options = {}) {
+  const {
+    client,
+    isReady,
+    defaultContext
+  } = useSavvagent();
+  const {
+    context,
+    defaultValues = {},
+    realtime = true,
+    onError
+  } = options;
+  const [trigger, setTrigger] = createSignal(0);
+  const mergedContext = createMemo(() => {
+    const def = defaultContext();
+    return {
+      ...def,
+      ...context,
+      attributes: {
+        ...def?.attributes,
+        ...context?.attributes
+      }
+    };
+  });
+  const initialValues = {};
+  const initialErrors = {};
+  const initialResults = {};
+  for (const key of flagKeys) {
+    initialValues[key] = defaultValues[key] ?? false;
+    initialErrors[key] = null;
+    initialResults[key] = null;
+  }
+  const [values, setValues] = createSignal(initialValues);
+  const [errors, setErrors] = createSignal(initialErrors);
+  const [results, setResults] = createSignal(initialResults);
+  const [loading, setLoading] = createSignal(true);
+  let prevContext;
+  const evaluateFlags = async () => {
+    if (!isReady()) return;
+    setLoading(true);
+    const newValues = {};
+    const newErrors = {};
+    const newResults = {};
+    const ctx = mergedContext();
+    await Promise.all(flagKeys.map(async (flagKey) => {
+      try {
+        const evalResult = await client.evaluate(flagKey, ctx);
+        newValues[flagKey] = evalResult.value;
+        newErrors[flagKey] = null;
+        newResults[flagKey] = evalResult;
+      } catch (err) {
+        const error = err;
+        newValues[flagKey] = defaultValues[flagKey] ?? false;
+        newErrors[flagKey] = error;
+        newResults[flagKey] = null;
+        onError?.(error, flagKey);
+      }
+    }));
+    setValues(newValues);
+    setErrors(newErrors);
+    setResults(newResults);
+    setLoading(false);
+  };
+  createEffect(() => {
+    trigger();
+    if (isReady()) {
+      evaluateFlags();
+    }
+  });
+  createEffect(() => {
+    if (!realtime || !isReady()) return;
+    const unsubscribes = flagKeys.map((flagKey) => client.subscribe(flagKey, () => {
+      setTrigger((t) => t + 1);
+    }));
+    onCleanup(() => {
+      unsubscribes.forEach((unsubscribe) => unsubscribe());
+    });
+  });
+  createEffect(() => {
+    if (!isReady()) return;
+    const unsubscribe = client.onOverrideChange(() => {
+      setTrigger((t) => t + 1);
+    });
+    onCleanup(() => {
+      unsubscribe();
+    });
+  });
+  createEffect(() => {
+    const currentContext = mergedContext();
+    if (prevContext !== void 0 && !deepEqual(prevContext, currentContext)) {
+      setTrigger((t) => t + 1);
+    }
+    prevContext = currentContext;
+  });
+  return {
+    values,
+    loading,
+    errors,
+    results,
+    refetch: () => setTrigger((t) => t + 1)
+  };
+}
+function createWithFlag(flagKey, callback, options = {}) {
+  const {
+    client,
+    isReady
+  } = useSavvagent();
+  const {
+    context,
+    onError
+  } = options;
+  createEffect(() => {
+    if (!isReady()) return;
+    client.withFlag(flagKey, callback, context).catch((error) => {
+      console.error(`[Savvagent] Error in withFlag callback for ${flagKey}:`, error);
+      onError?.(error);
+    });
+  });
+}
+function createUser() {
+  const {
+    client
+  } = useSavvagent();
+  const [userId, setUserIdSignal] = createSignal(client.getUserId());
+  const [anonymousId, setAnonymousIdSignal] = createSignal(client.getAnonymousId());
+  const setUserId = (id) => {
+    client.setUserId(id);
+    setUserIdSignal(id);
+  };
+  const getUserId = () => {
+    return client.getUserId();
+  };
+  const setAnonymousId = (id) => {
+    client.setAnonymousId(id);
+    setAnonymousIdSignal(id);
+  };
+  const getAnonymousId = () => {
+    return client.getAnonymousId();
+  };
+  return {
+    userId,
+    setUserId,
+    getUserId,
+    anonymousId,
+    setAnonymousId,
+    getAnonymousId
+  };
+}
 function createUserSignals() {
-  const client = useSavvagent();
+  const {
+    client
+  } = useSavvagent();
   const [userId, setUserIdSignal] = createSignal(client.getUserId());
   const setUserId = (id) => {
     client.setUserId(id);
@@ -78,8 +305,18 @@ function createUserSignals() {
   };
   return [userId, setUserId];
 }
+function createTrackError(flagKey, context) {
+  const {
+    client
+  } = useSavvagent();
+  return (error) => {
+    client.trackError(flagKey, error, context);
+  };
+}
 function trackError(flagKey, error, context) {
-  const client = useSavvagent();
+  const {
+    client
+  } = useSavvagent();
   client.trackError(flagKey, error, context);
 }
 export {
@@ -87,7 +324,11 @@ export {
   SavvagentProvider,
   createFlag,
   createFlagValue,
+  createFlags,
+  createTrackError,
+  createUser,
   createUserSignals,
+  createWithFlag,
   trackError,
   useSavvagent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@savvagent/solid",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "SolidJS SDK for Savvagent feature flags with reactive primitives",
   "author": "Savvagent",
   "license": "MIT",
@@ -21,12 +21,18 @@
     "solid-js": ">=1.0.0"
   },
   "dependencies": {
-    "@savvagent/sdk": "1.0.0"
+    "@savvagent/sdk": "1.0.1"
   },
   "devDependencies": {
-    "solid-js": "^1.8.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.4.0"
+    "@solidjs/testing-library": "0.8.10",
+    "@testing-library/jest-dom": "6.9.1",
+    "esbuild-plugin-solid": "0.6.0",
+    "jsdom": "27.2.0",
+    "solid-js": "^1.9.10",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vite-plugin-solid": "^2.11.10",
+    "vitest": "4.0.14"
   },
   "keywords": [
     "savvagent",
@@ -50,8 +56,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.tsx --format cjs,esm --dts --external solid-js",
-    "dev": "tsup src/index.tsx --format cjs,esm --dts --external solid-js --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "test": "vitest",
     "lint": "eslint src --ext .ts,.tsx",
     "format": "prettier --write \"src/**/*.{ts,tsx}\""