@xylex-group/athena 2.14.0 → 3.0.2

package/dist/{payload-BbSCmILD.d.ts → payload-DWI1rw-e.d.cts}

@@ -1,37 +1,3 @@
-import { an as AthenaCreateClientAuthOptions, af as AthenaClientExperimentalOptions, aI as AthenaHeaderBag } from './client-uthENhaf.js';
-import { o as BackendConfig, p as BackendType } from './types-YQUR7wu0.js';
-
-interface AthenaRequestCookiesBag {
-    getAll(): Array<{
-        name: string;
-        value: string;
-    }>;
-}
-type AthenaRequestHeadersInput = AthenaHeaderBag | Record<string, string | null | undefined>;
-type AthenaRequestCookiesInput = AthenaRequestCookiesBag | string | null | undefined;
-type AthenaAdapterExperimentalOptions = Omit<AthenaClientExperimentalOptions, 'athenaStorageBackend'>;
-interface AthenaAdapterBaseOptions {
-    env?: Record<string, string | undefined>;
-    url?: string | null | undefined;
-    gatewayUrl?: string | null | undefined;
-    authUrl?: string | null | undefined;
-    chatUrl?: string | null | undefined;
-    chatWsUrl?: string | null | undefined;
-    storageUrl?: string | null | undefined;
-    key?: string | null | undefined;
-    client?: string | null | undefined;
-    backend?: BackendConfig | BackendType;
-    headers?: Record<string, string>;
-    auth?: AthenaCreateClientAuthOptions;
-    forceNoCache?: boolean;
-    storage?: boolean;
-    experimental?: AthenaAdapterExperimentalOptions;
-}
-interface AthenaServerRequestOptions {
-    requestHeaders?: AthenaRequestHeadersInput;
-    requestCookies?: AthenaRequestCookiesInput;
-}
-
 /**
  * Default App Router path for the Athena Auth session cookie bridge.
  *
@@ -216,4 +182,4 @@ declare function clearAthenaAuthSessionOnAppHost(options?: AthenaAuthSessionBrid
  */
 declare function resolveSessionBridgePayload(payload: AthenaAuthSessionBridgeSource | null | undefined): AthenaAuthSessionBridgePayload | null;
 
-export { type AthenaAdapterBaseOptions as A, type AthenaAdapterExperimentalOptions as a, ATHENA_AUTH_SESSION_BRIDGE_ROUTE as b, ATHENA_AUTH_SESSION_COOKIE_NAME as c, ATHENA_AUTH_SESSION_COOKIE_NAMES as d, type AthenaAuthSessionBridgeClientOptions as e, type AthenaAuthSessionBridgePayload as f, type AthenaAuthSessionBridgeSource as g, clearAthenaAuthSessionOnAppHost as h, type AthenaAuthSessionBridgeOptions as i, type AthenaAuthSessionBridgePathOptions as j, type AthenaServerRequestOptions as k, persistAthenaAuthSessionOnAppHost as p, resolveSessionBridgePayload as r };
+export { ATHENA_AUTH_SESSION_BRIDGE_ROUTE as A, ATHENA_AUTH_SESSION_COOKIE_NAME as a, ATHENA_AUTH_SESSION_COOKIE_NAMES as b, type AthenaAuthSessionBridgeClientOptions as c, type AthenaAuthSessionBridgePayload as d, type AthenaAuthSessionBridgeSource as e, clearAthenaAuthSessionOnAppHost as f, type AthenaAuthSessionBridgeOptions as g, type AthenaAuthSessionBridgePathOptions as h, persistAthenaAuthSessionOnAppHost as p, resolveSessionBridgePayload as r };

package/dist/{payload-zXIwKTQf.d.cts → payload-DWI1rw-e.d.ts}

@@ -1,37 +1,3 @@
-import { an as AthenaCreateClientAuthOptions, af as AthenaClientExperimentalOptions, aI as AthenaHeaderBag } from './client-wU2J9yqb.cjs';
-import { o as BackendConfig, p as BackendType } from './types-YQUR7wu0.cjs';
-
-interface AthenaRequestCookiesBag {
-    getAll(): Array<{
-        name: string;
-        value: string;
-    }>;
-}
-type AthenaRequestHeadersInput = AthenaHeaderBag | Record<string, string | null | undefined>;
-type AthenaRequestCookiesInput = AthenaRequestCookiesBag | string | null | undefined;
-type AthenaAdapterExperimentalOptions = Omit<AthenaClientExperimentalOptions, 'athenaStorageBackend'>;
-interface AthenaAdapterBaseOptions {
-    env?: Record<string, string | undefined>;
-    url?: string | null | undefined;
-    gatewayUrl?: string | null | undefined;
-    authUrl?: string | null | undefined;
-    chatUrl?: string | null | undefined;
-    chatWsUrl?: string | null | undefined;
-    storageUrl?: string | null | undefined;
-    key?: string | null | undefined;
-    client?: string | null | undefined;
-    backend?: BackendConfig | BackendType;
-    headers?: Record<string, string>;
-    auth?: AthenaCreateClientAuthOptions;
-    forceNoCache?: boolean;
-    storage?: boolean;
-    experimental?: AthenaAdapterExperimentalOptions;
-}
-interface AthenaServerRequestOptions {
-    requestHeaders?: AthenaRequestHeadersInput;
-    requestCookies?: AthenaRequestCookiesInput;
-}
-
 /**
  * Default App Router path for the Athena Auth session cookie bridge.
  *
@@ -216,4 +182,4 @@ declare function clearAthenaAuthSessionOnAppHost(options?: AthenaAuthSessionBrid
  */
 declare function resolveSessionBridgePayload(payload: AthenaAuthSessionBridgeSource | null | undefined): AthenaAuthSessionBridgePayload | null;
 
-export { type AthenaAdapterBaseOptions as A, type AthenaAdapterExperimentalOptions as a, ATHENA_AUTH_SESSION_BRIDGE_ROUTE as b, ATHENA_AUTH_SESSION_COOKIE_NAME as c, ATHENA_AUTH_SESSION_COOKIE_NAMES as d, type AthenaAuthSessionBridgeClientOptions as e, type AthenaAuthSessionBridgePayload as f, type AthenaAuthSessionBridgeSource as g, clearAthenaAuthSessionOnAppHost as h, type AthenaAuthSessionBridgeOptions as i, type AthenaAuthSessionBridgePathOptions as j, type AthenaServerRequestOptions as k, persistAthenaAuthSessionOnAppHost as p, resolveSessionBridgePayload as r };
+export { ATHENA_AUTH_SESSION_BRIDGE_ROUTE as A, ATHENA_AUTH_SESSION_COOKIE_NAME as a, ATHENA_AUTH_SESSION_COOKIE_NAMES as b, type AthenaAuthSessionBridgeClientOptions as c, type AthenaAuthSessionBridgePayload as d, type AthenaAuthSessionBridgeSource as e, clearAthenaAuthSessionOnAppHost as f, type AthenaAuthSessionBridgeOptions as g, type AthenaAuthSessionBridgePathOptions as h, persistAthenaAuthSessionOnAppHost as p, resolveSessionBridgePayload as r };

package/dist/{pipeline-DqwehoQV.d.ts → pipeline-B8aN2EHe.d.ts}

@@ -1,4 +1,4 @@
-import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-C1swabT5.js';
+import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-BaAMXCqK.js';
 
 /**
  * End-to-end generator execution: load config, introspect, render, and optionally write files.

package/dist/{pipeline-CwQoD5G9.d.cts → pipeline-D4W-Cc-A.d.cts}

@@ -1,4 +1,4 @@
-import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-dHnjluBC.cjs';
+import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-BBm-kEBL.cjs';
 
 /**
  * End-to-end generator execution: load config, introspect, render, and optionally write files.

package/dist/proxy-request-headers-DGxdoyA0.d.cts

@@ -0,0 +1,59 @@
+import { I as EnvLike } from './athena-request-headers-DujFFyMU.cjs';
+
+/**
+ * Request header / Next.js helpers used by middleware and RSC session loaders.
+ * Framework-agnostic (no Next imports).
+ */
+/**
+ * True when Next.js threw because the route used dynamic APIs during static
+ * generation (`DYNAMIC_SERVER_USAGE` digest or matching message).
+ *
+ * Catch and rethrow (or handle) so Next can mark the route dynamic.
+ */
+declare function isDynamicServerUsageError(error: unknown): boolean;
+interface GetOriginFromHeadersOptions {
+    /**
+     * When `x-forwarded-proto` / scheme is missing, use `http` if true else `https`.
+     * Typical: `process.env.NODE_ENV !== "production"`.
+     */
+    preferHttpWhenMissingProto?: boolean;
+}
+/**
+ * Reconstruct public origin from request headers (Origin, or Host + proto).
+ *
+ * Prefers `Origin`, then `x-forwarded-host` / `host` with
+ * `x-forwarded-proto` (first value when comma-separated).
+ */
+declare function getOriginFromHeaders(headersList: {
+    get: (name: string) => string | null;
+}, options?: GetOriginFromHeadersOptions): string | null;
+
+/**
+ * Read the first non-empty trimmed environment variable from a name list.
+ *
+ * @param names - Candidate env keys in priority order
+ * @param env - Optional env map (defaults to `process.env`)
+ * @returns Trimmed value of the first key that is set and non-empty
+ * @throws {Error} When none of the keys yield a non-empty value
+ *
+ * @example
+ * ```ts
+ * import { requireEnv } from "@xylex-group/athena/utils"
+ *
+ * const authUrl = requireEnv([
+ *   "ATHENA_AUTH_UPSTREAM_URL",
+ *   "ATHENA_AUTH_URL",
+ *   "NEXT_PUBLIC_ATHENA_AUTH_URL",
+ * ])
+ * ```
+ */
+declare function requireEnv(names: readonly string[], env?: EnvLike): string;
+/**
+ * Like {@link requireEnv}, but returns `undefined` instead of throwing when
+ * none of the keys are set.
+ */
+declare function readEnv(names: readonly string[], env?: EnvLike): string | undefined;
+
+declare function proxyRequestHeaders(request: Request): Headers;
+
+export { type GetOriginFromHeadersOptions as G, requireEnv as a, getOriginFromHeaders as g, isDynamicServerUsageError as i, proxyRequestHeaders as p, readEnv as r };

package/dist/proxy-request-headers-m4D2Tduy.d.ts

@@ -0,0 +1,59 @@
+import { I as EnvLike } from './athena-request-headers-C7Jy-c_D.js';
+
+/**
+ * Request header / Next.js helpers used by middleware and RSC session loaders.
+ * Framework-agnostic (no Next imports).
+ */
+/**
+ * True when Next.js threw because the route used dynamic APIs during static
+ * generation (`DYNAMIC_SERVER_USAGE` digest or matching message).
+ *
+ * Catch and rethrow (or handle) so Next can mark the route dynamic.
+ */
+declare function isDynamicServerUsageError(error: unknown): boolean;
+interface GetOriginFromHeadersOptions {
+    /**
+     * When `x-forwarded-proto` / scheme is missing, use `http` if true else `https`.
+     * Typical: `process.env.NODE_ENV !== "production"`.
+     */
+    preferHttpWhenMissingProto?: boolean;
+}
+/**
+ * Reconstruct public origin from request headers (Origin, or Host + proto).
+ *
+ * Prefers `Origin`, then `x-forwarded-host` / `host` with
+ * `x-forwarded-proto` (first value when comma-separated).
+ */
+declare function getOriginFromHeaders(headersList: {
+    get: (name: string) => string | null;
+}, options?: GetOriginFromHeadersOptions): string | null;
+
+/**
+ * Read the first non-empty trimmed environment variable from a name list.
+ *
+ * @param names - Candidate env keys in priority order
+ * @param env - Optional env map (defaults to `process.env`)
+ * @returns Trimmed value of the first key that is set and non-empty
+ * @throws {Error} When none of the keys yield a non-empty value
+ *
+ * @example
+ * ```ts
+ * import { requireEnv } from "@xylex-group/athena/utils"
+ *
+ * const authUrl = requireEnv([
+ *   "ATHENA_AUTH_UPSTREAM_URL",
+ *   "ATHENA_AUTH_URL",
+ *   "NEXT_PUBLIC_ATHENA_AUTH_URL",
+ * ])
+ * ```
+ */
+declare function requireEnv(names: readonly string[], env?: EnvLike): string;
+/**
+ * Like {@link requireEnv}, but returns `undefined` instead of throwing when
+ * none of the keys are set.
+ */
+declare function readEnv(names: readonly string[], env?: EnvLike): string | undefined;
+
+declare function proxyRequestHeaders(request: Request): Headers;
+
+export { type GetOriginFromHeadersOptions as G, requireEnv as a, getOriginFromHeaders as g, isDynamicServerUsageError as i, proxyRequestHeaders as p, readEnv as r };

package/dist/react.cjs

@@ -86,7 +86,7 @@ function isAthenaGatewayError(error) {
 }
 
 // src/gateway/url.ts
-var ATHENA_DEFAULT_BASE_URL = "https://athena-db.com";
+var ATHENA_DEFAULT_BASE_URL = "https://mirror2.athena-cluster.com";
 function describeReceivedValue(value) {
   if (value === void 0) return "undefined";
   if (value === null) return "null";
@@ -109,14 +109,14 @@ function normalizeAthenaGatewayBaseUrl(input, options = {}) {
   if (candidate === void 0 || candidate === null) {
     throw invalidBaseUrlError(
       `${label} must be a non-empty absolute http(s) URL. Received ${describeReceivedValue(input)}.`,
-      'Set ATHENA_URL (or pass createClient(url, ...)) to a full URL such as "https://mirror3.athena-db.com".'
+      'Set ATHENA_URL in the explicit env object (or pass createClient({ url, key })) to a full URL such as "https://mirror2.athena-cluster.com".'
     );
   }
   const trimmed = candidate.trim();
   if (!trimmed) {
     throw invalidBaseUrlError(
       `${label} must be a non-empty absolute http(s) URL. Received ${describeReceivedValue(candidate)}.`,
-      'Set ATHENA_URL (or pass createClient(url, ...)) to a full URL such as "https://mirror3.athena-db.com".'
+      'Set ATHENA_URL in the explicit env object (or pass createClient({ url, key })) to a full URL such as "https://mirror2.athena-cluster.com".'
     );
   }
   let parsed;
@@ -125,13 +125,13 @@ function normalizeAthenaGatewayBaseUrl(input, options = {}) {
   } catch {
     throw invalidBaseUrlError(
       `${label} must be a valid absolute http(s) URL. Received ${describeReceivedValue(candidate)}.`,
-      'Use a full URL including the protocol, for example "https://mirror3.athena-db.com".'
+      'Use a full URL including the protocol, for example "https://mirror2.athena-cluster.com".'
     );
   }
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
     throw invalidBaseUrlError(
       `${label} must use http or https. Received ${JSON.stringify(trimmed)}.`,
-      'Use an Athena gateway URL such as "https://mirror3.athena-db.com".'
+      'Use an Athena gateway URL such as "https://mirror2.athena-cluster.com".'
     );
   }
   if (parsed.search || parsed.hash) {
@@ -198,7 +198,7 @@ var PROFILE_RULES = {
   gateway: { apiKeys: true, routing: true, authMirror: true, authBearer: false, contentType: true, stripNullsDefault: true },
   chat: { apiKeys: true, routing: true, authMirror: true, authBearer: true, accept: true },
   storage: { apiKeys: true, routing: true, authMirror: true, authBearer: false, contentType: true },
-  auth: { apiKeys: true, routing: false, authMirror: false, authBearer: true, contentType: true },
+  auth: { apiKeys: true, routing: true, authMirror: false, authBearer: true, contentType: true },
   minimal: { apiKeys: false, routing: false, authMirror: false, authBearer: false }
 };
 function normalizeHeaderValue(value) {
@@ -258,7 +258,6 @@ function resolveBackendType(backend) {
 function resolveRequestHeaderOverrides(config, options, defaults) {
   return {
     apiKey: options?.apiKey ?? config.apiKey,
-    athenaKey: options?.athenaKey ?? config.athenaKey,
     client: options?.client ?? config.client ?? defaults?.client,
     userId: options?.userId ?? config.userId,
     organizationId: options?.organizationId ?? config.organizationId,
@@ -288,10 +287,10 @@ function buildServiceRequestHeaders(profile, sdkHeaderValue, config, options, ex
     accept: extras?.accept ?? (rules.accept ? "application/json" : void 0)
   });
 }
-function applyAthenaApiKeyHeaders(headers, apiKey, athenaKey) {
-  const resolvedAthenaKey = normalizeHeaderValue(athenaKey) ?? normalizeHeaderValue(apiKey);
-  if (resolvedAthenaKey && !hasHeaderIgnoreCase(headers, "X-Athena-Key")) {
-    headers["X-Athena-Key"] = resolvedAthenaKey;
+function applyAthenaApiKeyHeaders(headers, apiKey) {
+  const resolvedApiKey = normalizeHeaderValue(apiKey);
+  if (resolvedApiKey && !hasHeaderIgnoreCase(headers, "X-Athena-Key")) {
+    headers["X-Athena-Key"] = resolvedApiKey;
   }
 }
 function applyAthenaAuthContextHeaders(headers, input) {
@@ -355,7 +354,7 @@ function buildAthenaRequestHeaders(input) {
   const headerClient = resolveHeaderValue(mergedExtraHeaders, CLIENT_HEADER_CANDIDATES);
   const finalClient = normalizeHeaderValue(input.client) ?? headerClient;
   const finalApiKey = normalizeHeaderValue(input.apiKey) ?? resolveHeaderValue(mergedExtraHeaders, API_KEY_HEADER_CANDIDATES);
-  const finalAthenaKey = normalizeHeaderValue(input.athenaKey) ?? resolveHeaderValue(mergedExtraHeaders, ATHENA_KEY_HEADER_CANDIDATES) ?? finalApiKey;
+  const finalAthenaKey = resolveHeaderValue(mergedExtraHeaders, ATHENA_KEY_HEADER_CANDIDATES) ?? finalApiKey;
   const headers = {
     "X-Athena-Sdk": input.sdkHeaderValue
   };
@@ -389,7 +388,7 @@ function buildAthenaRequestHeaders(input) {
     }
   }
   if (rules.apiKeys && (finalApiKey || finalAthenaKey)) {
-    applyAthenaApiKeyHeaders(headers, finalApiKey, finalAthenaKey);
+    applyAthenaApiKeyHeaders(headers, finalAthenaKey);
   }
   applyAthenaAuthContextHeaders(headers, input);
   applyAthenaPgUriHeaders(headers, input);
@@ -414,7 +413,7 @@ function buildAthenaRequestHeaders(input) {
 
 // package.json
 var package_default = {
-  version: "2.14.0"
+  version: "3.0.2"
 };
 
 // src/sdk-version.ts
@@ -424,7 +423,7 @@ function buildSdkHeaderValue(sdkName) {
 }
 
 // src/gateway/client.ts
-var DEFAULT_CLIENT = "railway_direct";
+var DEFAULT_CLIENT = "DEFAULT_CLIENT";
 var SDK_NAME = "xylex-group/athena";
 var SDK_HEADER_VALUE = buildSdkHeaderValue(SDK_NAME);
 function parseResponseBody(rawText, contentType) {
@@ -841,6 +840,9 @@ function createAthenaGatewayClient(config = {}) {
     buildHeaders(options) {
       return buildHeaders(normalizedConfig, options);
     },
+    async resolveCallOptions(options) {
+      return options;
+    },
     verifyConnection(options) {
       return performConnectionCheck(
         normalizedBaseUrl,
@@ -2002,7 +2004,7 @@ function resolveGetSession(authClient) {
   if ("auth" in authClient && authClient.auth && typeof authClient.auth.getSession === "function") {
     return authClient.auth.getSession;
   }
-  throw new Error("useSession requires an auth-capable client (createClient(...).auth or createAuthClient(...))");
+  throw new Error("useSession requires an auth-capable client (createClient(...).auth)");
 }
 function useSession(authClient, options = {}) {
   const enabled = options.enabled ?? true;
@@ -2090,7 +2092,12 @@ function useSession(authClient, options = {}) {
 function useAthenaSessionClient(baseClient, options = {}) {
   const sessionState = useSession(baseClient, options);
   const scopedClient = React.useMemo(
-    () => sessionState.data ? baseClient.withSession(sessionState.data) : baseClient,
+    () => sessionState.data ? baseClient.withContext({
+      userId: sessionState.data.user.id,
+      organizationId: sessionState.data.session.activeOrganizationId,
+      bearerToken: sessionState.data.session.token,
+      sessionToken: sessionState.data.session.token
+    }) : baseClient,
     [baseClient, sessionState.data]
   );
   const session = sessionState.data;
@@ -2185,6 +2192,98 @@ function normalizeHookUploadInput(defaults, input, onProgress) {
 function isStorageUploadInput(input) {
   return Boolean(input) && typeof input === "object" && "files" in input && "s3_id" in input;
 }
+function useStorageFiles(options) {
+  const { storage, input, enabled = true, callOptions, refreshIntervalMs } = options;
+  const [data, setData] = React__namespace.useState(null);
+  const [loading, setLoading] = React__namespace.useState(false);
+  const [error, setError] = React__namespace.useState(null);
+  const requestIdRef = React__namespace.useRef(0);
+  const refetch = React__namespace.useCallback(async () => {
+    if (!input || !enabled) {
+      setData(null);
+      setError(null);
+      setLoading(false);
+      return null;
+    }
+    const requestId = requestIdRef.current + 1;
+    requestIdRef.current = requestId;
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await storage.file.list(input, callOptions);
+      if (requestIdRef.current === requestId) {
+        setData(result);
+      }
+      return result;
+    } catch (listError) {
+      if (requestIdRef.current === requestId) {
+        setError(listError);
+        setData(null);
+      }
+      throw listError;
+    } finally {
+      if (requestIdRef.current === requestId) {
+        setLoading(false);
+      }
+    }
+  }, [callOptions, enabled, input, storage]);
+  React__namespace.useEffect(() => {
+    void refetch().catch(() => {
+    });
+  }, [refetch]);
+  React__namespace.useEffect(() => {
+    if (!enabled || !input || !refreshIntervalMs || refreshIntervalMs <= 0) {
+      return;
+    }
+    const globalObject = globalThis;
+    const timer = globalObject.setInterval(() => {
+      void refetch().catch(() => {
+      });
+    }, refreshIntervalMs);
+    return () => globalObject.clearInterval(timer);
+  }, [enabled, input, refetch, refreshIntervalMs]);
+  return {
+    files: data?.files ?? [],
+    count: data?.count ?? data?.files?.length ?? 0,
+    loading,
+    error,
+    data,
+    refetch
+  };
+}
+function useStorageFileDelete(options) {
+  const { storage, onSuccess, onError } = options;
+  const [deleting, setDeleting] = React__namespace.useState(false);
+  const [error, setError] = React__namespace.useState(null);
+  const reset = React__namespace.useCallback(() => {
+    setDeleting(false);
+    setError(null);
+  }, []);
+  const deleteFile = React__namespace.useCallback(
+    async (fileId, callOptions) => {
+      setDeleting(true);
+      setError(null);
+      try {
+        const result = await storage.file.delete(fileId, callOptions);
+        onSuccess?.(result);
+        return result;
+      } catch (deleteError) {
+        setError(deleteError);
+        onError?.(deleteError);
+        throw deleteError;
+      } finally {
+        setDeleting(false);
+      }
+    },
+    [onError, onSuccess, storage]
+  );
+  return {
+    deleting,
+    error,
+    deleteFile,
+    reset
+  };
+}
 
 // src/schema/model-form.ts
 function resolveNullishValue(mode) {
@@ -2262,6 +2361,8 @@ exports.useAthenaSessionClient = useAthenaSessionClient;
 exports.useMutation = useMutation;
 exports.useQuery = useQuery;
 exports.useSession = useSession;
+exports.useStorageFileDelete = useStorageFileDelete;
+exports.useStorageFiles = useStorageFiles;
 exports.useStorageUpload = useStorageUpload;
 //# sourceMappingURL=react.cjs.map
 //# sourceMappingURL=react.cjs.map