@xylex-group/athena 3.0.0 → 3.0.2

package/dist/next/server.d.cts

@@ -1,11 +1,14 @@
 import { ad as AthenaAuthSessionResponse } from '../types-AOY-GLu8.cjs';
-import { ay as AthenaRequestContext } from '../v3-client-G8JMOilK.cjs';
+import { r as AthenaClientModelsInput } from '../types-CgCv5o6R.cjs';
+import { ax as AthenaRequestContext, ah as AthenaClientConfig, ag as AthenaClient } from '../v3-client-CWfZHcKL.cjs';
 import { g as AthenaAuthSessionBridgeOptions, h as AthenaAuthSessionBridgePathOptions } from '../payload-DWI1rw-e.cjs';
 export { A as ATHENA_AUTH_SESSION_BRIDGE_ROUTE, a as ATHENA_AUTH_SESSION_COOKIE_NAME, b as ATHENA_AUTH_SESSION_COOKIE_NAMES, c as AthenaAuthSessionBridgeClientOptions, d as AthenaAuthSessionBridgePayload, e as AthenaAuthSessionBridgeSource, f as clearAthenaAuthSessionOnAppHost, p as persistAthenaAuthSessionOnAppHost, r as resolveSessionBridgePayload } from '../payload-DWI1rw-e.cjs';
 export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from '../session-cookie-detection-BqOp9mO6.cjs';
+export { A as ATHENA_AUTH_COOKIE_PREFIXES, a as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, b as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, c as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, d as ATHENA_AUTH_GET_SESSION_PATH, e as ATHENA_AUTH_PATH, f as ATHENA_AUTH_UPSTREAM_ENV_KEYS, g as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, h as ATHENA_AUTH_VERIFY_EMAIL_PATH, i as ATHENA_SESSION_DATA_HEADER, j as AUTHENTICATED_REDIRECT_MODE_SET, k as AUTHENTICATED_REDIRECT_VIEW_SET, l as AUTH_DEFAULT_VIEW, m as AUTH_MODE_REDIRECTS, n as AUTH_MODE_SET, o as AUTH_ROUTES, p as AUTH_SESSION_PATH, q as AUTH_TWO_FACTOR_SEGMENT, r as AUTH_VIEW_BY_SEGMENT, s as AthenaAuthClientBaseUrlOptions, t as AthenaAuthUpstreamEnv, u as AthenaAuthUpstreamEnvKey, v as AthenaRequestHeaderOverrideFields, w as AthenaRequestHeaderProfile, x as AuthMode, y as AuthModeRedirects, z as AuthRoutes, B as AuthView, C as BuildAthenaRequestHeadersInput, D as ClearAuthCookiesOptions, E as DEFAULT_ATHENA_AUTH_ORIGIN, F as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, G as DISABLE_COOKIE_CACHE_QUERY_PARAM, H as DISABLE_COOKIE_CACHE_QUERY_VALUE, I as EnvLike, L as LOCAL_DEV_ORIGIN, a4 as ResolvedRequestHeaderOverrides, S as SESSION_DATA_HEADER, a5 as applyAthenaApiKeyHeaders, a6 as applyAthenaAuthContextHeaders, a7 as applyAthenaPgUriHeaders, J as asNonEmptyString, K as asString, M as buildAthenaGatewayHeaders, N as buildAthenaRequestHeaders, a8 as buildServiceRequestHeaders, O as clearAuthCookies, P as createAuthModeRedirects, Q as createAuthRoutes, R as createFreshSessionLookupUrl, a9 as hasHeaderIgnoreCase, T as isAbsoluteUrl, U as isAuthMode, V as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, X as readTrimmedString, Y as resolveAthenaAuthClientBaseUrl, Z as resolveAthenaAuthRequestUrl, _ as resolveAthenaAuthUpstreamUrl, $ as resolveAuthModeRedirect, a0 as resolveAuthViewFromSegment, a1 as resolveEmailVerificationCallbackUrl, aa as resolveHeaderValue, ab as resolveRequestHeaderOverrides, a2 as shouldRedirectAuthenticatedAuthMode, a3 as shouldRedirectAuthenticatedAuthView } from '../athena-request-headers-DujFFyMU.cjs';
+export { G as GetOriginFromHeadersOptions, g as getOriginFromHeaders, i as isDynamicServerUsageError, p as proxyRequestHeaders, r as readEnv, a as requireEnv } from '../proxy-request-headers-DGxdoyA0.cjs';
+export { ActiveOrganizationSessionLike, EnsureActiveOrganizationOptions, EnsureActiveOrganizationResult, OrganizationLike, ensureActiveOrganization } from '../organization.cjs';
 import '../types-Bltx6iL6.cjs';
-import '../types-kO_Ut5wU.cjs';
-import '../module-8dSMcy0K.cjs';
+import '../module-C_ab-MM1.cjs';
 
 /**
  * Handle bridge `POST` — set an httpOnly session cookie from JSON body.
@@ -109,5 +112,37 @@ interface AthenaResolvedServerContext {
     organizationId: string | null;
 }
 declare function resolveAthenaServerContext(options?: AthenaServerContextOptions): Promise<AthenaResolvedServerContext>;
+type AthenaBaseServerOptions = AthenaServerRequestOptions & {
+    session?: AthenaAuthSessionResponse | null;
+};
+/**
+ * Explicit server config: require url + key at the call site.
+ */
+type AthenaExplicitServerConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaBaseServerOptions & AthenaClientConfig<TModels> & {
+    url: string;
+    key: string;
+};
+/**
+ * Environment server config: require an explicit env object (no silent global process.env).
+ */
+type AthenaEnvironmentServerConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaBaseServerOptions & Omit<AthenaClientConfig<TModels>, 'url' | 'key'> & {
+    env: Record<string, string | undefined>;
+};
+/**
+ * Flat Next server client options: client config fields + request context options.
+ * Requires either `{ url, key }` or `{ env }`.
+ */
+type AthenaServerClientConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaExplicitServerConfig<TModels> | AthenaEnvironmentServerConfig<TModels>;
+/**
+ * Request-scoped Next server façade over {@link createClient}.
+ *
+ * Resolves cookies, bearer tokens, optional session identity, and cache policy
+ * on every invocation, merges with any application-level context, then
+ * materializes the client through the singular `createClient` primitive.
+ *
+ * Does not cache clients. Call once per Server Component / Server Action /
+ * Route Handler request (or pass explicit requestHeaders/requestCookies).
+ */
+declare function createAthenaServerClient<const TModels extends AthenaClientModelsInput | undefined = undefined>(options: AthenaServerClientConfig<TModels>): Promise<AthenaClient<TModels>>;
 
-export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaRequestCookiesBag, type AthenaRequestCookiesInput, type AthenaRequestHeadersBag, type AthenaRequestHeadersInput, type AthenaResolvedServerContext, type AthenaServerContextOptions, type AthenaServerRequestOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext, resolveNextRequestContext };
+export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaEnvironmentServerConfig, type AthenaExplicitServerConfig, type AthenaRequestCookiesBag, type AthenaRequestCookiesInput, type AthenaRequestHeadersBag, type AthenaRequestHeadersInput, type AthenaResolvedServerContext, type AthenaServerClientConfig, type AthenaServerContextOptions, type AthenaServerRequestOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, createAthenaServerClient, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext, resolveNextRequestContext };

package/dist/next/server.d.ts

@@ -1,11 +1,14 @@
 import { ad as AthenaAuthSessionResponse } from '../types-AOY-GLu8.js';
-import { ay as AthenaRequestContext } from '../v3-client-CuCNy-JJ.js';
+import { r as AthenaClientModelsInput } from '../types-B75PdABb.js';
+import { ax as AthenaRequestContext, ah as AthenaClientConfig, ag as AthenaClient } from '../v3-client-DZp2NEhK.js';
 import { g as AthenaAuthSessionBridgeOptions, h as AthenaAuthSessionBridgePathOptions } from '../payload-DWI1rw-e.js';
 export { A as ATHENA_AUTH_SESSION_BRIDGE_ROUTE, a as ATHENA_AUTH_SESSION_COOKIE_NAME, b as ATHENA_AUTH_SESSION_COOKIE_NAMES, c as AthenaAuthSessionBridgeClientOptions, d as AthenaAuthSessionBridgePayload, e as AthenaAuthSessionBridgeSource, f as clearAthenaAuthSessionOnAppHost, p as persistAthenaAuthSessionOnAppHost, r as resolveSessionBridgePayload } from '../payload-DWI1rw-e.js';
 export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from '../session-cookie-detection-BqOp9mO6.js';
+export { A as ATHENA_AUTH_COOKIE_PREFIXES, a as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, b as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, c as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, d as ATHENA_AUTH_GET_SESSION_PATH, e as ATHENA_AUTH_PATH, f as ATHENA_AUTH_UPSTREAM_ENV_KEYS, g as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, h as ATHENA_AUTH_VERIFY_EMAIL_PATH, i as ATHENA_SESSION_DATA_HEADER, j as AUTHENTICATED_REDIRECT_MODE_SET, k as AUTHENTICATED_REDIRECT_VIEW_SET, l as AUTH_DEFAULT_VIEW, m as AUTH_MODE_REDIRECTS, n as AUTH_MODE_SET, o as AUTH_ROUTES, p as AUTH_SESSION_PATH, q as AUTH_TWO_FACTOR_SEGMENT, r as AUTH_VIEW_BY_SEGMENT, s as AthenaAuthClientBaseUrlOptions, t as AthenaAuthUpstreamEnv, u as AthenaAuthUpstreamEnvKey, v as AthenaRequestHeaderOverrideFields, w as AthenaRequestHeaderProfile, x as AuthMode, y as AuthModeRedirects, z as AuthRoutes, B as AuthView, C as BuildAthenaRequestHeadersInput, D as ClearAuthCookiesOptions, E as DEFAULT_ATHENA_AUTH_ORIGIN, F as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, G as DISABLE_COOKIE_CACHE_QUERY_PARAM, H as DISABLE_COOKIE_CACHE_QUERY_VALUE, I as EnvLike, L as LOCAL_DEV_ORIGIN, a4 as ResolvedRequestHeaderOverrides, S as SESSION_DATA_HEADER, a5 as applyAthenaApiKeyHeaders, a6 as applyAthenaAuthContextHeaders, a7 as applyAthenaPgUriHeaders, J as asNonEmptyString, K as asString, M as buildAthenaGatewayHeaders, N as buildAthenaRequestHeaders, a8 as buildServiceRequestHeaders, O as clearAuthCookies, P as createAuthModeRedirects, Q as createAuthRoutes, R as createFreshSessionLookupUrl, a9 as hasHeaderIgnoreCase, T as isAbsoluteUrl, U as isAuthMode, V as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, X as readTrimmedString, Y as resolveAthenaAuthClientBaseUrl, Z as resolveAthenaAuthRequestUrl, _ as resolveAthenaAuthUpstreamUrl, $ as resolveAuthModeRedirect, a0 as resolveAuthViewFromSegment, a1 as resolveEmailVerificationCallbackUrl, aa as resolveHeaderValue, ab as resolveRequestHeaderOverrides, a2 as shouldRedirectAuthenticatedAuthMode, a3 as shouldRedirectAuthenticatedAuthView } from '../athena-request-headers-C7Jy-c_D.js';
+export { G as GetOriginFromHeadersOptions, g as getOriginFromHeaders, i as isDynamicServerUsageError, p as proxyRequestHeaders, r as readEnv, a as requireEnv } from '../proxy-request-headers-m4D2Tduy.js';
+export { ActiveOrganizationSessionLike, EnsureActiveOrganizationOptions, EnsureActiveOrganizationResult, OrganizationLike, ensureActiveOrganization } from '../organization.js';
 import '../types-Bltx6iL6.js';
-import '../types-jClgDy1J.js';
-import '../module-8dSMcy0K.js';
+import '../module-C_ab-MM1.js';
 
 /**
  * Handle bridge `POST` — set an httpOnly session cookie from JSON body.
@@ -109,5 +112,37 @@ interface AthenaResolvedServerContext {
     organizationId: string | null;
 }
 declare function resolveAthenaServerContext(options?: AthenaServerContextOptions): Promise<AthenaResolvedServerContext>;
+type AthenaBaseServerOptions = AthenaServerRequestOptions & {
+    session?: AthenaAuthSessionResponse | null;
+};
+/**
+ * Explicit server config: require url + key at the call site.
+ */
+type AthenaExplicitServerConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaBaseServerOptions & AthenaClientConfig<TModels> & {
+    url: string;
+    key: string;
+};
+/**
+ * Environment server config: require an explicit env object (no silent global process.env).
+ */
+type AthenaEnvironmentServerConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaBaseServerOptions & Omit<AthenaClientConfig<TModels>, 'url' | 'key'> & {
+    env: Record<string, string | undefined>;
+};
+/**
+ * Flat Next server client options: client config fields + request context options.
+ * Requires either `{ url, key }` or `{ env }`.
+ */
+type AthenaServerClientConfig<TModels extends AthenaClientModelsInput | undefined = undefined> = AthenaExplicitServerConfig<TModels> | AthenaEnvironmentServerConfig<TModels>;
+/**
+ * Request-scoped Next server façade over {@link createClient}.
+ *
+ * Resolves cookies, bearer tokens, optional session identity, and cache policy
+ * on every invocation, merges with any application-level context, then
+ * materializes the client through the singular `createClient` primitive.
+ *
+ * Does not cache clients. Call once per Server Component / Server Action /
+ * Route Handler request (or pass explicit requestHeaders/requestCookies).
+ */
+declare function createAthenaServerClient<const TModels extends AthenaClientModelsInput | undefined = undefined>(options: AthenaServerClientConfig<TModels>): Promise<AthenaClient<TModels>>;
 
-export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaRequestCookiesBag, type AthenaRequestCookiesInput, type AthenaRequestHeadersBag, type AthenaRequestHeadersInput, type AthenaResolvedServerContext, type AthenaServerContextOptions, type AthenaServerRequestOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext, resolveNextRequestContext };
+export { AthenaAuthSessionBridgeOptions, AthenaAuthSessionBridgePathOptions, type AthenaEnvironmentServerConfig, type AthenaExplicitServerConfig, type AthenaRequestCookiesBag, type AthenaRequestCookiesInput, type AthenaRequestHeadersBag, type AthenaRequestHeadersInput, type AthenaResolvedServerContext, type AthenaServerClientConfig, type AthenaServerContextOptions, type AthenaServerRequestOptions, createAthenaAuthSessionBridgeHandlers, createAthenaAuthSessionBridgePathHandlers, createAthenaServerClient, handleAthenaAuthSessionBridgeDelete, handleAthenaAuthSessionBridgePost, isAthenaAuthSessionBridgePath, resolveAthenaServerContext, resolveNextRequestContext };