@xylex-group/athena 2.12.1 → 2.13.0

package/dist/organization.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+// src/organization/ensure-active-organization.ts
+function normalizeOrganizationId(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function defaultSelectOrganizationId(organizations) {
+  for (const organization of organizations) {
+    const id = normalizeOrganizationId(organization.id);
+    if (id) {
+      return id;
+    }
+  }
+  return null;
+}
+async function ensureActiveOrganization(options) {
+  const currentActiveOrganizationId = normalizeOrganizationId(
+    options.session?.session?.activeOrganizationId
+  );
+  if (currentActiveOrganizationId) {
+    return {
+      activeOrganizationId: currentActiveOrganizationId,
+      didSetActiveOrganization: false
+    };
+  }
+  let organizations;
+  try {
+    organizations = await options.listOrganizations();
+  } catch (error) {
+    options.onError?.(error);
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  if (organizations.length === 0) {
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  const selectedOrganizationId = normalizeOrganizationId(
+    (options.selectOrganizationId ?? defaultSelectOrganizationId)(organizations)
+  );
+  if (!selectedOrganizationId) {
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  try {
+    await options.setActiveOrganization(selectedOrganizationId);
+    return {
+      activeOrganizationId: selectedOrganizationId,
+      didSetActiveOrganization: true
+    };
+  } catch (error) {
+    options.onError?.(error);
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+}
+
+exports.ensureActiveOrganization = ensureActiveOrganization;
+//# sourceMappingURL=organization.cjs.map
+//# sourceMappingURL=organization.cjs.map

package/dist/organization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization/ensure-active-organization.ts"],"names":[],"mappings":";;;AAqCA,SAAS,wBAAwB,KAAA,EAAiD;AAChF,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,MAAM,IAAA,EAAK;AAC9B,EAAA,OAAO,UAAA,CAAW,MAAA,GAAS,CAAA,GAAI,UAAA,GAAa,IAAA;AAC9C;AAEA,SAAS,4BACP,aAAA,EACe;AACf,EAAA,KAAA,MAAW,gBAAgB,aAAA,EAAe;AACxC,IAAA,MAAM,EAAA,GAAK,uBAAA,CAAwB,YAAA,CAAa,EAAE,CAAA;AAClD,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,OAAO,EAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAUA,eAAsB,yBACpB,OAAA,EACyC;AACzC,EAAA,MAAM,2BAAA,GAA8B,uBAAA;AAAA,IAClC,OAAA,CAAQ,SAAS,OAAA,EAAS;AAAA,GAC5B;AAEA,EAAA,IAAI,2BAAA,EAA6B;AAC/B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,2BAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI,aAAA;AACJ,EAAA,IAAI;AACF,IAAA,aAAA,GAAgB,MAAM,QAAQ,iBAAA,EAAkB;AAAA,EAClD,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,UAAU,KAAK,CAAA;AACvB,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI,aAAA,CAAc,WAAW,CAAA,EAAG;AAC9B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,MAAM,sBAAA,GAAyB,uBAAA;AAAA,IAAA,CAC5B,OAAA,CAAQ,oBAAA,IAAwB,2BAAA,EAA6B,aAAa;AAAA,GAC7E;AAEA,EAAA,IAAI,CAAC,sBAAA,EAAwB;AAC3B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,CAAQ,sBAAsB,sBAAsB,CAAA;AAC1D,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,sBAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,UAAU,KAAK,CAAA;AACvB,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AACF","file":"organization.cjs","sourcesContent":["/**\n * Framework-agnostic active-organization bootstrap.\n *\n * Promoted from consumer apps (e.g. speedrun-formations) so product code only\n * supplies list/set-active + optional org selection policy.\n *\n * Does not call Athena Auth routes itself — inject your client's\n * `auth.organization.list` / `setActive` (or any compatible functions).\n */\n\nexport interface ActiveOrganizationSessionLike {\n  session?: {\n    activeOrganizationId?: string | null\n  } | null\n}\n\nexport interface OrganizationLike {\n  id: string\n}\n\nexport interface EnsureActiveOrganizationOptions<TOrganization extends OrganizationLike> {\n  listOrganizations: () => Promise<readonly TOrganization[]>\n  onError?: (error: unknown) => void\n  /**\n   * Choose which org to activate when the session has none.\n   * Default: first organization with a non-empty `id`.\n   */\n  selectOrganizationId?: (organizations: readonly TOrganization[]) => string | null\n  session: ActiveOrganizationSessionLike | null | undefined\n  setActiveOrganization: (organizationId: string) => Promise<unknown>\n}\n\nexport interface EnsureActiveOrganizationResult {\n  activeOrganizationId: string | null\n  didSetActiveOrganization: boolean\n}\n\nfunction normalizeOrganizationId(value: string | null | undefined): string | null {\n  if (typeof value !== 'string') {\n    return null\n  }\n  const normalized = value.trim()\n  return normalized.length > 0 ? normalized : null\n}\n\nfunction defaultSelectOrganizationId<TOrganization extends OrganizationLike>(\n  organizations: readonly TOrganization[],\n): string | null {\n  for (const organization of organizations) {\n    const id = normalizeOrganizationId(organization.id)\n    if (id) {\n      return id\n    }\n  }\n  return null\n}\n\n/**\n * Ensure the session has an active organization when memberships exist.\n *\n * - If `session.session.activeOrganizationId` is already set → return it (no network).\n * - Else list organizations; if empty → `{ activeOrganizationId: null, didSetActiveOrganization: false }`.\n * - Else select an id (custom or first) and call `setActiveOrganization`.\n * - List/set failures invoke `onError` and return unset (never throw).\n */\nexport async function ensureActiveOrganization<TOrganization extends OrganizationLike>(\n  options: EnsureActiveOrganizationOptions<TOrganization>,\n): Promise<EnsureActiveOrganizationResult> {\n  const currentActiveOrganizationId = normalizeOrganizationId(\n    options.session?.session?.activeOrganizationId,\n  )\n\n  if (currentActiveOrganizationId) {\n    return {\n      activeOrganizationId: currentActiveOrganizationId,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  let organizations: readonly TOrganization[]\n  try {\n    organizations = await options.listOrganizations()\n  } catch (error) {\n    options.onError?.(error)\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  if (organizations.length === 0) {\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  const selectedOrganizationId = normalizeOrganizationId(\n    (options.selectOrganizationId ?? defaultSelectOrganizationId)(organizations),\n  )\n\n  if (!selectedOrganizationId) {\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  try {\n    await options.setActiveOrganization(selectedOrganizationId)\n    return {\n      activeOrganizationId: selectedOrganizationId,\n      didSetActiveOrganization: true,\n    }\n  } catch (error) {\n    options.onError?.(error)\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n}\n"]}

package/dist/organization.d.cts

@@ -0,0 +1,43 @@
+/**
+ * Framework-agnostic active-organization bootstrap.
+ *
+ * Promoted from consumer apps (e.g. speedrun-formations) so product code only
+ * supplies list/set-active + optional org selection policy.
+ *
+ * Does not call Athena Auth routes itself — inject your client's
+ * `auth.organization.list` / `setActive` (or any compatible functions).
+ */
+interface ActiveOrganizationSessionLike {
+    session?: {
+        activeOrganizationId?: string | null;
+    } | null;
+}
+interface OrganizationLike {
+    id: string;
+}
+interface EnsureActiveOrganizationOptions<TOrganization extends OrganizationLike> {
+    listOrganizations: () => Promise<readonly TOrganization[]>;
+    onError?: (error: unknown) => void;
+    /**
+     * Choose which org to activate when the session has none.
+     * Default: first organization with a non-empty `id`.
+     */
+    selectOrganizationId?: (organizations: readonly TOrganization[]) => string | null;
+    session: ActiveOrganizationSessionLike | null | undefined;
+    setActiveOrganization: (organizationId: string) => Promise<unknown>;
+}
+interface EnsureActiveOrganizationResult {
+    activeOrganizationId: string | null;
+    didSetActiveOrganization: boolean;
+}
+/**
+ * Ensure the session has an active organization when memberships exist.
+ *
+ * - If `session.session.activeOrganizationId` is already set → return it (no network).
+ * - Else list organizations; if empty → `{ activeOrganizationId: null, didSetActiveOrganization: false }`.
+ * - Else select an id (custom or first) and call `setActiveOrganization`.
+ * - List/set failures invoke `onError` and return unset (never throw).
+ */
+declare function ensureActiveOrganization<TOrganization extends OrganizationLike>(options: EnsureActiveOrganizationOptions<TOrganization>): Promise<EnsureActiveOrganizationResult>;
+
+export { type ActiveOrganizationSessionLike, type EnsureActiveOrganizationOptions, type EnsureActiveOrganizationResult, type OrganizationLike, ensureActiveOrganization };

package/dist/organization.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Framework-agnostic active-organization bootstrap.
+ *
+ * Promoted from consumer apps (e.g. speedrun-formations) so product code only
+ * supplies list/set-active + optional org selection policy.
+ *
+ * Does not call Athena Auth routes itself — inject your client's
+ * `auth.organization.list` / `setActive` (or any compatible functions).
+ */
+interface ActiveOrganizationSessionLike {
+    session?: {
+        activeOrganizationId?: string | null;
+    } | null;
+}
+interface OrganizationLike {
+    id: string;
+}
+interface EnsureActiveOrganizationOptions<TOrganization extends OrganizationLike> {
+    listOrganizations: () => Promise<readonly TOrganization[]>;
+    onError?: (error: unknown) => void;
+    /**
+     * Choose which org to activate when the session has none.
+     * Default: first organization with a non-empty `id`.
+     */
+    selectOrganizationId?: (organizations: readonly TOrganization[]) => string | null;
+    session: ActiveOrganizationSessionLike | null | undefined;
+    setActiveOrganization: (organizationId: string) => Promise<unknown>;
+}
+interface EnsureActiveOrganizationResult {
+    activeOrganizationId: string | null;
+    didSetActiveOrganization: boolean;
+}
+/**
+ * Ensure the session has an active organization when memberships exist.
+ *
+ * - If `session.session.activeOrganizationId` is already set → return it (no network).
+ * - Else list organizations; if empty → `{ activeOrganizationId: null, didSetActiveOrganization: false }`.
+ * - Else select an id (custom or first) and call `setActiveOrganization`.
+ * - List/set failures invoke `onError` and return unset (never throw).
+ */
+declare function ensureActiveOrganization<TOrganization extends OrganizationLike>(options: EnsureActiveOrganizationOptions<TOrganization>): Promise<EnsureActiveOrganizationResult>;
+
+export { type ActiveOrganizationSessionLike, type EnsureActiveOrganizationOptions, type EnsureActiveOrganizationResult, type OrganizationLike, ensureActiveOrganization };

package/dist/organization.js

@@ -0,0 +1,70 @@
+// src/organization/ensure-active-organization.ts
+function normalizeOrganizationId(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function defaultSelectOrganizationId(organizations) {
+  for (const organization of organizations) {
+    const id = normalizeOrganizationId(organization.id);
+    if (id) {
+      return id;
+    }
+  }
+  return null;
+}
+async function ensureActiveOrganization(options) {
+  const currentActiveOrganizationId = normalizeOrganizationId(
+    options.session?.session?.activeOrganizationId
+  );
+  if (currentActiveOrganizationId) {
+    return {
+      activeOrganizationId: currentActiveOrganizationId,
+      didSetActiveOrganization: false
+    };
+  }
+  let organizations;
+  try {
+    organizations = await options.listOrganizations();
+  } catch (error) {
+    options.onError?.(error);
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  if (organizations.length === 0) {
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  const selectedOrganizationId = normalizeOrganizationId(
+    (options.selectOrganizationId ?? defaultSelectOrganizationId)(organizations)
+  );
+  if (!selectedOrganizationId) {
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+  try {
+    await options.setActiveOrganization(selectedOrganizationId);
+    return {
+      activeOrganizationId: selectedOrganizationId,
+      didSetActiveOrganization: true
+    };
+  } catch (error) {
+    options.onError?.(error);
+    return {
+      activeOrganizationId: null,
+      didSetActiveOrganization: false
+    };
+  }
+}
+
+export { ensureActiveOrganization };
+//# sourceMappingURL=organization.js.map
+//# sourceMappingURL=organization.js.map

package/dist/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization/ensure-active-organization.ts"],"names":[],"mappings":";AAqCA,SAAS,wBAAwB,KAAA,EAAiD;AAChF,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAA,GAAa,MAAM,IAAA,EAAK;AAC9B,EAAA,OAAO,UAAA,CAAW,MAAA,GAAS,CAAA,GAAI,UAAA,GAAa,IAAA;AAC9C;AAEA,SAAS,4BACP,aAAA,EACe;AACf,EAAA,KAAA,MAAW,gBAAgB,aAAA,EAAe;AACxC,IAAA,MAAM,EAAA,GAAK,uBAAA,CAAwB,YAAA,CAAa,EAAE,CAAA;AAClD,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,OAAO,EAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAUA,eAAsB,yBACpB,OAAA,EACyC;AACzC,EAAA,MAAM,2BAAA,GAA8B,uBAAA;AAAA,IAClC,OAAA,CAAQ,SAAS,OAAA,EAAS;AAAA,GAC5B;AAEA,EAAA,IAAI,2BAAA,EAA6B;AAC/B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,2BAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI,aAAA;AACJ,EAAA,IAAI;AACF,IAAA,aAAA,GAAgB,MAAM,QAAQ,iBAAA,EAAkB;AAAA,EAClD,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,UAAU,KAAK,CAAA;AACvB,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI,aAAA,CAAc,WAAW,CAAA,EAAG;AAC9B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,MAAM,sBAAA,GAAyB,uBAAA;AAAA,IAAA,CAC5B,OAAA,CAAQ,oBAAA,IAAwB,2BAAA,EAA6B,aAAa;AAAA,GAC7E;AAEA,EAAA,IAAI,CAAC,sBAAA,EAAwB;AAC3B,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,CAAQ,sBAAsB,sBAAsB,CAAA;AAC1D,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,sBAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,UAAU,KAAK,CAAA;AACvB,IAAA,OAAO;AAAA,MACL,oBAAA,EAAsB,IAAA;AAAA,MACtB,wBAAA,EAA0B;AAAA,KAC5B;AAAA,EACF;AACF","file":"organization.js","sourcesContent":["/**\n * Framework-agnostic active-organization bootstrap.\n *\n * Promoted from consumer apps (e.g. speedrun-formations) so product code only\n * supplies list/set-active + optional org selection policy.\n *\n * Does not call Athena Auth routes itself — inject your client's\n * `auth.organization.list` / `setActive` (or any compatible functions).\n */\n\nexport interface ActiveOrganizationSessionLike {\n  session?: {\n    activeOrganizationId?: string | null\n  } | null\n}\n\nexport interface OrganizationLike {\n  id: string\n}\n\nexport interface EnsureActiveOrganizationOptions<TOrganization extends OrganizationLike> {\n  listOrganizations: () => Promise<readonly TOrganization[]>\n  onError?: (error: unknown) => void\n  /**\n   * Choose which org to activate when the session has none.\n   * Default: first organization with a non-empty `id`.\n   */\n  selectOrganizationId?: (organizations: readonly TOrganization[]) => string | null\n  session: ActiveOrganizationSessionLike | null | undefined\n  setActiveOrganization: (organizationId: string) => Promise<unknown>\n}\n\nexport interface EnsureActiveOrganizationResult {\n  activeOrganizationId: string | null\n  didSetActiveOrganization: boolean\n}\n\nfunction normalizeOrganizationId(value: string | null | undefined): string | null {\n  if (typeof value !== 'string') {\n    return null\n  }\n  const normalized = value.trim()\n  return normalized.length > 0 ? normalized : null\n}\n\nfunction defaultSelectOrganizationId<TOrganization extends OrganizationLike>(\n  organizations: readonly TOrganization[],\n): string | null {\n  for (const organization of organizations) {\n    const id = normalizeOrganizationId(organization.id)\n    if (id) {\n      return id\n    }\n  }\n  return null\n}\n\n/**\n * Ensure the session has an active organization when memberships exist.\n *\n * - If `session.session.activeOrganizationId` is already set → return it (no network).\n * - Else list organizations; if empty → `{ activeOrganizationId: null, didSetActiveOrganization: false }`.\n * - Else select an id (custom or first) and call `setActiveOrganization`.\n * - List/set failures invoke `onError` and return unset (never throw).\n */\nexport async function ensureActiveOrganization<TOrganization extends OrganizationLike>(\n  options: EnsureActiveOrganizationOptions<TOrganization>,\n): Promise<EnsureActiveOrganizationResult> {\n  const currentActiveOrganizationId = normalizeOrganizationId(\n    options.session?.session?.activeOrganizationId,\n  )\n\n  if (currentActiveOrganizationId) {\n    return {\n      activeOrganizationId: currentActiveOrganizationId,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  let organizations: readonly TOrganization[]\n  try {\n    organizations = await options.listOrganizations()\n  } catch (error) {\n    options.onError?.(error)\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  if (organizations.length === 0) {\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  const selectedOrganizationId = normalizeOrganizationId(\n    (options.selectOrganizationId ?? defaultSelectOrganizationId)(organizations),\n  )\n\n  if (!selectedOrganizationId) {\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n\n  try {\n    await options.setActiveOrganization(selectedOrganizationId)\n    return {\n      activeOrganizationId: selectedOrganizationId,\n      didSetActiveOrganization: true,\n    }\n  } catch (error) {\n    options.onError?.(error)\n    return {\n      activeOrganizationId: null,\n      didSetActiveOrganization: false,\n    }\n  }\n}\n"]}

package/dist/payload-BzVbUgY_.d.cts

@@ -0,0 +1,219 @@
+import { an as AthenaCreateClientAuthOptions, af as AthenaClientExperimentalOptions, aI as AthenaHeaderBag } from './client-BJjUwDSg.cjs';
+import { o as BackendConfig, p as BackendType } from './types-CH78O90i.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.
+ *
+ * Mount as `app/api/athena-auth/session/route.ts`, or configure another path
+ * such as `/api/auth/session` when using catch-all handlers.
+ *
+ * @see {@link createAthenaAuthSessionBridgeHandlers}
+ * @see {@link createAthenaAuthSessionBridgePathHandlers}
+ */
+declare const ATHENA_AUTH_SESSION_BRIDGE_ROUTE = "/api/athena-auth/session";
+/**
+ * Primary host-app session cookie written by the bridge.
+ *
+ * Hyphen form (`session-token`) matches Athena Auth UI and several consumer
+ * apps. Underscore form is also cleared on DELETE for cookie-helper parity.
+ *
+ * @see {@link ATHENA_AUTH_SESSION_COOKIE_NAMES}
+ */
+declare const ATHENA_AUTH_SESSION_COOKIE_NAME = "athena-auth.session-token";
+/**
+ * Cookie names cleared on logout / bridge `DELETE`.
+ *
+ * Includes both hyphen and underscore variants so bridge clear stays aligned
+ * with `@xylex-group/athena/cookies` session token lookup.
+ */
+declare const ATHENA_AUTH_SESSION_COOKIE_NAMES: readonly ["athena-auth.session-token", "athena-auth.session_token"];
+
+/**
+ * Minimal session shape accepted when deriving a bridge payload from
+ * `auth.getSession()`-style responses.
+ *
+ * Either nested `session.token` or a top-level `token` may be present depending
+ * on the Athena Auth response envelope version.
+ */
+interface AthenaAuthSessionBridgeSource {
+    session?: {
+        /** ISO-8601 expiry when provided by the auth server. */
+        expiresAt?: string | null;
+        /** Opaque session token string. */
+        token?: string | null;
+    } | null;
+    /** Some clients surface the token at the envelope root. */
+    token?: string | null;
+}
+/**
+ * Body accepted by the session bridge `POST` handler and by
+ * {@link persistAthenaAuthSessionOnAppHost}.
+ */
+interface AthenaAuthSessionBridgePayload {
+    /** Non-empty session token to store in the app-host httpOnly cookie. */
+    token: string;
+    /**
+     * Optional cookie `Expires` value (ISO-8601 string).
+     * When omitted, the cookie is a session cookie (browser-lifetime).
+     */
+    expiresAt?: string | undefined;
+}
+/**
+ * Configuration for bridge route handlers and cookie attributes.
+ *
+ * All fields are optional; defaults match speedrun-formations /
+ * Athena Auth UI conventions.
+ */
+interface AthenaAuthSessionBridgeOptions {
+    /**
+     * Route reported in JSON responses and used by client helpers when not
+     * overridden.
+     *
+     * @defaultValue `/api/athena-auth/session`
+     */
+    route?: string | undefined;
+    /**
+     * Cookie name written on successful `POST`.
+     *
+     * @defaultValue `athena-auth.session-token`
+     */
+    cookieName?: string | undefined;
+    /**
+     * Cookie names cleared on `DELETE` (aliases).
+     *
+     * @defaultValue hyphen + underscore session token names
+     */
+    cookieNames?: readonly string[] | undefined;
+    /**
+     * Path attribute for the session cookie.
+     *
+     * @defaultValue `/`
+     */
+    cookiePath?: string | undefined;
+    /**
+     * Cookie SameSite attribute.
+     *
+     * @defaultValue `lax`
+     */
+    sameSite?: 'lax' | 'strict' | 'none' | undefined;
+    /**
+     * Force the `Secure` flag. When omitted, the handlers derive Secure from the
+     * request URL scheme and `x-forwarded-proto`.
+     */
+    secure?: boolean | undefined;
+}
+/**
+ * Options for catch-all / dynamic-segment handlers under `/api/auth/*`.
+ *
+ * Extends {@link AthenaAuthSessionBridgeOptions} with path matching.
+ */
+interface AthenaAuthSessionBridgePathOptions extends AthenaAuthSessionBridgeOptions {
+    /**
+     * Pathname suffixes (final URL segments) that activate the bridge.
+     *
+     * @defaultValue `['session']` — covers `/api/auth/session` and
+     * `/api/athena-auth/session`
+     */
+    matchPaths?: readonly string[] | undefined;
+}
+
+/**
+ * Options for browser-side bridge fetch helpers.
+ */
+interface AthenaAuthSessionBridgeClientOptions {
+    /**
+     * Bridge route on the app host.
+     *
+     * @defaultValue {@link ATHENA_AUTH_SESSION_BRIDGE_ROUTE}
+     */
+    route?: string | undefined;
+    /**
+     * Optional fetch implementation (defaults to global `fetch`).
+     * Useful in tests.
+     */
+    fetch?: typeof fetch | undefined;
+}
+/**
+ * Persist an Athena Auth session token on the app host via the bridge `POST` route.
+ *
+ * Sends a same-origin JSON POST with `credentials: "same-origin"`. No-ops when
+ * `payload` is null/undefined or when not running in a browser.
+ *
+ * @param payload - Token (+ optional expiry) from {@link resolveSessionBridgePayload}
+ * @param options - Route override and fetch implementation
+ * @throws {Error} When the bridge responds with a non-OK status
+ *
+ * @example
+ * ```ts
+ * await persistAthenaAuthSessionOnAppHost({
+ *   token: session.session.token,
+ *   expiresAt: session.session.expiresAt,
+ * })
+ * ```
+ */
+declare function persistAthenaAuthSessionOnAppHost(payload: AthenaAuthSessionBridgePayload | null, options?: AthenaAuthSessionBridgeClientOptions): Promise<void>;
+/**
+ * Clear the bridged session cookie on the app host via `DELETE`.
+ *
+ * No-ops outside the browser. Pair with `auth.signOut()` so the app-host
+ * cookie does not outlive the auth session.
+ *
+ * @param options - Route override and fetch implementation
+ * @throws {Error} When the bridge responds with a non-OK status
+ */
+declare function clearAthenaAuthSessionOnAppHost(options?: AthenaAuthSessionBridgeClientOptions): Promise<void>;
+
+/**
+ * Extract a bridge payload from a session response envelope.
+ *
+ * Preference order for the token:
+ * 1. `payload.session.token`
+ * 2. `payload.token`
+ *
+ * Returns `null` when no non-empty token string is available after trim.
+ *
+ * @param payload - Result of `auth.getSession()` data or a compatible object
+ * @returns Payload suitable for bridge `POST`, or `null`
+ *
+ * @example
+ * ```ts
+ * const { data, ok } = await client.auth.getSession()
+ * if (ok) {
+ *   await persistAthenaAuthSessionOnAppHost(resolveSessionBridgePayload(data))
+ * }
+ * ```
+ */
+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 };