@inkindcards/semantic-layer 0.1.0

package/dist/react.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+var chunk4RECQ22F_cjs = require('./chunk-4RECQ22F.cjs');
+var chunkY3A3T45C_cjs = require('./chunk-Y3A3T45C.cjs');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function SemanticLayerProvider({
+  gatewayUrl,
+  anonKey,
+  client: externalClient,
+  children
+}) {
+  const client = react.useMemo(() => {
+    if (externalClient) return externalClient;
+    return new chunk4RECQ22F_cjs.SemanticLayerClient({ gatewayUrl, anonKey });
+  }, [gatewayUrl, anonKey, externalClient]);
+  const [auth, setAuth] = react.useState({
+    isAuthenticated: false,
+    isLoading: true,
+    user: null,
+    error: null
+  });
+  react.useEffect(() => {
+    let mounted = true;
+    async function initAuth() {
+      try {
+        const session = await client.getSession();
+        if (!mounted) return;
+        if (session?.user) {
+          setAuth({
+            isAuthenticated: true,
+            isLoading: false,
+            user: { id: session.user.id, email: session.user.email || "" },
+            error: null
+          });
+        } else {
+          setAuth({
+            isAuthenticated: false,
+            isLoading: false,
+            user: null,
+            error: null
+          });
+        }
+      } catch (err) {
+        if (!mounted) return;
+        setAuth({
+          isAuthenticated: false,
+          isLoading: false,
+          user: null,
+          error: err instanceof Error ? err.message : "Auth initialization failed"
+        });
+      }
+    }
+    initAuth();
+    const { data: { subscription } } = client.onAuthStateChange((_event, session) => {
+      if (!mounted) return;
+      if (session?.user) {
+        setAuth({
+          isAuthenticated: true,
+          isLoading: false,
+          user: { id: session.user.id, email: session.user.email || "" },
+          error: null
+        });
+      } else {
+        setAuth({
+          isAuthenticated: false,
+          isLoading: false,
+          user: null,
+          error: null
+        });
+      }
+    });
+    return () => {
+      mounted = false;
+      subscription.unsubscribe();
+    };
+  }, [client]);
+  const value = react.useMemo(() => ({ client, auth }), [client, auth]);
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkY3A3T45C_cjs.SemanticLayerContext.Provider, { value, children });
+}
+var defaultLoadingStyle = {
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  minHeight: "100vh",
+  fontFamily: "system-ui, -apple-system, sans-serif",
+  color: "#6b7280"
+};
+var defaultContainerStyle = {
+  display: "flex",
+  flexDirection: "column",
+  alignItems: "center",
+  justifyContent: "center",
+  minHeight: "100vh",
+  fontFamily: "system-ui, -apple-system, sans-serif",
+  gap: "16px"
+};
+var defaultButtonStyle = {
+  padding: "12px 24px",
+  fontSize: "16px",
+  fontWeight: 500,
+  color: "#ffffff",
+  backgroundColor: "#4285f4",
+  border: "none",
+  borderRadius: "8px",
+  cursor: "pointer",
+  display: "flex",
+  alignItems: "center",
+  gap: "8px"
+};
+function AuthGate({ children, loading, signInComponent }) {
+  const { isAuthenticated, isLoading, error, signIn, user } = chunkY3A3T45C_cjs.useAuth();
+  if (isLoading) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: loading || /* @__PURE__ */ jsxRuntime.jsx("div", { style: defaultLoadingStyle, children: "Loading..." }) });
+  }
+  if (!isAuthenticated) {
+    if (signInComponent) {
+      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: signInComponent({ signIn: () => signIn() }) });
+    }
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: defaultContainerStyle, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("h2", { style: { margin: 0, fontSize: "24px", color: "#111827" }, children: "Sign in to continue" }),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: 0, color: "#6b7280" }, children: "Use your inKind Google account to access data." }),
+      error && /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: 0, color: "#ef4444", fontSize: "14px" }, children: error }),
+      /* @__PURE__ */ jsxRuntime.jsx("button", { style: defaultButtonStyle, onClick: () => signIn(), children: "Sign in with Google" })
+    ] });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+}
+
+Object.defineProperty(exports, "SemanticLayerContext", {
+  enumerable: true,
+  get: function () { return chunkY3A3T45C_cjs.SemanticLayerContext; }
+});
+Object.defineProperty(exports, "useAuth", {
+  enumerable: true,
+  get: function () { return chunkY3A3T45C_cjs.useAuth; }
+});
+Object.defineProperty(exports, "useMetrics", {
+  enumerable: true,
+  get: function () { return chunkY3A3T45C_cjs.useMetrics; }
+});
+Object.defineProperty(exports, "usePivotQuery", {
+  enumerable: true,
+  get: function () { return chunkY3A3T45C_cjs.usePivotQuery; }
+});
+Object.defineProperty(exports, "useSemanticQuery", {
+  enumerable: true,
+  get: function () { return chunkY3A3T45C_cjs.useSemanticQuery; }
+});
+exports.AuthGate = AuthGate;
+exports.SemanticLayerProvider = SemanticLayerProvider;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx","../src/react/auth-gate.tsx"],"names":["useMemo","SemanticLayerClient","useState","useEffect","jsx","SemanticLayerContext","useAuth","Fragment","jsxs"],"mappings":"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","file":"react.cjs","sourcesContent":["import React, { useEffect, useMemo, useState } from \"react\";\nimport { SemanticLayerClient } from \"../client\";\nimport type { SemanticLayerConfig, AuthState } from \"../types\";\nimport { SemanticLayerContext } from \"./context\";\n\nexport interface SemanticLayerProviderProps {\n  /** The Supabase URL of the gateway project. */\n  gatewayUrl: string;\n  /** The Supabase anon/publishable key of the gateway project. */\n  anonKey: string;\n  /**\n   * Optional: a pre-constructed client instance.\n   * If provided, gatewayUrl and anonKey are ignored.\n   */\n  client?: SemanticLayerClient;\n  children: React.ReactNode;\n}\n\nexport function SemanticLayerProvider({\n  gatewayUrl,\n  anonKey,\n  client: externalClient,\n  children,\n}: SemanticLayerProviderProps) {\n  const client = useMemo(() => {\n    if (externalClient) return externalClient;\n    return new SemanticLayerClient({ gatewayUrl, anonKey });\n  }, [gatewayUrl, anonKey, externalClient]);\n\n  const [auth, setAuth] = useState<AuthState>({\n    isAuthenticated: false,\n    isLoading: true,\n    user: null,\n    error: null,\n  });\n\n  useEffect(() => {\n    let mounted = true;\n\n    async function initAuth() {\n      try {\n        const session = await client.getSession();\n        if (!mounted) return;\n\n        if (session?.user) {\n          setAuth({\n            isAuthenticated: true,\n            isLoading: false,\n            user: { id: session.user.id, email: session.user.email || \"\" },\n            error: null,\n          });\n        } else {\n          setAuth({\n            isAuthenticated: false,\n            isLoading: false,\n            user: null,\n            error: null,\n          });\n        }\n      } catch (err) {\n        if (!mounted) return;\n        setAuth({\n          isAuthenticated: false,\n          isLoading: false,\n          user: null,\n          error: err instanceof Error ? err.message : \"Auth initialization failed\",\n        });\n      }\n    }\n\n    initAuth();\n\n    const { data: { subscription } } = client.onAuthStateChange((_event, session) => {\n      if (!mounted) return;\n      if (session?.user) {\n        setAuth({\n          isAuthenticated: true,\n          isLoading: false,\n          user: { id: session.user.id, email: session.user.email || \"\" },\n          error: null,\n        });\n      } else {\n        setAuth({\n          isAuthenticated: false,\n          isLoading: false,\n          user: null,\n          error: null,\n        });\n      }\n    });\n\n    return () => {\n      mounted = false;\n      subscription.unsubscribe();\n    };\n  }, [client]);\n\n  const value = useMemo(() => ({ client, auth }), [client, auth]);\n\n  return (\n    <SemanticLayerContext.Provider value={value}>\n      {children}\n    </SemanticLayerContext.Provider>\n  );\n}\n","import React from \"react\";\nimport { useAuth } from \"./hooks\";\n\nexport interface AuthGateProps {\n  children: React.ReactNode;\n  /** Custom loading component. */\n  loading?: React.ReactNode;\n  /** Custom sign-in component. Receives a signIn callback. */\n  signInComponent?: (props: { signIn: () => void }) => React.ReactNode;\n}\n\nconst defaultLoadingStyle: React.CSSProperties = {\n  display: \"flex\",\n  alignItems: \"center\",\n  justifyContent: \"center\",\n  minHeight: \"100vh\",\n  fontFamily: \"system-ui, -apple-system, sans-serif\",\n  color: \"#6b7280\",\n};\n\nconst defaultContainerStyle: React.CSSProperties = {\n  display: \"flex\",\n  flexDirection: \"column\",\n  alignItems: \"center\",\n  justifyContent: \"center\",\n  minHeight: \"100vh\",\n  fontFamily: \"system-ui, -apple-system, sans-serif\",\n  gap: \"16px\",\n};\n\nconst defaultButtonStyle: React.CSSProperties = {\n  padding: \"12px 24px\",\n  fontSize: \"16px\",\n  fontWeight: 500,\n  color: \"#ffffff\",\n  backgroundColor: \"#4285f4\",\n  border: \"none\",\n  borderRadius: \"8px\",\n  cursor: \"pointer\",\n  display: \"flex\",\n  alignItems: \"center\",\n  gap: \"8px\",\n};\n\n/**\n * Wraps children and only renders them when the user is authenticated.\n * Shows a sign-in screen when unauthenticated.\n */\nexport function AuthGate({ children, loading, signInComponent }: AuthGateProps) {\n  const { isAuthenticated, isLoading, error, signIn, user } = useAuth();\n\n  if (isLoading) {\n    return <>{loading || <div style={defaultLoadingStyle}>Loading...</div>}</>;\n  }\n\n  if (!isAuthenticated) {\n    if (signInComponent) {\n      return <>{signInComponent({ signIn: () => signIn() })}</>;\n    }\n\n    return (\n      <div style={defaultContainerStyle}>\n        <h2 style={{ margin: 0, fontSize: \"24px\", color: \"#111827\" }}>Sign in to continue</h2>\n        <p style={{ margin: 0, color: \"#6b7280\" }}>\n          Use your inKind Google account to access data.\n        </p>\n        {error && (\n          <p style={{ margin: 0, color: \"#ef4444\", fontSize: \"14px\" }}>{error}</p>\n        )}\n        <button style={defaultButtonStyle} onClick={() => signIn()}>\n          Sign in with Google\n        </button>\n      </div>\n    );\n  }\n\n  return <>{children}</>;\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,90 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default from 'react';
+import { SemanticLayerClient } from './index.cjs';
+import * as _supabase_auth_js from '@supabase/auth-js';
+import { S as SemanticField, a as FieldCategory, P as PivotConfig, Q as QueryResult, b as SimpleQueryInput, A as AuthState } from './types-Ds_6aDEw.cjs';
+import '@supabase/supabase-js';
+
+interface SemanticLayerProviderProps {
+    /** The Supabase URL of the gateway project. */
+    gatewayUrl: string;
+    /** The Supabase anon/publishable key of the gateway project. */
+    anonKey: string;
+    /**
+     * Optional: a pre-constructed client instance.
+     * If provided, gatewayUrl and anonKey are ignored.
+     */
+    client?: SemanticLayerClient;
+    children: React__default.ReactNode;
+}
+declare function SemanticLayerProvider({ gatewayUrl, anonKey, client: externalClient, children, }: SemanticLayerProviderProps): react_jsx_runtime.JSX.Element;
+
+interface AuthGateProps {
+    children: React__default.ReactNode;
+    /** Custom loading component. */
+    loading?: React__default.ReactNode;
+    /** Custom sign-in component. Receives a signIn callback. */
+    signInComponent?: (props: {
+        signIn: () => void;
+    }) => React__default.ReactNode;
+}
+/**
+ * Wraps children and only renders them when the user is authenticated.
+ * Shows a sign-in screen when unauthenticated.
+ */
+declare function AuthGate({ children, loading, signInComponent }: AuthGateProps): react_jsx_runtime.JSX.Element;
+
+/** Returns the current auth state and sign-in/sign-out methods. */
+declare function useAuth(): {
+    signIn: (redirectTo?: string) => Promise<_supabase_auth_js.OAuthResponse>;
+    signOut: () => Promise<{
+        error: _supabase_auth_js.AuthError | null;
+    }>;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        id: string;
+        email: string;
+    } | null;
+    error: string | null;
+};
+interface UseMetricsResult {
+    fields: SemanticField[];
+    metrics: SemanticField[];
+    dimensions: SemanticField[];
+    categories: FieldCategory[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+/** Fetch the full curated catalog of metrics and dimensions. */
+declare function useMetrics(): UseMetricsResult;
+interface UseSemanticQueryOptions {
+    /** Set to false to prevent the query from running automatically. */
+    enabled?: boolean;
+}
+interface UseSemanticQueryResult {
+    data: QueryResult | null;
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+/**
+ * Execute a query against the dbt Semantic Layer using the simple input format.
+ * The query runs automatically when the input changes (unless enabled=false).
+ */
+declare function useSemanticQuery(input: SimpleQueryInput | null, options?: UseSemanticQueryOptions): UseSemanticQueryResult;
+/**
+ * Execute a query using the full PivotConfig format.
+ * Use this for advanced use cases (column pivoting, custom aggregations).
+ */
+declare function usePivotQuery(config: PivotConfig | null, options?: UseSemanticQueryOptions): UseSemanticQueryResult;
+
+interface SemanticLayerContextValue {
+    client: SemanticLayerClient;
+    auth: AuthState;
+}
+declare const SemanticLayerContext: React.Context<SemanticLayerContextValue | null>;
+
+export { AuthGate, type AuthGateProps, SemanticLayerContext, type SemanticLayerContextValue, SemanticLayerProvider, type SemanticLayerProviderProps, useAuth, useMetrics, usePivotQuery, useSemanticQuery };

package/dist/react.d.ts

@@ -0,0 +1,90 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default from 'react';
+import { SemanticLayerClient } from './index.js';
+import * as _supabase_auth_js from '@supabase/auth-js';
+import { S as SemanticField, a as FieldCategory, P as PivotConfig, Q as QueryResult, b as SimpleQueryInput, A as AuthState } from './types-Ds_6aDEw.js';
+import '@supabase/supabase-js';
+
+interface SemanticLayerProviderProps {
+    /** The Supabase URL of the gateway project. */
+    gatewayUrl: string;
+    /** The Supabase anon/publishable key of the gateway project. */
+    anonKey: string;
+    /**
+     * Optional: a pre-constructed client instance.
+     * If provided, gatewayUrl and anonKey are ignored.
+     */
+    client?: SemanticLayerClient;
+    children: React__default.ReactNode;
+}
+declare function SemanticLayerProvider({ gatewayUrl, anonKey, client: externalClient, children, }: SemanticLayerProviderProps): react_jsx_runtime.JSX.Element;
+
+interface AuthGateProps {
+    children: React__default.ReactNode;
+    /** Custom loading component. */
+    loading?: React__default.ReactNode;
+    /** Custom sign-in component. Receives a signIn callback. */
+    signInComponent?: (props: {
+        signIn: () => void;
+    }) => React__default.ReactNode;
+}
+/**
+ * Wraps children and only renders them when the user is authenticated.
+ * Shows a sign-in screen when unauthenticated.
+ */
+declare function AuthGate({ children, loading, signInComponent }: AuthGateProps): react_jsx_runtime.JSX.Element;
+
+/** Returns the current auth state and sign-in/sign-out methods. */
+declare function useAuth(): {
+    signIn: (redirectTo?: string) => Promise<_supabase_auth_js.OAuthResponse>;
+    signOut: () => Promise<{
+        error: _supabase_auth_js.AuthError | null;
+    }>;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        id: string;
+        email: string;
+    } | null;
+    error: string | null;
+};
+interface UseMetricsResult {
+    fields: SemanticField[];
+    metrics: SemanticField[];
+    dimensions: SemanticField[];
+    categories: FieldCategory[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+/** Fetch the full curated catalog of metrics and dimensions. */
+declare function useMetrics(): UseMetricsResult;
+interface UseSemanticQueryOptions {
+    /** Set to false to prevent the query from running automatically. */
+    enabled?: boolean;
+}
+interface UseSemanticQueryResult {
+    data: QueryResult | null;
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+/**
+ * Execute a query against the dbt Semantic Layer using the simple input format.
+ * The query runs automatically when the input changes (unless enabled=false).
+ */
+declare function useSemanticQuery(input: SimpleQueryInput | null, options?: UseSemanticQueryOptions): UseSemanticQueryResult;
+/**
+ * Execute a query using the full PivotConfig format.
+ * Use this for advanced use cases (column pivoting, custom aggregations).
+ */
+declare function usePivotQuery(config: PivotConfig | null, options?: UseSemanticQueryOptions): UseSemanticQueryResult;
+
+interface SemanticLayerContextValue {
+    client: SemanticLayerClient;
+    auth: AuthState;
+}
+declare const SemanticLayerContext: React.Context<SemanticLayerContextValue | null>;
+
+export { AuthGate, type AuthGateProps, SemanticLayerContext, type SemanticLayerContextValue, SemanticLayerProvider, type SemanticLayerProviderProps, useAuth, useMetrics, usePivotQuery, useSemanticQuery };

package/dist/react.js

@@ -0,0 +1,132 @@
+import { SemanticLayerClient } from './chunk-IQARBGJP.js';
+import { SemanticLayerContext, useAuth } from './chunk-NJ4IJBV3.js';
+export { SemanticLayerContext, useAuth, useMetrics, usePivotQuery, useSemanticQuery } from './chunk-NJ4IJBV3.js';
+import { useMemo, useState, useEffect } from 'react';
+import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
+
+function SemanticLayerProvider({
+  gatewayUrl,
+  anonKey,
+  client: externalClient,
+  children
+}) {
+  const client = useMemo(() => {
+    if (externalClient) return externalClient;
+    return new SemanticLayerClient({ gatewayUrl, anonKey });
+  }, [gatewayUrl, anonKey, externalClient]);
+  const [auth, setAuth] = useState({
+    isAuthenticated: false,
+    isLoading: true,
+    user: null,
+    error: null
+  });
+  useEffect(() => {
+    let mounted = true;
+    async function initAuth() {
+      try {
+        const session = await client.getSession();
+        if (!mounted) return;
+        if (session?.user) {
+          setAuth({
+            isAuthenticated: true,
+            isLoading: false,
+            user: { id: session.user.id, email: session.user.email || "" },
+            error: null
+          });
+        } else {
+          setAuth({
+            isAuthenticated: false,
+            isLoading: false,
+            user: null,
+            error: null
+          });
+        }
+      } catch (err) {
+        if (!mounted) return;
+        setAuth({
+          isAuthenticated: false,
+          isLoading: false,
+          user: null,
+          error: err instanceof Error ? err.message : "Auth initialization failed"
+        });
+      }
+    }
+    initAuth();
+    const { data: { subscription } } = client.onAuthStateChange((_event, session) => {
+      if (!mounted) return;
+      if (session?.user) {
+        setAuth({
+          isAuthenticated: true,
+          isLoading: false,
+          user: { id: session.user.id, email: session.user.email || "" },
+          error: null
+        });
+      } else {
+        setAuth({
+          isAuthenticated: false,
+          isLoading: false,
+          user: null,
+          error: null
+        });
+      }
+    });
+    return () => {
+      mounted = false;
+      subscription.unsubscribe();
+    };
+  }, [client]);
+  const value = useMemo(() => ({ client, auth }), [client, auth]);
+  return /* @__PURE__ */ jsx(SemanticLayerContext.Provider, { value, children });
+}
+var defaultLoadingStyle = {
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  minHeight: "100vh",
+  fontFamily: "system-ui, -apple-system, sans-serif",
+  color: "#6b7280"
+};
+var defaultContainerStyle = {
+  display: "flex",
+  flexDirection: "column",
+  alignItems: "center",
+  justifyContent: "center",
+  minHeight: "100vh",
+  fontFamily: "system-ui, -apple-system, sans-serif",
+  gap: "16px"
+};
+var defaultButtonStyle = {
+  padding: "12px 24px",
+  fontSize: "16px",
+  fontWeight: 500,
+  color: "#ffffff",
+  backgroundColor: "#4285f4",
+  border: "none",
+  borderRadius: "8px",
+  cursor: "pointer",
+  display: "flex",
+  alignItems: "center",
+  gap: "8px"
+};
+function AuthGate({ children, loading, signInComponent }) {
+  const { isAuthenticated, isLoading, error, signIn, user } = useAuth();
+  if (isLoading) {
+    return /* @__PURE__ */ jsx(Fragment, { children: loading || /* @__PURE__ */ jsx("div", { style: defaultLoadingStyle, children: "Loading..." }) });
+  }
+  if (!isAuthenticated) {
+    if (signInComponent) {
+      return /* @__PURE__ */ jsx(Fragment, { children: signInComponent({ signIn: () => signIn() }) });
+    }
+    return /* @__PURE__ */ jsxs("div", { style: defaultContainerStyle, children: [
+      /* @__PURE__ */ jsx("h2", { style: { margin: 0, fontSize: "24px", color: "#111827" }, children: "Sign in to continue" }),
+      /* @__PURE__ */ jsx("p", { style: { margin: 0, color: "#6b7280" }, children: "Use your inKind Google account to access data." }),
+      error && /* @__PURE__ */ jsx("p", { style: { margin: 0, color: "#ef4444", fontSize: "14px" }, children: error }),
+      /* @__PURE__ */ jsx("button", { style: defaultButtonStyle, onClick: () => signIn(), children: "Sign in with Google" })
+    ] });
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+export { AuthGate, SemanticLayerProvider };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx","../src/react/auth-gate.tsx"],"names":["jsx"],"mappings":"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","file":"react.js","sourcesContent":["import React, { useEffect, useMemo, useState } from \"react\";\nimport { SemanticLayerClient } from \"../client\";\nimport type { SemanticLayerConfig, AuthState } from \"../types\";\nimport { SemanticLayerContext } from \"./context\";\n\nexport interface SemanticLayerProviderProps {\n  /** The Supabase URL of the gateway project. */\n  gatewayUrl: string;\n  /** The Supabase anon/publishable key of the gateway project. */\n  anonKey: string;\n  /**\n   * Optional: a pre-constructed client instance.\n   * If provided, gatewayUrl and anonKey are ignored.\n   */\n  client?: SemanticLayerClient;\n  children: React.ReactNode;\n}\n\nexport function SemanticLayerProvider({\n  gatewayUrl,\n  anonKey,\n  client: externalClient,\n  children,\n}: SemanticLayerProviderProps) {\n  const client = useMemo(() => {\n    if (externalClient) return externalClient;\n    return new SemanticLayerClient({ gatewayUrl, anonKey });\n  }, [gatewayUrl, anonKey, externalClient]);\n\n  const [auth, setAuth] = useState<AuthState>({\n    isAuthenticated: false,\n    isLoading: true,\n    user: null,\n    error: null,\n  });\n\n  useEffect(() => {\n    let mounted = true;\n\n    async function initAuth() {\n      try {\n        const session = await client.getSession();\n        if (!mounted) return;\n\n        if (session?.user) {\n          setAuth({\n            isAuthenticated: true,\n            isLoading: false,\n            user: { id: session.user.id, email: session.user.email || \"\" },\n            error: null,\n          });\n        } else {\n          setAuth({\n            isAuthenticated: false,\n            isLoading: false,\n            user: null,\n            error: null,\n          });\n        }\n      } catch (err) {\n        if (!mounted) return;\n        setAuth({\n          isAuthenticated: false,\n          isLoading: false,\n          user: null,\n          error: err instanceof Error ? err.message : \"Auth initialization failed\",\n        });\n      }\n    }\n\n    initAuth();\n\n    const { data: { subscription } } = client.onAuthStateChange((_event, session) => {\n      if (!mounted) return;\n      if (session?.user) {\n        setAuth({\n          isAuthenticated: true,\n          isLoading: false,\n          user: { id: session.user.id, email: session.user.email || \"\" },\n          error: null,\n        });\n      } else {\n        setAuth({\n          isAuthenticated: false,\n          isLoading: false,\n          user: null,\n          error: null,\n        });\n      }\n    });\n\n    return () => {\n      mounted = false;\n      subscription.unsubscribe();\n    };\n  }, [client]);\n\n  const value = useMemo(() => ({ client, auth }), [client, auth]);\n\n  return (\n    <SemanticLayerContext.Provider value={value}>\n      {children}\n    </SemanticLayerContext.Provider>\n  );\n}\n","import React from \"react\";\nimport { useAuth } from \"./hooks\";\n\nexport interface AuthGateProps {\n  children: React.ReactNode;\n  /** Custom loading component. */\n  loading?: React.ReactNode;\n  /** Custom sign-in component. Receives a signIn callback. */\n  signInComponent?: (props: { signIn: () => void }) => React.ReactNode;\n}\n\nconst defaultLoadingStyle: React.CSSProperties = {\n  display: \"flex\",\n  alignItems: \"center\",\n  justifyContent: \"center\",\n  minHeight: \"100vh\",\n  fontFamily: \"system-ui, -apple-system, sans-serif\",\n  color: \"#6b7280\",\n};\n\nconst defaultContainerStyle: React.CSSProperties = {\n  display: \"flex\",\n  flexDirection: \"column\",\n  alignItems: \"center\",\n  justifyContent: \"center\",\n  minHeight: \"100vh\",\n  fontFamily: \"system-ui, -apple-system, sans-serif\",\n  gap: \"16px\",\n};\n\nconst defaultButtonStyle: React.CSSProperties = {\n  padding: \"12px 24px\",\n  fontSize: \"16px\",\n  fontWeight: 500,\n  color: \"#ffffff\",\n  backgroundColor: \"#4285f4\",\n  border: \"none\",\n  borderRadius: \"8px\",\n  cursor: \"pointer\",\n  display: \"flex\",\n  alignItems: \"center\",\n  gap: \"8px\",\n};\n\n/**\n * Wraps children and only renders them when the user is authenticated.\n * Shows a sign-in screen when unauthenticated.\n */\nexport function AuthGate({ children, loading, signInComponent }: AuthGateProps) {\n  const { isAuthenticated, isLoading, error, signIn, user } = useAuth();\n\n  if (isLoading) {\n    return <>{loading || <div style={defaultLoadingStyle}>Loading...</div>}</>;\n  }\n\n  if (!isAuthenticated) {\n    if (signInComponent) {\n      return <>{signInComponent({ signIn: () => signIn() })}</>;\n    }\n\n    return (\n      <div style={defaultContainerStyle}>\n        <h2 style={{ margin: 0, fontSize: \"24px\", color: \"#111827\" }}>Sign in to continue</h2>\n        <p style={{ margin: 0, color: \"#6b7280\" }}>\n          Use your inKind Google account to access data.\n        </p>\n        {error && (\n          <p style={{ margin: 0, color: \"#ef4444\", fontSize: \"14px\" }}>{error}</p>\n        )}\n        <button style={defaultButtonStyle} onClick={() => signIn()}>\n          Sign in with Google\n        </button>\n      </div>\n    );\n  }\n\n  return <>{children}</>;\n}\n"]}

package/dist/types-Ds_6aDEw.d.cts

@@ -0,0 +1,79 @@
+type FieldType = "metric" | "dimension" | "time_dimension" | "entity";
+type AggregationType = "sum" | "avg" | "count" | "min" | "max" | "count_distinct";
+type TimeGrain = "day" | "week" | "month" | "quarter" | "year";
+type DataType = "number" | "string" | "date" | "boolean";
+interface SemanticField {
+    id: string;
+    name: string;
+    displayName: string;
+    description: string;
+    type: FieldType;
+    dataType: DataType;
+    category: string;
+    aggregation?: AggregationType;
+    defaultGrain?: TimeGrain;
+    compatibleWith?: string[];
+    tags?: string[];
+}
+interface FieldCategory {
+    name: string;
+    type: string;
+}
+interface MetadataResponse {
+    fields: SemanticField[];
+    categories: FieldCategory[];
+}
+interface PivotField {
+    fieldId: string;
+    field: SemanticField;
+    aggregation?: AggregationType;
+    grain?: TimeGrain;
+    filterValues?: string[];
+    filterOperator?: "in" | "not_in" | "gt" | "lt" | "gte" | "lte" | "between";
+    filterRange?: [string, string];
+    sortDirection?: "asc" | "desc";
+}
+interface PivotConfig {
+    values: PivotField[];
+    rows: PivotField[];
+    columns: PivotField[];
+    filters: PivotField[];
+}
+interface QueryColumn {
+    key: string;
+    label: string;
+    dataType: DataType;
+}
+interface QueryResult {
+    columns: QueryColumn[];
+    rows: Record<string, unknown>[];
+    totalRows: number;
+    executionTimeMs: number;
+}
+/**
+ * Simplified query input for the SDK (alternative to the full PivotConfig).
+ * Lets callers specify metrics/dimensions by name without building full PivotField objects.
+ */
+interface SimpleQueryInput {
+    metrics: string[];
+    groupBy?: string[];
+    grain?: TimeGrain;
+    filters?: Record<string, string[]>;
+    orderBy?: string;
+    limit?: number;
+}
+interface SemanticLayerConfig {
+    gatewayUrl: string;
+    anonKey: string;
+}
+interface AuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        id: string;
+        email: string;
+    } | null;
+    error: string | null;
+}
+
+export type { AuthState as A, DataType as D, FieldType as F, MetadataResponse as M, PivotConfig as P, QueryResult as Q, SemanticField as S, TimeGrain as T, FieldCategory as a, SimpleQueryInput as b, SemanticLayerConfig as c, AggregationType as d, PivotField as e, QueryColumn as f };

package/dist/types-Ds_6aDEw.d.ts

@@ -0,0 +1,79 @@
+type FieldType = "metric" | "dimension" | "time_dimension" | "entity";
+type AggregationType = "sum" | "avg" | "count" | "min" | "max" | "count_distinct";
+type TimeGrain = "day" | "week" | "month" | "quarter" | "year";
+type DataType = "number" | "string" | "date" | "boolean";
+interface SemanticField {
+    id: string;
+    name: string;
+    displayName: string;
+    description: string;
+    type: FieldType;
+    dataType: DataType;
+    category: string;
+    aggregation?: AggregationType;
+    defaultGrain?: TimeGrain;
+    compatibleWith?: string[];
+    tags?: string[];
+}
+interface FieldCategory {
+    name: string;
+    type: string;
+}
+interface MetadataResponse {
+    fields: SemanticField[];
+    categories: FieldCategory[];
+}
+interface PivotField {
+    fieldId: string;
+    field: SemanticField;
+    aggregation?: AggregationType;
+    grain?: TimeGrain;
+    filterValues?: string[];
+    filterOperator?: "in" | "not_in" | "gt" | "lt" | "gte" | "lte" | "between";
+    filterRange?: [string, string];
+    sortDirection?: "asc" | "desc";
+}
+interface PivotConfig {
+    values: PivotField[];
+    rows: PivotField[];
+    columns: PivotField[];
+    filters: PivotField[];
+}
+interface QueryColumn {
+    key: string;
+    label: string;
+    dataType: DataType;
+}
+interface QueryResult {
+    columns: QueryColumn[];
+    rows: Record<string, unknown>[];
+    totalRows: number;
+    executionTimeMs: number;
+}
+/**
+ * Simplified query input for the SDK (alternative to the full PivotConfig).
+ * Lets callers specify metrics/dimensions by name without building full PivotField objects.
+ */
+interface SimpleQueryInput {
+    metrics: string[];
+    groupBy?: string[];
+    grain?: TimeGrain;
+    filters?: Record<string, string[]>;
+    orderBy?: string;
+    limit?: number;
+}
+interface SemanticLayerConfig {
+    gatewayUrl: string;
+    anonKey: string;
+}
+interface AuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        id: string;
+        email: string;
+    } | null;
+    error: string | null;
+}
+
+export type { AuthState as A, DataType as D, FieldType as F, MetadataResponse as M, PivotConfig as P, QueryResult as Q, SemanticField as S, TimeGrain as T, FieldCategory as a, SimpleQueryInput as b, SemanticLayerConfig as c, AggregationType as d, PivotField as e, QueryColumn as f };