@microsoft/rayfin-client 1.34.0-alpha.1221 → 1.34.0-alpha.1270

package/dist/experimental/ConnectorsRayfinClient.d.ts

@@ -1,4 +1,4 @@
-import { createConnectorsApi, type ConnectorConfig, type ConnectorsSchema } from '@microsoft/rayfin-connectors';
+import { createConnectorsApi, type ConnectorConfig, type ConnectorsRuntime, type ConnectorsSchema, type HostEnvironment } from '@microsoft/rayfin-connectors';
 import { type EntitySchema } from '@microsoft/rayfin-data';
 import { type FunctionsSchema } from '@microsoft/rayfin-functions';
 import RayfinClient, { RayfinClientConfig } from '../client.js';
@@ -20,6 +20,17 @@ export interface ConnectorsRayfinClientConfig<TConnectorsSchema extends Connecto
      * connector declared in `TConnectorsSchema` must have a runtime config.
      */
     connectors: Record<keyof TConnectorsSchema & string, ConnectorConfig>;
+    /**
+     * (Experimental) Hosting environment the connectors runtime runs in. Carried
+     * on every invocation context so a registered invoke middleware can branch
+     * on it (embedded-in-Fabric vs standalone vs cli). When omitted, the host is
+     * auto-detected (`detectHost()`) so callers wire up nothing — `cli` under
+     * Node, `embedded` inside a parent frame, otherwise `standalone`. Pass an
+     * explicit value only to override detection. The connectors layer only
+     * carries this value; confirming a specific Fabric host is the job of the
+     * connector-specific package.
+     */
+    host?: HostEnvironment;
 }
 /**
  * (Experimental) Rayfin client that surfaces the typed connectors runtime as
@@ -58,6 +69,22 @@ export interface ConnectorsRayfinClientConfig<TConnectorsSchema extends Connecto
  * });
  * ```
  *
+ * Connectors whose operations return a binary stream (such as the
+ * `fabric-semanticmodel` Apache Arrow response) need a runtime decoder. Pass a
+ * {@link ConnectorsRuntime} as the second constructor argument, keyed by the
+ * same connector names used in the schema:
+ *
+ * @example
+ * ```ts
+ * import { fabricSemanticModel } from '@microsoft/rayfin-connector-fabric-semanticmodel';
+ *
+ * const client = new ConnectorsRayfinClient<
+ *   DataSchema,
+ *   FunctionsSchema,
+ *   AppConnectorsSchema
+ * >(config, { salesModel: fabricSemanticModel() });
+ * ```
+ *
  * @alpha
  * @internal
  */
@@ -77,8 +104,11 @@ export declare class ConnectorsRayfinClient<TSchema extends EntitySchema = Recor
      *
      * @param config - Client configuration, including optional auth-token
      *   storage and per-connector routing configs.
+     * @param connectorsRuntime - Optional per-connector runtime hooks (e.g. binary
+     *   decoders) keyed by connector name. Required only for connectors whose
+     *   operations return a binary stream; JSON-only connectors work without it.
      */
-    constructor(config: ConnectorsRayfinClientConfig<TConnectorsSchema>);
+    constructor(config: ConnectorsRayfinClientConfig<TConnectorsSchema>, connectorsRuntime?: ConnectorsRuntime);
 }
 export default ConnectorsRayfinClient;
 //# sourceMappingURL=ConnectorsRayfinClient.d.ts.map

package/dist/experimental/ConnectorsRayfinClient.js

@@ -37,6 +37,22 @@ import RayfinClient from '../client.js';
  * });
  * ```
  *
+ * Connectors whose operations return a binary stream (such as the
+ * `fabric-semanticmodel` Apache Arrow response) need a runtime decoder. Pass a
+ * {@link ConnectorsRuntime} as the second constructor argument, keyed by the
+ * same connector names used in the schema:
+ *
+ * @example
+ * ```ts
+ * import { fabricSemanticModel } from '@microsoft/rayfin-connector-fabric-semanticmodel';
+ *
+ * const client = new ConnectorsRayfinClient<
+ *   DataSchema,
+ *   FunctionsSchema,
+ *   AppConnectorsSchema
+ * >(config, { salesModel: fabricSemanticModel() });
+ * ```
+ *
  * @alpha
  * @internal
  */
@@ -56,10 +72,13 @@ export class ConnectorsRayfinClient extends RayfinClient {
      *
      * @param config - Client configuration, including optional auth-token
      *   storage and per-connector routing configs.
+     * @param connectorsRuntime - Optional per-connector runtime hooks (e.g. binary
+     *   decoders) keyed by connector name. Required only for connectors whose
+     *   operations return a binary stream; JSON-only connectors work without it.
      */
-    constructor(config) {
+    constructor(config, connectorsRuntime) {
         super(config);
-        this.connectors = createConnectorsApi(this.apiClient, config.connectors);
+        this.connectors = createConnectorsApi(this.apiClient, config.connectors, connectorsRuntime, config.host);
     }
 }
 export default ConnectorsRayfinClient;

package/package.json

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