@xylex-group/athena 3.0.0 → 3.0.2

package/README.md

@@ -1,6 +1,6 @@
 # @xylex-group/athena
 
-current version: `3.0.0`
+current version: `3.0.2`
 Athena JS 3 is the runtime-neutral TypeScript SDK for Athena database, authentication, chat, and storage services.
 
 ## Install
@@ -30,6 +30,7 @@ athena.db
 athena.auth
 athena.chat
 athena.storage
+athena.billing
 ```
 
 The root retains common database shortcuts:
@@ -132,26 +133,39 @@ Header precedence is client headers, configured context, `withContext`, then ope
 
 ## Next.js
 
-```ts
-import { createClient } from '@xylex-group/athena'
-import { resolveNextRequestContext } from '@xylex-group/athena/next/server'
+Thin façades on `@xylex-group/athena/next/client` and `.../next/server` adapt
+browser-safe config or request context, then call `createClient`. Full guide:
+[docs/next-js.md](./docs/next-js.md).
 
-export const athena = createClient({ env: process.env })
+```ts
+// Client Components
+import { createAthenaBrowserClient } from '@xylex-group/athena/next/client'
+export const athena = createAthenaBrowserClient({
+  url: process.env.NEXT_PUBLIC_ATHENA_URL!,
+  key: process.env.NEXT_PUBLIC_ATHENA_PUBLISHABLE_KEY!,
+})
 
-export async function athenaForRequest() {
-  return athena.withContext(await resolveNextRequestContext())
+// Server Components / Actions / Route Handlers
+import { createAthenaServerClient } from '@xylex-group/athena/next/server'
+export function createServerAthena() {
+  return createAthenaServerClient({
+    url: process.env.ATHENA_URL!,
+    key: process.env.ATHENA_API_KEY!,
+  })
 }
+const athena = await createServerAthena()
 ```
 
-Next subpaths provide request-context and session-bridge helpers. They do not construct clients.
-
 ## Documentation
 
+- [Docs index](./docs/index.md) — tracks for runtime, Next, auth, types, generator
 - [Getting started](./docs/getting-started.md)
+- [Next.js integration](./docs/next-js.md)
 - [API reference](./docs/api-reference.md)
 - [Complete generated method reference](./docs/complete-method-reference.md)
 - [Typed schema registry](./docs/typed-schema-registry.md)
 - [v2.16.0 to v3.0.0 migration](./docs/migration-v2-to-v3.md)
 - [Client internal architecture](./docs/client-internal-architecture.md)
-- [Accepted ADR catalog](./docs/adr/README.md)
+- [Site dual-publish (package → apps/docs)](./docs/site-publish.md)
+- [Accepted ADR catalog](./docs/adr/README.md) (includes [ADR 0014](./docs/adr/0014-next-client-construction-facades.md))
 - [3.0 release readiness](./docs/client-v3-release-readiness-report.md)

package/dist/{athena-auth-url-oLux_57a.d.cts → athena-request-headers-C7Jy-c_D.d.ts}

@@ -1,3 +1,5 @@
+import { t as BackendOption } from './types-Bltx6iL6.js';
+
 /**
  * Cookie name prefixes treated as Athena Auth / Better Auth session material.
  *
@@ -374,4 +376,86 @@ declare function resolveEmailVerificationCallbackUrl(rawBaseUrl?: string | EnvLi
  */
 declare function createFreshSessionLookupUrl(baseUrl: string | URL): URL;
 
-export { ATHENA_AUTH_COOKIE_PREFIXES as A, AUTH_SESSION_PATH as B, type ClearAuthCookiesOptions as C, DEFAULT_ATHENA_AUTH_ORIGIN as D, type EnvLike as E, AUTH_TWO_FACTOR_SEGMENT as F, type AthenaAuthClientBaseUrlOptions as G, type AthenaAuthUpstreamEnv as H, type AthenaAuthUpstreamEnvKey as I, type AuthMode as J, type AuthModeRedirects as K, type AuthRoutes as L, DEFAULT_ATHENA_AUTH_UPSTREAM_URL as M, DEFAULT_AUTH_COOKIE_PREFIXES as N, DISABLE_COOKIE_CACHE_QUERY_PARAM as O, DISABLE_COOKIE_CACHE_QUERY_VALUE as P, LOCAL_DEV_ORIGIN as Q, createAuthModeRedirects as R, SESSION_DATA_HEADER as S, createAuthRoutes as T, createFreshSessionLookupUrl as U, isAuthMode as V, readAthenaAuthUpstreamUrlFromEnv as W, resolveAuthModeRedirect as X, shouldRedirectAuthenticatedAuthMode as Y, ATHENA_AUTH_PATH as a, ATHENA_AUTH_UPSTREAM_ENV_KEYS as b, ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES as c, AUTH_DEFAULT_VIEW as d, AUTH_ROUTES as e, AUTH_VIEW_BY_SEGMENT as f, type AuthView as g, clearAuthCookies as h, isAbsoluteUrl as i, resolveAthenaAuthRequestUrl as j, resolveAthenaAuthUpstreamUrl as k, resolveAuthViewFromSegment as l, resolveEmailVerificationCallbackUrl as m, normalizeAthenaAuthBaseUrl as n, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM as o, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE as p, ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH as q, resolveAthenaAuthClientBaseUrl as r, shouldRedirectAuthenticatedAuthView as s, ATHENA_AUTH_GET_SESSION_PATH as t, ATHENA_AUTH_VERIFY_EMAIL_PATH as u, ATHENA_SESSION_DATA_HEADER as v, AUTHENTICATED_REDIRECT_MODE_SET as w, AUTHENTICATED_REDIRECT_VIEW_SET as x, AUTH_MODE_REDIRECTS as y, AUTH_MODE_SET as z };
+declare function asString(value: unknown): string | null;
+declare function asBoolean(value: unknown): boolean;
+declare function asBooleanOrNull(value: unknown): boolean | null;
+declare function asRecord(value: unknown): Record<string, unknown> | null;
+declare function asIdentifier(value: unknown): string | null;
+declare function firstString(record: Record<string, unknown> | null | undefined, keys: readonly string[]): string | null;
+declare function readTrimmedString(value: unknown): string | null;
+/**
+ * Trim a string value; return `undefined` when not a non-empty string.
+ *
+ * Unlike {@link asString}, does not coerce numbers/bigints.
+ * Unlike {@link readTrimmedString}, returns `undefined` instead of `null`
+ * (handy for optional fields and `??` defaults).
+ */
+declare function asNonEmptyString(value: unknown): string | undefined;
+declare function asNumber(value: unknown): number | null;
+declare function asStringArray(value: unknown): string[];
+
+type AthenaRequestHeaderProfile = 'gateway' | 'auth' | 'chat' | 'storage' | 'minimal';
+interface BuildAthenaRequestHeadersInput {
+    profile: AthenaRequestHeaderProfile;
+    sdkHeaderValue: string;
+    apiKey?: string | null;
+    client?: string | null;
+    userId?: string | null;
+    organizationId?: string | null;
+    backend?: BackendOption;
+    publishEvent?: string | null;
+    stripNulls?: boolean;
+    bearerToken?: string | null;
+    cookie?: string | null;
+    sessionToken?: string | null;
+    pgUri?: string | null;
+    jdbcUrl?: string | null;
+    forceNoCache?: boolean;
+    configHeaders?: Record<string, string>;
+    callHeaders?: Record<string, string>;
+    contentType?: string | null;
+    accept?: string | null;
+}
+/** Shared config/call fields consumed by gateway, chat, auth, and `client.request(...)`. */
+interface AthenaRequestHeaderOverrideFields {
+    apiKey?: string | null;
+    client?: string | null;
+    userId?: string | null;
+    organizationId?: string | null;
+    backend?: BackendOption;
+    publishEvent?: string | null;
+    stripNulls?: boolean;
+    bearerToken?: string | null;
+    cookie?: string | null;
+    sessionToken?: string | null;
+    pgUri?: string | null;
+    jdbcUrl?: string | null;
+    forceNoCache?: boolean;
+    headers?: Record<string, string>;
+}
+type ResolvedRequestHeaderOverrides = Omit<BuildAthenaRequestHeadersInput, 'profile' | 'sdkHeaderValue' | 'contentType' | 'accept'>;
+declare function hasHeaderIgnoreCase(headers: Record<string, string>, targetKey: string): boolean;
+declare function resolveHeaderValue(headers: Record<string, string>, candidates: readonly string[]): string | undefined;
+declare function resolveRequestHeaderOverrides(config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, defaults?: Pick<AthenaRequestHeaderOverrideFields, 'client' | 'stripNulls'>): ResolvedRequestHeaderOverrides;
+declare function buildServiceRequestHeaders(profile: Exclude<AthenaRequestHeaderProfile, 'minimal'>, sdkHeaderValue: string, config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, extras?: Pick<BuildAthenaRequestHeadersInput, 'contentType' | 'accept'> & {
+    client?: string | null;
+    stripNulls?: boolean;
+}): Record<string, string>;
+declare function applyAthenaApiKeyHeaders(headers: Record<string, string>, apiKey?: string | null): void;
+declare function applyAthenaAuthContextHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'bearerToken' | 'cookie' | 'sessionToken' | 'profile' | 'configHeaders' | 'callHeaders'>): void;
+declare function applyAthenaPgUriHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'pgUri' | 'jdbcUrl' | 'configHeaders' | 'callHeaders'>): void;
+/**
+ * Minimal gateway/data request headers used by many apps before they adopt
+ * the full {@link buildAthenaRequestHeaders} profile model.
+ *
+ * Additive convenience — does not replace client-built headers. Prefer
+ * `createClient({ client, key })` so the SDK sets these on every call.
+ */
+declare function buildAthenaGatewayHeaders(input: {
+    clientName?: string | null;
+    gatewayKey?: string | null;
+    headers?: Record<string, string | null | undefined>;
+}): Record<string, string>;
+declare function buildAthenaRequestHeaders(input: BuildAthenaRequestHeadersInput): Record<string, string>;
+
+export { resolveAuthModeRedirect as $, ATHENA_AUTH_COOKIE_PREFIXES as A, type AuthView as B, type BuildAthenaRequestHeadersInput as C, type ClearAuthCookiesOptions as D, DEFAULT_ATHENA_AUTH_ORIGIN as E, DEFAULT_ATHENA_AUTH_UPSTREAM_URL as F, DISABLE_COOKIE_CACHE_QUERY_PARAM as G, DISABLE_COOKIE_CACHE_QUERY_VALUE as H, type EnvLike as I, asNonEmptyString as J, asString as K, LOCAL_DEV_ORIGIN as L, buildAthenaGatewayHeaders as M, buildAthenaRequestHeaders as N, clearAuthCookies as O, createAuthModeRedirects as P, createAuthRoutes as Q, createFreshSessionLookupUrl as R, SESSION_DATA_HEADER as S, isAbsoluteUrl as T, isAuthMode as U, normalizeAthenaAuthBaseUrl as V, readAthenaAuthUpstreamUrlFromEnv as W, readTrimmedString as X, resolveAthenaAuthClientBaseUrl as Y, resolveAthenaAuthRequestUrl as Z, resolveAthenaAuthUpstreamUrl as _, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM as a, resolveAuthViewFromSegment as a0, resolveEmailVerificationCallbackUrl as a1, shouldRedirectAuthenticatedAuthMode as a2, shouldRedirectAuthenticatedAuthView as a3, type ResolvedRequestHeaderOverrides as a4, applyAthenaApiKeyHeaders as a5, applyAthenaAuthContextHeaders as a6, applyAthenaPgUriHeaders as a7, buildServiceRequestHeaders as a8, hasHeaderIgnoreCase as a9, resolveHeaderValue as aa, resolveRequestHeaderOverrides as ab, DEFAULT_AUTH_COOKIE_PREFIXES as ac, asBoolean as ad, asBooleanOrNull as ae, asIdentifier as af, asNumber as ag, asRecord as ah, asStringArray as ai, firstString as aj, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE as b, ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH as c, ATHENA_AUTH_GET_SESSION_PATH as d, ATHENA_AUTH_PATH as e, ATHENA_AUTH_UPSTREAM_ENV_KEYS as f, ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES as g, ATHENA_AUTH_VERIFY_EMAIL_PATH as h, ATHENA_SESSION_DATA_HEADER as i, AUTHENTICATED_REDIRECT_MODE_SET as j, AUTHENTICATED_REDIRECT_VIEW_SET as k, AUTH_DEFAULT_VIEW as l, AUTH_MODE_REDIRECTS as m, AUTH_MODE_SET as n, AUTH_ROUTES as o, AUTH_SESSION_PATH as p, AUTH_TWO_FACTOR_SEGMENT as q, AUTH_VIEW_BY_SEGMENT as r, type AthenaAuthClientBaseUrlOptions as s, type AthenaAuthUpstreamEnv as t, type AthenaAuthUpstreamEnvKey as u, type AthenaRequestHeaderOverrideFields as v, type AthenaRequestHeaderProfile as w, type AuthMode as x, type AuthModeRedirects as y, type AuthRoutes as z };

package/dist/{athena-auth-url-oLux_57a.d.ts → athena-request-headers-DujFFyMU.d.cts}

@@ -1,3 +1,5 @@
+import { t as BackendOption } from './types-Bltx6iL6.cjs';
+
 /**
  * Cookie name prefixes treated as Athena Auth / Better Auth session material.
  *
@@ -374,4 +376,86 @@ declare function resolveEmailVerificationCallbackUrl(rawBaseUrl?: string | EnvLi
  */
 declare function createFreshSessionLookupUrl(baseUrl: string | URL): URL;
 
-export { ATHENA_AUTH_COOKIE_PREFIXES as A, AUTH_SESSION_PATH as B, type ClearAuthCookiesOptions as C, DEFAULT_ATHENA_AUTH_ORIGIN as D, type EnvLike as E, AUTH_TWO_FACTOR_SEGMENT as F, type AthenaAuthClientBaseUrlOptions as G, type AthenaAuthUpstreamEnv as H, type AthenaAuthUpstreamEnvKey as I, type AuthMode as J, type AuthModeRedirects as K, type AuthRoutes as L, DEFAULT_ATHENA_AUTH_UPSTREAM_URL as M, DEFAULT_AUTH_COOKIE_PREFIXES as N, DISABLE_COOKIE_CACHE_QUERY_PARAM as O, DISABLE_COOKIE_CACHE_QUERY_VALUE as P, LOCAL_DEV_ORIGIN as Q, createAuthModeRedirects as R, SESSION_DATA_HEADER as S, createAuthRoutes as T, createFreshSessionLookupUrl as U, isAuthMode as V, readAthenaAuthUpstreamUrlFromEnv as W, resolveAuthModeRedirect as X, shouldRedirectAuthenticatedAuthMode as Y, ATHENA_AUTH_PATH as a, ATHENA_AUTH_UPSTREAM_ENV_KEYS as b, ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES as c, AUTH_DEFAULT_VIEW as d, AUTH_ROUTES as e, AUTH_VIEW_BY_SEGMENT as f, type AuthView as g, clearAuthCookies as h, isAbsoluteUrl as i, resolveAthenaAuthRequestUrl as j, resolveAthenaAuthUpstreamUrl as k, resolveAuthViewFromSegment as l, resolveEmailVerificationCallbackUrl as m, normalizeAthenaAuthBaseUrl as n, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM as o, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE as p, ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH as q, resolveAthenaAuthClientBaseUrl as r, shouldRedirectAuthenticatedAuthView as s, ATHENA_AUTH_GET_SESSION_PATH as t, ATHENA_AUTH_VERIFY_EMAIL_PATH as u, ATHENA_SESSION_DATA_HEADER as v, AUTHENTICATED_REDIRECT_MODE_SET as w, AUTHENTICATED_REDIRECT_VIEW_SET as x, AUTH_MODE_REDIRECTS as y, AUTH_MODE_SET as z };
+declare function asString(value: unknown): string | null;
+declare function asBoolean(value: unknown): boolean;
+declare function asBooleanOrNull(value: unknown): boolean | null;
+declare function asRecord(value: unknown): Record<string, unknown> | null;
+declare function asIdentifier(value: unknown): string | null;
+declare function firstString(record: Record<string, unknown> | null | undefined, keys: readonly string[]): string | null;
+declare function readTrimmedString(value: unknown): string | null;
+/**
+ * Trim a string value; return `undefined` when not a non-empty string.
+ *
+ * Unlike {@link asString}, does not coerce numbers/bigints.
+ * Unlike {@link readTrimmedString}, returns `undefined` instead of `null`
+ * (handy for optional fields and `??` defaults).
+ */
+declare function asNonEmptyString(value: unknown): string | undefined;
+declare function asNumber(value: unknown): number | null;
+declare function asStringArray(value: unknown): string[];
+
+type AthenaRequestHeaderProfile = 'gateway' | 'auth' | 'chat' | 'storage' | 'minimal';
+interface BuildAthenaRequestHeadersInput {
+    profile: AthenaRequestHeaderProfile;
+    sdkHeaderValue: string;
+    apiKey?: string | null;
+    client?: string | null;
+    userId?: string | null;
+    organizationId?: string | null;
+    backend?: BackendOption;
+    publishEvent?: string | null;
+    stripNulls?: boolean;
+    bearerToken?: string | null;
+    cookie?: string | null;
+    sessionToken?: string | null;
+    pgUri?: string | null;
+    jdbcUrl?: string | null;
+    forceNoCache?: boolean;
+    configHeaders?: Record<string, string>;
+    callHeaders?: Record<string, string>;
+    contentType?: string | null;
+    accept?: string | null;
+}
+/** Shared config/call fields consumed by gateway, chat, auth, and `client.request(...)`. */
+interface AthenaRequestHeaderOverrideFields {
+    apiKey?: string | null;
+    client?: string | null;
+    userId?: string | null;
+    organizationId?: string | null;
+    backend?: BackendOption;
+    publishEvent?: string | null;
+    stripNulls?: boolean;
+    bearerToken?: string | null;
+    cookie?: string | null;
+    sessionToken?: string | null;
+    pgUri?: string | null;
+    jdbcUrl?: string | null;
+    forceNoCache?: boolean;
+    headers?: Record<string, string>;
+}
+type ResolvedRequestHeaderOverrides = Omit<BuildAthenaRequestHeadersInput, 'profile' | 'sdkHeaderValue' | 'contentType' | 'accept'>;
+declare function hasHeaderIgnoreCase(headers: Record<string, string>, targetKey: string): boolean;
+declare function resolveHeaderValue(headers: Record<string, string>, candidates: readonly string[]): string | undefined;
+declare function resolveRequestHeaderOverrides(config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, defaults?: Pick<AthenaRequestHeaderOverrideFields, 'client' | 'stripNulls'>): ResolvedRequestHeaderOverrides;
+declare function buildServiceRequestHeaders(profile: Exclude<AthenaRequestHeaderProfile, 'minimal'>, sdkHeaderValue: string, config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, extras?: Pick<BuildAthenaRequestHeadersInput, 'contentType' | 'accept'> & {
+    client?: string | null;
+    stripNulls?: boolean;
+}): Record<string, string>;
+declare function applyAthenaApiKeyHeaders(headers: Record<string, string>, apiKey?: string | null): void;
+declare function applyAthenaAuthContextHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'bearerToken' | 'cookie' | 'sessionToken' | 'profile' | 'configHeaders' | 'callHeaders'>): void;
+declare function applyAthenaPgUriHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'pgUri' | 'jdbcUrl' | 'configHeaders' | 'callHeaders'>): void;
+/**
+ * Minimal gateway/data request headers used by many apps before they adopt
+ * the full {@link buildAthenaRequestHeaders} profile model.
+ *
+ * Additive convenience — does not replace client-built headers. Prefer
+ * `createClient({ client, key })` so the SDK sets these on every call.
+ */
+declare function buildAthenaGatewayHeaders(input: {
+    clientName?: string | null;
+    gatewayKey?: string | null;
+    headers?: Record<string, string | null | undefined>;
+}): Record<string, string>;
+declare function buildAthenaRequestHeaders(input: BuildAthenaRequestHeadersInput): Record<string, string>;
+
+export { resolveAuthModeRedirect as $, ATHENA_AUTH_COOKIE_PREFIXES as A, type AuthView as B, type BuildAthenaRequestHeadersInput as C, type ClearAuthCookiesOptions as D, DEFAULT_ATHENA_AUTH_ORIGIN as E, DEFAULT_ATHENA_AUTH_UPSTREAM_URL as F, DISABLE_COOKIE_CACHE_QUERY_PARAM as G, DISABLE_COOKIE_CACHE_QUERY_VALUE as H, type EnvLike as I, asNonEmptyString as J, asString as K, LOCAL_DEV_ORIGIN as L, buildAthenaGatewayHeaders as M, buildAthenaRequestHeaders as N, clearAuthCookies as O, createAuthModeRedirects as P, createAuthRoutes as Q, createFreshSessionLookupUrl as R, SESSION_DATA_HEADER as S, isAbsoluteUrl as T, isAuthMode as U, normalizeAthenaAuthBaseUrl as V, readAthenaAuthUpstreamUrlFromEnv as W, readTrimmedString as X, resolveAthenaAuthClientBaseUrl as Y, resolveAthenaAuthRequestUrl as Z, resolveAthenaAuthUpstreamUrl as _, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM as a, resolveAuthViewFromSegment as a0, resolveEmailVerificationCallbackUrl as a1, shouldRedirectAuthenticatedAuthMode as a2, shouldRedirectAuthenticatedAuthView as a3, type ResolvedRequestHeaderOverrides as a4, applyAthenaApiKeyHeaders as a5, applyAthenaAuthContextHeaders as a6, applyAthenaPgUriHeaders as a7, buildServiceRequestHeaders as a8, hasHeaderIgnoreCase as a9, resolveHeaderValue as aa, resolveRequestHeaderOverrides as ab, DEFAULT_AUTH_COOKIE_PREFIXES as ac, asBoolean as ad, asBooleanOrNull as ae, asIdentifier as af, asNumber as ag, asRecord as ah, asStringArray as ai, firstString as aj, ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE as b, ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH as c, ATHENA_AUTH_GET_SESSION_PATH as d, ATHENA_AUTH_PATH as e, ATHENA_AUTH_UPSTREAM_ENV_KEYS as f, ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES as g, ATHENA_AUTH_VERIFY_EMAIL_PATH as h, ATHENA_SESSION_DATA_HEADER as i, AUTHENTICATED_REDIRECT_MODE_SET as j, AUTHENTICATED_REDIRECT_VIEW_SET as k, AUTH_DEFAULT_VIEW as l, AUTH_MODE_REDIRECTS as m, AUTH_MODE_SET as n, AUTH_ROUTES as o, AUTH_SESSION_PATH as p, AUTH_TWO_FACTOR_SEGMENT as q, AUTH_VIEW_BY_SEGMENT as r, type AthenaAuthClientBaseUrlOptions as s, type AthenaAuthUpstreamEnv as t, type AthenaAuthUpstreamEnvKey as u, type AthenaRequestHeaderOverrideFields as v, type AthenaRequestHeaderProfile as w, type AuthMode as x, type AuthModeRedirects as y, type AuthRoutes as z };

package/dist/billing.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "3.0.0"
+  version: "3.0.2"
 };
 
 // src/sdk-version.ts
@@ -318,14 +318,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 in the explicit env object (or pass createClient({ url, key })) 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 in the explicit env object (or pass createClient({ url, key })) 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;
@@ -334,13 +334,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) {
@@ -375,6 +375,8 @@ var billingSdkManifest = {
   methods: [
     { name: "getCapabilities", method: "GET", path: "/billing/v1/capabilities" },
     { name: "createCheckout", method: "POST", path: "/billing/v1/checkouts" },
+    { name: "listProducts", method: "GET", path: "/billing/v1/products" },
+    { name: "listPrices", method: "GET", path: "/billing/v1/prices" },
     { name: "listCustomers", method: "GET", path: "/billing/v1/customers" },
     { name: "createCustomer", method: "POST", path: "/billing/v1/customers" },
     { name: "getCustomer", method: "GET", path: "/billing/v1/customers/{id}" },
@@ -400,6 +402,12 @@ var billingSdkManifest = {
     { name: "cancelSubscription", method: "POST", path: "/billing/v1/subscriptions/{id}/cancel" },
     { name: "listInvoices", method: "GET", path: "/billing/v1/invoices" },
     { name: "getInvoice", method: "GET", path: "/billing/v1/invoices/{id}" },
+    { name: "listWebhooks", method: "GET", path: "/billing/v1/webhooks" },
+    { name: "createWebhook", method: "POST", path: "/billing/v1/webhooks" },
+    { name: "getWebhook", method: "GET", path: "/billing/v1/webhooks/{id}" },
+    { name: "updateWebhook", method: "PATCH", path: "/billing/v1/webhooks/{id}" },
+    { name: "deleteWebhook", method: "DELETE", path: "/billing/v1/webhooks/{id}" },
+    { name: "testWebhook", method: "POST", path: "/billing/v1/webhooks/{id}/test" },
     {
       name: "listConnections",
       method: "GET",
@@ -568,6 +576,25 @@ function createBillingModule(config) {
     createCheckout(body, options) {
       return call("POST", "/billing/v1/checkouts", body, options);
     },
+    listProducts(input, options) {
+      return call(
+        "GET",
+        appendQuery("/billing/v1/products", connectionQuery(input)),
+        void 0,
+        options
+      );
+    },
+    listPrices(input, options) {
+      return call(
+        "GET",
+        appendQuery("/billing/v1/prices", {
+          ...connectionQuery(input),
+          ...input.productId ? { productId: input.productId } : {}
+        }),
+        void 0,
+        options
+      );
+    },
     listCustomers(input, options) {
       return call(
         "GET",
@@ -714,10 +741,7 @@ function createBillingModule(config) {
     getRefund(id, input, options) {
       return call(
         "GET",
-        appendQuery(withPathParam("/billing/v1/refunds/{id}", "id", id), {
-          ...connectionQuery(input),
-          ...input.paymentId ? { paymentId: input.paymentId } : {}
-        }),
+        appendQuery(withPathParam("/billing/v1/refunds/{id}", "id", id), connectionQuery(input)),
         void 0,
         options
       );
@@ -725,10 +749,7 @@ function createBillingModule(config) {
     cancelRefund(id, input, options) {
       return call(
         "POST",
-        appendQuery(withPathParam("/billing/v1/refunds/{id}/cancel", "id", id), {
-          ...connectionQuery(input),
-          ...input.paymentId ? { paymentId: input.paymentId } : {}
-        }),
+        appendQuery(withPathParam("/billing/v1/refunds/{id}/cancel", "id", id), connectionQuery(input)),
         {},
         options
       );
@@ -747,10 +768,10 @@ function createBillingModule(config) {
     getSubscription(id, input, options) {
       return call(
         "GET",
-        appendQuery(withPathParam("/billing/v1/subscriptions/{id}", "id", id), {
-          ...connectionQuery(input),
-          ...input.customerId ? { customerId: input.customerId } : {}
-        }),
+        appendQuery(
+          withPathParam("/billing/v1/subscriptions/{id}", "id", id),
+          connectionQuery(input)
+        ),
         void 0,
         options
       );
@@ -766,10 +787,10 @@ function createBillingModule(config) {
     cancelSubscription(id, input, options) {
       return call(
         "POST",
-        appendQuery(withPathParam("/billing/v1/subscriptions/{id}/cancel", "id", id), {
-          ...connectionQuery(input),
-          customerId: input.customerId
-        }),
+        appendQuery(
+          withPathParam("/billing/v1/subscriptions/{id}/cancel", "id", id),
+          connectionQuery(input)
+        ),
         {},
         options
       );
@@ -793,6 +814,57 @@ function createBillingModule(config) {
         options
       );
     },
+    listWebhooks(input, options) {
+      return call(
+        "GET",
+        appendQuery("/billing/v1/webhooks", connectionQuery(input)),
+        void 0,
+        options
+      );
+    },
+    createWebhook(input, body, options) {
+      return call(
+        "POST",
+        appendQuery("/billing/v1/webhooks", connectionQuery(input)),
+        body,
+        options
+      );
+    },
+    getWebhook(id, input, options) {
+      return call(
+        "GET",
+        appendQuery(withPathParam("/billing/v1/webhooks/{id}", "id", id), connectionQuery(input)),
+        void 0,
+        options
+      );
+    },
+    updateWebhook(id, input, body, options) {
+      return call(
+        "PATCH",
+        appendQuery(withPathParam("/billing/v1/webhooks/{id}", "id", id), connectionQuery(input)),
+        body,
+        options
+      );
+    },
+    deleteWebhook(id, input, options) {
+      return call(
+        "DELETE",
+        appendQuery(withPathParam("/billing/v1/webhooks/{id}", "id", id), connectionQuery(input)),
+        void 0,
+        options
+      );
+    },
+    testWebhook(id, input, options) {
+      return call(
+        "POST",
+        appendQuery(
+          withPathParam("/billing/v1/webhooks/{id}/test", "id", id),
+          connectionQuery(input)
+        ),
+        {},
+        options
+      );
+    },
     listConnections(clientName, options) {
       return call(
         "GET",
@@ -1051,6 +1123,16 @@ var live_http_routes_default = {
       path: "/billing/v1/checkouts",
       surface: "billingV1"
     },
+    {
+      method: "GET",
+      path: "/billing/v1/products",
+      surface: "billingV1"
+    },
+    {
+      method: "GET",
+      path: "/billing/v1/prices",
+      surface: "billingV1"
+    },
     {
       method: "GET",
       path: "/billing/v1/customers",
@@ -1176,6 +1258,36 @@ var live_http_routes_default = {
       path: "/billing/v1/subscriptions/{id}/cancel",
       surface: "billingV1"
     },
+    {
+      method: "GET",
+      path: "/billing/v1/webhooks",
+      surface: "billingV1"
+    },
+    {
+      method: "POST",
+      path: "/billing/v1/webhooks",
+      surface: "billingV1"
+    },
+    {
+      method: "DELETE",
+      path: "/billing/v1/webhooks/{id}",
+      surface: "billingV1"
+    },
+    {
+      method: "GET",
+      path: "/billing/v1/webhooks/{id}",
+      surface: "billingV1"
+    },
+    {
+      method: "PATCH",
+      path: "/billing/v1/webhooks/{id}",
+      surface: "billingV1"
+    },
+    {
+      method: "POST",
+      path: "/billing/v1/webhooks/{id}/test",
+      surface: "billingV1"
+    },
     {
       method: "GET",
       path: "/debug/billing",