@microsoft/rayfin-client 1.33.2 → 1.34.0-alpha.1160

package/dist/client.d.ts

@@ -30,6 +30,12 @@ export interface RayfinClientConfig extends ApiClientConfig {
      * You may also provide your own storage or use browser's built-in Session Storage
      */
     authStorage?: AuthStorage | boolean;
+    /** When false, all storage I/O is skipped — pure in-memory session. Default: true */
+    persistSession?: boolean;
+    /** When false, session expiration timers are not scheduled and automatic refresh on 401 is disabled. Default: true */
+    autoRefreshToken?: boolean;
+    /** When false, StorageEvent listener is not registered. Default: auto-detected (true in browser with localStorage). */
+    multiTabSync?: boolean;
 }
 /**
  * Configuration for the server/worker-oriented {@link RayfinServerClient}.

package/dist/client.js

@@ -26,14 +26,25 @@ export class RayfinClientBase {
     data;
     apiClient;
     constructor(config) {
-        if (!config.baseUrl && !config.useProxy) {
-            throw new SdkError('SDK configuration requires a baseUrl.', 'MISSING_BASE_URL');
+        // Legacy compatibility: before `useProxy` was deprecated, passing
+        // `useProxy: true` without a `baseUrl` meant "route same-origin through the
+        // dev-server proxy". Preserve that as `baseUrl: ''` during the deprecation
+        // window so existing consumers are not broken. The ApiClient emits the
+        // one-time `useProxy` deprecation warning.
+        const baseUrl = (config.baseUrl === undefined || config.baseUrl === null) &&
+            config.useProxy
+            ? ''
+            : config.baseUrl;
+        if (baseUrl === undefined || baseUrl === null) {
+            throw new SdkError('SDK configuration requires a baseUrl. Pass an absolute URL to call a ' +
+                "backend directly, or an empty string ('') to keep requests " +
+                'same-origin so a development proxy can forward them.', 'MISSING_BASE_URL');
         }
         if (!config.publishableKey || config.publishableKey.trim() === '') {
             throw new SdkError('SDK configuration requires a publishableKey for service-level authentication.', 'MISSING_PUBLISHABLE_KEY');
         }
         this.apiClient = new ApiClient({
-            baseUrl: config.baseUrl,
+            baseUrl: baseUrl,
             publishableKey: config.publishableKey,
             functionsBaseUrl: config.functionsBaseUrl,
             useProxy: config.useProxy,
@@ -89,7 +100,12 @@ export class RayfinClient extends RayfinClientBase {
      */
     constructor(config) {
         super(config);
-        this.auth = new Auth(this.apiClient, { storage: config.authStorage });
+        this.auth = new Auth(this.apiClient, {
+            storage: config.authStorage,
+            persistSession: config.persistSession,
+            autoRefreshToken: config.autoRefreshToken,
+            multiTabSync: config.multiTabSync,
+        });
         this.auth.attachToClient(this.apiClient);
         this.functions = createFunctionsApi(this.apiClient);
     }

package/dist/experimental/ConnectorsRayfinClient.d.ts

@@ -0,0 +1,61 @@
+import { createConnectorsApi, type ConnectorsSchema } from '@microsoft/rayfin-connectors';
+import { type EntitySchema } from '@microsoft/rayfin-data';
+import { type FunctionsSchema } from '@microsoft/rayfin-functions';
+import RayfinClient, { RayfinClientConfig } from '../client.js';
+/**
+ * (Experimental) Rayfin client that surfaces the typed connectors runtime as
+ * `client.connectors.<name>.<operation>(input, options?)`.
+ *
+ * The connector layer is being incubated under the experimental subpath while
+ * the API and configuration model stabilize. Public consumers should import
+ * from `@microsoft/rayfin-client/experimental` rather than the stable entry.
+ *
+ * @typeParam TSchema - Data entity schema (same shape as {@link RayfinClient}).
+ * @typeParam TFunctionsSchema - Functions schema (same shape as {@link RayfinClient}).
+ * @typeParam TConnectorsSchema - Connector schema mapping connector names
+ *   (as declared in `rayfin.yml`) to typed connector markers such as
+ *   `FabricSemanticModel<'executeQuery'>`.
+ *
+ * @example
+ * ```ts
+ * import { ConnectorsRayfinClient } from '@microsoft/rayfin-client/experimental';
+ * import type { FabricSemanticModel } from '@microsoft/rayfin-connector-fabric-semanticmodel';
+ *
+ * type AppConnectorsSchema = {
+ *   salesModel: FabricSemanticModel<'executeQuery'>;
+ * };
+ *
+ * const client = new ConnectorsRayfinClient<
+ *   DataSchema,
+ *   FunctionsSchema,
+ *   AppConnectorsSchema
+ * >({
+ *   baseUrl: import.meta.env.VITE_RAYFIN_BASE_URL,
+ *   publishableKey: import.meta.env.VITE_RAYFIN_PUBLISHABLE_KEY,
+ * });
+ *
+ * const result = await client.connectors.salesModel.executeQuery({
+ *   query: 'EVALUATE TOPN(10, Sales)',
+ * });
+ * ```
+ *
+ * @alpha
+ * @internal
+ */
+export declare class ConnectorsRayfinClient<TSchema extends EntitySchema = Record<string, any>, TFunctionsSchema extends FunctionsSchema = FunctionsSchema, TConnectorsSchema extends ConnectorsSchema = ConnectorsSchema> extends RayfinClient<TSchema, TFunctionsSchema> {
+    /**
+     * (Experimental) Typed accessors for connectors declared in `rayfin.yml`.
+     * Each property resolves lazily on first access; the underlying transport
+     * (`POST /connector-invoke`) is shared with the rest of the SDK.
+     */
+    readonly connectors: ReturnType<typeof createConnectorsApi<TConnectorsSchema>>;
+    /**
+     * (Experimental) Creates a Rayfin client with the connectors runtime
+     * attached. Accepts the same configuration as {@link RayfinClient}.
+     *
+     * @param config - Client configuration, including optional auth-token storage.
+     */
+    constructor(config: RayfinClientConfig);
+}
+export default ConnectorsRayfinClient;
+//# sourceMappingURL=ConnectorsRayfinClient.d.ts.map

package/dist/experimental/ConnectorsRayfinClient.js

@@ -0,0 +1,62 @@
+import { createConnectorsApi, } from '@microsoft/rayfin-connectors';
+import RayfinClient from '../client.js';
+/**
+ * (Experimental) Rayfin client that surfaces the typed connectors runtime as
+ * `client.connectors.<name>.<operation>(input, options?)`.
+ *
+ * The connector layer is being incubated under the experimental subpath while
+ * the API and configuration model stabilize. Public consumers should import
+ * from `@microsoft/rayfin-client/experimental` rather than the stable entry.
+ *
+ * @typeParam TSchema - Data entity schema (same shape as {@link RayfinClient}).
+ * @typeParam TFunctionsSchema - Functions schema (same shape as {@link RayfinClient}).
+ * @typeParam TConnectorsSchema - Connector schema mapping connector names
+ *   (as declared in `rayfin.yml`) to typed connector markers such as
+ *   `FabricSemanticModel<'executeQuery'>`.
+ *
+ * @example
+ * ```ts
+ * import { ConnectorsRayfinClient } from '@microsoft/rayfin-client/experimental';
+ * import type { FabricSemanticModel } from '@microsoft/rayfin-connector-fabric-semanticmodel';
+ *
+ * type AppConnectorsSchema = {
+ *   salesModel: FabricSemanticModel<'executeQuery'>;
+ * };
+ *
+ * const client = new ConnectorsRayfinClient<
+ *   DataSchema,
+ *   FunctionsSchema,
+ *   AppConnectorsSchema
+ * >({
+ *   baseUrl: import.meta.env.VITE_RAYFIN_BASE_URL,
+ *   publishableKey: import.meta.env.VITE_RAYFIN_PUBLISHABLE_KEY,
+ * });
+ *
+ * const result = await client.connectors.salesModel.executeQuery({
+ *   query: 'EVALUATE TOPN(10, Sales)',
+ * });
+ * ```
+ *
+ * @alpha
+ * @internal
+ */
+export class ConnectorsRayfinClient extends RayfinClient {
+    /**
+     * (Experimental) Typed accessors for connectors declared in `rayfin.yml`.
+     * Each property resolves lazily on first access; the underlying transport
+     * (`POST /connector-invoke`) is shared with the rest of the SDK.
+     */
+    connectors;
+    /**
+     * (Experimental) Creates a Rayfin client with the connectors runtime
+     * attached. Accepts the same configuration as {@link RayfinClient}.
+     *
+     * @param config - Client configuration, including optional auth-token storage.
+     */
+    constructor(config) {
+        super(config);
+        this.connectors = createConnectorsApi(this.apiClient);
+    }
+}
+export default ConnectorsRayfinClient;
+//# sourceMappingURL=ConnectorsRayfinClient.js.map

package/dist/experimental/index.d.ts

@@ -1,3 +1,5 @@
 export { ExtendableRayfinClient, ServicePlugin, } from './ExtendableRayfinClient.js';
 export type { TServiceClasses, ServicePluginClass, } from './ExtendableRayfinClient.js';
+export { ConnectorsRayfinClient } from './ConnectorsRayfinClient.js';
+export type { ConnectorsSchema, ConnectorMarker, OperationCatalog, OperationDef, TypedConnectorsApi, TypedConnectorClient, } from '@microsoft/rayfin-connectors';
 //# sourceMappingURL=index.d.ts.map

package/dist/experimental/index.js

@@ -1,2 +1,3 @@
 export { ExtendableRayfinClient, ServicePlugin, } from './ExtendableRayfinClient.js';
+export { ConnectorsRayfinClient } from './ConnectorsRayfinClient.js';
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from './client.js';
 export { default } from './client.js';
 export type { TypedDataClients, EntitySchema } from '@microsoft/rayfin-data';
+export type { FunctionsSchema } from '@microsoft/rayfin-functions';
 export type { ApiClientConfig } from '@microsoft/rayfin-lib';
+export { setDeprecationsSilenced, isDeprecationSilenced, } from '@microsoft/rayfin-lib';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,7 @@
 // Export all from client.ts
 export * from './client.js';
 export { default } from './client.js';
+// Re-export deprecation silencing controls from rayfin-lib so consumers have a
+// stable public import path here; emitter helpers stay internal to the SDK.
+export { setDeprecationsSilenced, isDeprecationSilenced, } from '@microsoft/rayfin-lib';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/rayfin-client",
-  "version": "1.33.2",
+  "version": "1.34.0-alpha.1160",
   "description": "Main client SDK for Rayfin services",
   "type": "module",
   "exports": {
@@ -21,10 +21,11 @@
     "assets/docs"
   ],
   "dependencies": {
-    "@microsoft/rayfin-auth": "1.33.2",
-    "@microsoft/rayfin-data": "1.33.2",
-    "@microsoft/rayfin-lib": "1.33.2",
-    "@microsoft/rayfin-functions": "1.33.2"
+    "@microsoft/rayfin-auth": "1.34.0-alpha.1160",
+    "@microsoft/rayfin-connectors": "1.34.0-alpha.1160",
+    "@microsoft/rayfin-lib": "1.34.0-alpha.1160",
+    "@microsoft/rayfin-data": "1.34.0-alpha.1160",
+    "@microsoft/rayfin-functions": "1.34.0-alpha.1160"
   },
   "devDependencies": {
     "typescript": "^5.8.3",