@replanejs/svelte 0.8.20 → 0.9.2

package/README.md

@@ -17,9 +17,10 @@ npm install @replanejs/svelte
 ```svelte
 <script>
   import { ReplaneContext, config } from '@replanejs/svelte';
-  import { createReplaneClient } from '@replanejs/svelte';
+  import { Replane } from '@replanejs/svelte';
 
-  const replane = await createReplaneClient({
+  const replane = new Replane();
+  await replane.connect({
     baseUrl: 'https://your-replane-server.com',
     sdkKey: 'your-sdk-key',
   });
@@ -45,20 +46,33 @@ npm install @replanejs/svelte
 {/if}
 ```
 
-## Client Options
+## Provider Props
 
-The `options` prop accepts all options from `@replanejs/sdk`. Key options:
+| Prop         | Type                        | Required | Description                                             |
+| ------------ | --------------------------- | -------- | ------------------------------------------------------- |
+| `connection` | `ConnectOptions \| null`    | Yes      | Connection options (see below), or `null` to skip connection |
+| `defaults`   | `Record<string, unknown>`   | No       | Default values if server is unavailable                 |
+| `context`    | `Record<string, unknown>`   | No       | Default context for override evaluations                |
+| `snapshot`   | `ReplaneSnapshot`           | No       | Snapshot for SSR hydration                              |
+| `logger`     | `ReplaneLogger`             | No       | Custom logger (default: console)                        |
+| `loader`     | `Snippet`                   | No       | Snippet to show while loading                           |
+| `async`      | `boolean`                   | No       | Connect asynchronously (renders immediately with defaults) |
 
-| Option                    | Type                   | Required | Description                                |
-| ------------------------- | ---------------------- | -------- | ------------------------------------------ |
-| `baseUrl`                 | `string`               | Yes      | Replane server URL                         |
-| `sdkKey`                  | `string`               | Yes      | SDK key for authentication                 |
-| `context`                 | `Record<string, any>`  | No       | Default context for override evaluations   |
-| `defaults`                | `Record<string, any>`  | No       | Default values if server is unavailable    |
-| `required`                | `string[]` or `object` | No       | Configs that must exist for initialization |
-| `initializationTimeoutMs` | `number`               | No       | SDK initialization timeout (default: 5000) |
+## Connection Options
 
-See [`@replanejs/sdk` documentation](https://github.com/replane-dev/replane-javascript/tree/main/packages/sdk#options) for the complete list of options.
+The `connection` prop accepts the following options:
+
+| Option                | Type                  | Required | Description                              |
+| --------------------- | --------------------- | -------- | ---------------------------------------- |
+| `baseUrl`             | `string`              | Yes      | Replane server URL                       |
+| `sdkKey`              | `string`              | Yes      | SDK key for authentication               |
+| `connectTimeoutMs`    | `number`              | No       | SDK connection timeout (default: 5000)   |
+| `requestTimeoutMs`    | `number`              | No       | Timeout for SSE requests (default: 2000) |
+| `retryDelayMs`        | `number`              | No       | Base delay between retries (default: 200)|
+| `inactivityTimeoutMs` | `number`              | No       | SSE inactivity timeout (default: 30000)  |
+| `fetchFn`             | `typeof fetch`        | No       | Custom fetch implementation              |
+
+See [`@replanejs/sdk` documentation](https://github.com/replane-dev/replane-javascript/tree/main/packages/sdk#api) for more details.
 
 ## API
 
@@ -125,15 +139,16 @@ Create a reactive store from a client directly (without context). Type-safe with
 
 Context component that makes the Replane client available to your component tree.
 
-Can be used in three ways:
+Can be used in several ways:
 
 **1. With a pre-created client:**
 
 ```svelte
 <script>
-  import { ReplaneContext, createReplaneClient } from '@replanejs/svelte';
+  import { ReplaneContext, Replane } from '@replanejs/svelte';
 
-  const replane = await createReplaneClient({
+  const replane = new Replane();
+  await replane.connect({
     baseUrl: 'https://your-replane-server.com',
     sdkKey: 'your-sdk-key',
   });
@@ -144,20 +159,20 @@ Can be used in three ways:
 </ReplaneContext>
 ```
 
-**2. With options (client managed internally):**
+**2. With connection (client managed internally):**
 
 ```svelte
 <script>
   import { ReplaneContext } from '@replanejs/svelte';
 
-  const options = {
+  const connection = {
     baseUrl: 'https://your-replane-server.com',
     sdkKey: 'your-sdk-key',
   };
 </script>
 
 <svelte:boundary onerror={(e) => console.error(e)}>
-  <ReplaneContext {options}>
+  <ReplaneContext {connection}>
     <App />
 
     {#snippet loader()}
@@ -171,7 +186,30 @@ Can be used in three ways:
 </svelte:boundary>
 ```
 
-**3. With a snapshot (for SSR/hydration):**
+**3. With async mode:**
+
+Connect in the background while rendering immediately with defaults:
+
+```svelte
+<script>
+  import { ReplaneContext } from '@replanejs/svelte';
+
+  const connection = {
+    baseUrl: 'https://your-replane-server.com',
+    sdkKey: 'your-sdk-key',
+  };
+
+  const defaults = {
+    featureEnabled: false,
+  };
+</script>
+
+<ReplaneContext {connection} {defaults} async>
+  <App />
+</ReplaneContext>
+```
+
+**4. With a snapshot (for SSR/hydration):**
 
 ```svelte
 <script>
@@ -179,13 +217,13 @@ Can be used in three ways:
 
   let { data, children } = $props();
 
-  const options = {
+  const connection = {
     baseUrl: import.meta.env.VITE_REPLANE_BASE_URL,
     sdkKey: import.meta.env.VITE_REPLANE_SDK_KEY,
   };
 </script>
 
-<ReplaneContext {options} snapshot={data.replaneSnapshot}>
+<ReplaneContext {connection} snapshot={data.replaneSnapshot}>
   {@render children()}
 </ReplaneContext>
 ```
@@ -235,8 +273,10 @@ import { getReplaneSnapshot } from "@replanejs/svelte";
 
 export async function load() {
   const snapshot = await getReplaneSnapshot({
-    baseUrl: import.meta.env.REPLANE_BASE_URL,
-    sdkKey: import.meta.env.REPLANE_SDK_KEY,
+    connection: {
+      baseUrl: import.meta.env.REPLANE_BASE_URL,
+      sdkKey: import.meta.env.REPLANE_SDK_KEY,
+    },
   });
 
   return { replaneSnapshot: snapshot };
@@ -250,13 +290,13 @@ export async function load() {
 
   let { data, children } = $props();
 
-  const options = {
+  const connection = {
     baseUrl: import.meta.env.VITE_REPLANE_BASE_URL,
     sdkKey: import.meta.env.VITE_REPLANE_SDK_KEY,
   };
 </script>
 
-<ReplaneContext {options} snapshot={data.replaneSnapshot}>
+<ReplaneContext {connection} snapshot={data.replaneSnapshot}>
   {@render children()}
 </ReplaneContext>
 ```

package/dist/ReplaneContext.svelte

@@ -1,5 +1,5 @@
 <script lang="ts" module>
-  import type { ReplaneClient } from "@replanejs/sdk";
+  import type { Replane } from "@replanejs/sdk";
   import type {
     ReplaneContextProps,
     ReplaneContextWithClientProps,
@@ -15,7 +15,7 @@
 </script>
 
 <script lang="ts" generics="T extends object">
-  import { createReplaneClient, restoreReplaneClient } from "@replanejs/sdk";
+  import { Replane as ReplaneClass } from "@replanejs/sdk";
   import { setReplaneContext } from "./context";
   import { hasClient } from "./types";
 
@@ -23,62 +23,115 @@
 
   type ClientState =
     | { status: "loading"; client: null; error: null }
-    | { status: "ready"; client: ReplaneClient<T>; error: null }
+    | { status: "ready"; client: Replane<T>; error: null }
     | { status: "error"; client: null; error: Error };
 
-  let state = $state<ClientState>({ status: "loading", client: null, error: null });
-  let clientRef: ReplaneClient<T> | null = null;
+  // Determine if we're in sync mode (client available immediately)
+  // This must be computed during initialization, not reactively
+  function computeInitialState(): {
+    state: ClientState;
+    client: Replane<T> | null;
+    isSyncMode: boolean;
+  } {
+    // Pre-created client - use directly
+    if (hasClient(props)) {
+      return {
+        state: { status: "ready", client: props.client, error: null },
+        client: props.client,
+        isSyncMode: true,
+      };
+    }
+
+    const { connection, snapshot, context, logger, defaults } = props;
+    const isAsync = props.async;
+
+    // Sync mode: snapshot, no connection, or async flag
+    if (snapshot || !connection || isAsync) {
+      try {
+        const client = new ReplaneClass<T>({
+          snapshot,
+          logger,
+          context,
+          defaults,
+        });
+        return {
+          state: { status: "ready", client, error: null },
+          client,
+          isSyncMode: true,
+        };
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        return {
+          state: { status: "error", client: null, error },
+          client: null,
+          isSyncMode: true,
+        };
+      }
+    }
+
+    // Loading mode: need to wait for connection
+    return {
+      state: { status: "loading", client: null, error: null },
+      client: null,
+      isSyncMode: false,
+    };
+  }
+
+  // Compute initial state synchronously during component initialization
+  const initialState = computeInitialState();
+  let state = $state<ClientState>(initialState.state);
+  let clientRef: Replane<T> | null = initialState.client;
+
+  // Set context immediately for sync mode (during initialization)
+  if (initialState.isSyncMode && initialState.client) {
+    setReplaneContext<T>(initialState.client);
+  }
+
   let cancelled = false;
 
-  // Handle client initialization based on props
+  // Handle async connection for sync mode, or full async flow for loading mode
   $effect(() => {
     cancelled = false;
 
     if (hasClient(props)) {
-      // Pre-created client - use directly
-      state = { status: "ready", client: props.client, error: null };
+      // Pre-created client - already set up synchronously
       return;
     }
 
-    // Options-based initialization
-    const { options, snapshot } = props;
+    const { connection, logger } = props;
 
-    if (snapshot) {
-      // Restore from snapshot synchronously
-      try {
-        const client = restoreReplaneClient<T>({
-          snapshot,
-          connection: {
-            baseUrl: options.baseUrl,
-            sdkKey: options.sdkKey,
-            fetchFn: options.fetchFn,
-            requestTimeoutMs: options.requestTimeoutMs,
-            retryDelayMs: options.retryDelayMs,
-            inactivityTimeoutMs: options.inactivityTimeoutMs,
-            logger: options.logger,
-            agent: options.agent ?? DEFAULT_AGENT,
-          },
-          context: options.context,
+    // Get connection options with default agent
+    const connectionWithAgent = connection
+      ? {
+          ...connection,
+          agent: connection.agent ?? DEFAULT_AGENT,
+        }
+      : undefined;
+
+    if (initialState.isSyncMode) {
+      // Sync mode - client already created, just need to connect in background
+      if (connectionWithAgent && clientRef) {
+        clientRef.connect(connectionWithAgent).catch((err) => {
+          (logger ?? console)?.error("Failed to connect Replane client", err);
         });
-        clientRef = client;
-        state = { status: "ready", client, error: null };
-      } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        state = { status: "error", client: null, error };
       }
       return;
     }
 
-    // Async client creation
-    state = { status: "loading", client: null, error: null };
+    // Loading mode - create client and connect
+    const { context, defaults } = props;
+
+    const client = new ReplaneClass<T>({
+      logger,
+      context,
+      defaults,
+    });
 
-    createReplaneClient<T>({
-      ...options,
-      agent: options.agent ?? DEFAULT_AGENT,
-    })
-      .then((client) => {
+    client
+      .connect(connectionWithAgent!)
+      .then(() => {
         if (cancelled) {
-          client.close();
+          client.disconnect();
           return;
         }
         clientRef = client;
@@ -92,17 +145,18 @@
 
     return () => {
       cancelled = true;
-      // Only close client if we created it (not pre-created)
+      // Only disconnect client if we created it (not pre-created)
       if (clientRef && !hasClient(props)) {
-        clientRef.close();
+        clientRef.disconnect();
         clientRef = null;
       }
     };
   });
 
-  // Set context when client is ready
+  // Set context when client becomes ready in loading mode
+  // This uses $effect.pre to run before children render
   $effect(() => {
-    if (state.status === "ready" && state.client) {
+    if (!initialState.isSyncMode && state.status === "ready" && state.client) {
       setReplaneContext<T>(state.client);
     }
   });

package/dist/ReplaneContext.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReplaneContext.svelte.d.ts","sourceRoot":"","sources":["../src/ReplaneContext.svelte.ts"],"names":[],"mappings":"AAIE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,CAAC;AAMJ,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM;WAkHL,mBAAmB,CAAC,CAAC,CAAC;;;;;EAA4E;AAC/H,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACpC,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3Y,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1I,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,cAAc,EAAE,qBAAmC,CAAC;AACxC,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ReplaneContext.svelte.d.ts","sourceRoot":"","sources":["../src/ReplaneContext.svelte.ts"],"names":[],"mappings":"AAIE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,CAAC;AAMJ,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM;WAwKL,mBAAmB,CAAC,CAAC,CAAC;;;;;EAA4E;AAC/H,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACpC,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3Y,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1I,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,cAAc,EAAE,qBAAmC,CAAC;AACxC,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,eAAe,cAAc,CAAC"}

package/dist/context.d.ts

@@ -1,10 +1,10 @@
-import type { ReplaneClient } from "@replanejs/sdk";
+import type { Replane } from "@replanejs/sdk";
 import type { ReplaneContextValue } from "./types";
 /**
  * Set the Replane client in Svelte context.
  * @internal
  */
-export declare function setReplaneContext<T extends object>(client: ReplaneClient<T>): void;
+export declare function setReplaneContext<T extends object>(client: Replane<T>): void;
 /**
  * Get the Replane context from Svelte context.
  * @internal

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAGlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,mBAAmB,CAAC,CAAC,CAAC,CAM1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAG5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,mBAAmB,CAAC,CAAC,CAAC,CAM1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { default as ReplaneContext } from "./ReplaneContext.svelte";
 export { getReplane, config, configFrom, createTypedReplane, createTypedConfig } from "./stores";
 export { setReplaneContext, getReplaneContext, hasReplaneContext } from "./context";
-export { createReplaneClient, createInMemoryReplaneClient, restoreReplaneClient, getReplaneSnapshot, ReplaneError, ReplaneErrorCode, } from "@replanejs/sdk";
-export type { ReplaneClient, ReplaneClientOptions, ReplaneSnapshot, ReplaneLogger, GetConfigOptions, RestoreReplaneClientOptions, GetReplaneSnapshotOptions, } from "@replanejs/sdk";
+export { Replane, getReplaneSnapshot, ReplaneError, ReplaneErrorCode } from "@replanejs/sdk";
+export type { ReplaneSnapshot, ReplaneContext as ReplaneContextType, ReplaneLogger, ReplaneOptions, ConnectOptions, GetConfigOptions, GetReplaneSnapshotOptions, } from "@replanejs/sdk";
 export type { ReplaneContextValue, ReplaneContextProps, ReplaneContextWithClientProps, ReplaneContextWithOptionsProps, } from "./types";
-export { hasClient, hasOptions } from "./types";
+export { hasClient } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7F,YAAY,EACV,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -5,6 +5,6 @@ export { getReplane, config, configFrom, createTypedReplane, createTypedConfig }
 // Context utilities (for advanced use cases)
 export { setReplaneContext, getReplaneContext, hasReplaneContext } from "./context";
 // Re-export from SDK for convenience
-export { createReplaneClient, createInMemoryReplaneClient, restoreReplaneClient, getReplaneSnapshot, ReplaneError, ReplaneErrorCode, } from "@replanejs/sdk";
+export { Replane, getReplaneSnapshot, ReplaneError, ReplaneErrorCode } from "@replanejs/sdk";
 // Type guards
-export { hasClient, hasOptions } from "./types";
+export { hasClient } from "./types";

package/dist/stores.d.ts

@@ -1,5 +1,5 @@
 import { type Readable } from "svelte/store";
-import type { GetConfigOptions, ReplaneClient } from "@replanejs/sdk";
+import type { GetConfigOptions, Replane } from "@replanejs/sdk";
 /**
  * Get the Replane client from context.
  *
@@ -18,7 +18,7 @@ import type { GetConfigOptions, ReplaneClient } from "@replanejs/sdk";
  * </script>
  * ```
  */
-export declare function getReplane<T extends Record<string, unknown> = any>(): ReplaneClient<T>;
+export declare function getReplane<T extends Record<string, unknown> = any>(): Replane<T>;
 /**
  * Create a reactive store for a specific config value.
  *
@@ -71,7 +71,7 @@ export declare function config<T>(name: string, options?: GetConfigOptions<T>):
  * {/if}
  * ```
  */
-export declare function configFrom<TConfigs extends Record<string, unknown>, K extends keyof TConfigs>(replane: ReplaneClient<TConfigs>, name: K, options?: GetConfigOptions<TConfigs[K]>): Readable<TConfigs[K]>;
+export declare function configFrom<TConfigs extends Record<string, unknown>, K extends keyof TConfigs>(replane: Replane<TConfigs>, name: K, options?: GetConfigOptions<TConfigs[K]>): Readable<TConfigs[K]>;
 /**
  * Creates a typed version of getReplane().
  *
@@ -101,7 +101,7 @@ export declare function configFrom<TConfigs extends Record<string, unknown>, K e
  * </script>
  * ```
  */
-export declare function createTypedReplane<TConfigs extends Record<string, unknown>>(): () => ReplaneClient<TConfigs>;
+export declare function createTypedReplane<TConfigs extends Record<string, unknown>>(): () => Replane<TConfigs>;
 /**
  * Creates a typed version of config().
  *

package/dist/stores.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGtE;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,CAEtF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAYlF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,QAAQ,EAC3F,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAChC,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GACtC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAOvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WACrD,aAAa,CAAC,QAAQ,CAAC,CAG5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MACvD,CAAC,SAAS,MAAM,QAAQ,EACvC,MAAM,CAAC,EACP,UAAU,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KACtC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAGzB"}
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAEhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAYlF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,QAAQ,EAC3F,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GACtC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAOvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WACrD,OAAO,CAAC,QAAQ,CAAC,CAGtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MACvD,CAAC,SAAS,MAAM,QAAQ,EACvC,MAAM,CAAC,EACP,UAAU,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KACtC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAGzB"}

package/dist/types.d.ts

@@ -1,17 +1,17 @@
-import type { ReplaneClient, ReplaneClientOptions, ReplaneSnapshot } from "@replanejs/sdk";
+import type { Replane, ReplaneSnapshot, ReplaneContext as ReplaneContextType, ReplaneLogger, ConnectOptions } from "@replanejs/sdk";
 import type { Snippet } from "svelte";
 /**
  * Context value containing the Replane client
  */
 export interface ReplaneContextValue<T extends object = Record<string, unknown>> {
-    client: ReplaneClient<T>;
+    client: Replane<T>;
 }
 /**
  * Props for ReplaneContext when using a pre-created client.
  */
 export interface ReplaneContextWithClientProps<T extends object = Record<string, unknown>> {
-    /** Pre-created ReplaneClient instance */
-    client: ReplaneClient<T>;
+    /** Pre-created Replane client instance */
+    client: Replane<T>;
     /** Children snippet */
     children: Snippet;
 }
@@ -19,15 +19,31 @@ export interface ReplaneContextWithClientProps<T extends object = Record<string,
  * Props for ReplaneContext when letting it manage the client internally.
  */
 export interface ReplaneContextWithOptionsProps<T extends object = Record<string, unknown>> {
-    /** Options to create or restore the ReplaneClient */
-    options: ReplaneClientOptions<T>;
     /** Children snippet */
     children: Snippet;
+    /**
+     * Connection options for connecting to the Replane server.
+     * Pass null to explicitly skip connection (client will use defaults/snapshot only).
+     */
+    connection: ConnectOptions | null;
+    /**
+     * Default context for all config evaluations.
+     */
+    context?: ReplaneContextType;
+    /**
+     * Optional logger (defaults to console).
+     */
+    logger?: ReplaneLogger;
+    /**
+     * Default values to use before connection is established.
+     */
+    defaults?: {
+        [K in keyof T]?: T[K];
+    };
     /**
      * Optional snapshot from server-side rendering.
      * When provided, the client will be restored from the snapshot synchronously
      * instead of fetching configs from the server.
-     * The `options` will be used for live updates connection if provided.
      */
     snapshot?: ReplaneSnapshot<T>;
     /**
@@ -36,14 +52,16 @@ export interface ReplaneContextWithOptionsProps<T extends object = Record<string
      * Ignored when snapshot is provided (restoration is synchronous).
      */
     loader?: Snippet;
+    /**
+     * If true, the client will be connected asynchronously.
+     * Make sure to provide defaults or snapshot.
+     * @default false
+     */
+    async?: boolean;
 }
 export type ReplaneContextProps<T extends object = Record<string, unknown>> = ReplaneContextWithClientProps<T> | ReplaneContextWithOptionsProps<T>;
 /**
  * Type guard to check if props contain a pre-created client.
  */
 export declare function hasClient<T extends object>(props: ReplaneContextProps<T>): props is ReplaneContextWithClientProps<T>;
-/**
- * Type guard to check if props contain options (with or without snapshot).
- */
-export declare function hasOptions<T extends object>(props: ReplaneContextProps<T>): props is ReplaneContextWithOptionsProps<T>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvF,yCAAyC;IACzC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF,qDAAqD;IACrD,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtE,6BAA6B,CAAC,CAAC,CAAC,GAChC,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC,CAE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,8BAA8B,CAAC,CAAC,CAAC,CAE5C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,aAAa,EACb,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvF,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtE,6BAA6B,CAAC,CAAC,CAAC,GAChC,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC,CAE3C"}

package/dist/types.js

@@ -4,9 +4,3 @@
 export function hasClient(props) {
     return "client" in props && props.client !== undefined;
 }
-/**
- * Type guard to check if props contain options (with or without snapshot).
- */
-export function hasOptions(props) {
-    return "options" in props && props.options !== undefined;
-}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VERSION = "0.8.20";
-export declare const DEFAULT_AGENT = "replane-js-svelte/0.8.20";
+export declare const VERSION = "0.9.2";
+export declare const DEFAULT_AGENT = "replane-js-svelte/0.9.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,WAAW,CAAC;AAChC,eAAO,MAAM,aAAa,6BAAiC,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,aAAa,4BAAiC,CAAC"}

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated - do not edit manually
-export const VERSION = "0.8.20";
+export const VERSION = "0.9.2";
 export const DEFAULT_AGENT = `replane-js-svelte/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replanejs/svelte",
-  "version": "0.8.20",
+  "version": "0.9.2",
   "description": "Svelte SDK for Replane - feature flags and remote configuration",
   "type": "module",
   "svelte": "./dist/index.js",
@@ -39,7 +39,7 @@
     "svelte": ">=4.0.0"
   },
   "dependencies": {
-    "@replanejs/sdk": "^0.8.20"
+    "@replanejs/sdk": "^0.9.2"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.3.10",