@artu-ai/compliance-sdk 0.0.6 → 0.2.0

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SDK utilities
+ *
+ * This module exports utility functions for working with the SDK.
+ */
+export { createAPIClient, generateRequestId, isTRPCError, getRequestIdFromError, LATEST_API_VERSION, DEFAULT_TIMEOUT, } from "./trpc-client";
+export type { TRPCClient, TRPCClientConfig, APIVersion, SDKEnvironment, } from "./trpc-client";
+export { validateEnvironment, isValidEnvironment, getDefaultBaseUrl, resolveBaseUrl, environmentSchema, DEFAULT_BASE_URL, } from "./environment";
+export type { Environment, SDKEnvironmentConfig } from "./environment";
+export { fetchSession, createAuthLoginUrl, type SessionInfo, type SessionType, type SessionOptions, type SessionOptionsWithReturnTo, type SessionOptionsWithoutReturnTo, type SDKSessionOptions, type SDKSessionOptionsWithReturnTo, type SDKSessionOptionsWithoutReturnTo, type SessionResult, type SessionResultWithRedirect, type SessionResultWithoutRedirect, type SessionResultAuthenticated, type SessionResultUnauthenticatedWithRedirect, type SessionResultUnauthenticatedNoRedirect, } from "./session";
+export { createPaginatedIterator, collectAll, collectUpTo, getFirst, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, } from "./pagination";
+export { buildClientFilter, buildTransactionFilter, buildDocumentFilter, buildBankAccountFilter, contains, startsWith, endsWith, equals, notEquals, oneOf, notOneOf, dateRange, after, before, onOrAfter, onOrBefore, numberRange, greaterThan, lessThan, atLeast, atMost, isTrue, isFalse, isNull, isNotNull, } from "./filters";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAMvE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,wCAAwC,EAC7C,KAAK,sCAAsC,GAC5C,MAAM,WAAW,CAAC;AAMnB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EAEL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EAEtB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,SAAS,EAET,KAAK,EACL,QAAQ,EAER,SAAS,EACT,KAAK,EACL,MAAM,EACN,SAAS,EACT,UAAU,EAEV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,OAAO,EACP,MAAM,EAEN,MAAM,EACN,OAAO,EAEP,MAAM,EACN,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,39 @@
+/**
+ * SDK utilities
+ *
+ * This module exports utility functions for working with the SDK.
+ */
+// ===========================
+// tRPC Client - Phase 1.3
+// ===========================
+export { createAPIClient, generateRequestId, isTRPCError, getRequestIdFromError, LATEST_API_VERSION, DEFAULT_TIMEOUT, } from "./trpc-client";
+// ===========================
+// Environment - Phase 1.4
+// ===========================
+export { validateEnvironment, isValidEnvironment, getDefaultBaseUrl, resolveBaseUrl, environmentSchema, DEFAULT_BASE_URL, } from "./environment";
+// ===========================
+// Session helper
+// ===========================
+export { fetchSession, createAuthLoginUrl, } from "./session";
+// ===========================
+// Pagination - Phase 1.4
+// ===========================
+export { createPaginatedIterator, collectAll, collectUpTo, getFirst, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, } from "./pagination";
+// ===========================
+// Filters - Phase 1.4
+// ===========================
+export { 
+// Filter builders
+buildClientFilter, buildTransactionFilter, buildDocumentFilter, buildBankAccountFilter, 
+// String filters
+contains, startsWith, endsWith, equals, notEquals, 
+// Array filters
+oneOf, notOneOf, 
+// Date filters
+dateRange, after, before, onOrAfter, onOrBefore, 
+// Number filters
+numberRange, greaterThan, lessThan, atLeast, atMost, 
+// Boolean filters
+isTrue, isFalse, 
+// Null filters
+isNull, isNotNull, } from "./filters";

package/dist/utils/pagination.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Pagination utilities
+ *
+ * Helpers for working with paginated API responses.
+ * Includes async iterators for automatic pagination.
+ */
+import type { PaginationInput, PaginatedResponse } from "@artu-ai/shared";
+/**
+ * Default page size for paginated requests
+ */
+export declare const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Maximum page size allowed by the API
+ */
+export declare const MAX_PAGE_SIZE = 200;
+/**
+ * Creates an async iterator for paginated results.
+ * Automatically fetches subsequent pages as you iterate.
+ *
+ * @param fetchPage - Function that fetches a page of results
+ * @param options - Iterator options
+ * @returns Async generator yielding individual items
+ *
+ * @example
+ * ```typescript
+ * const iterator = createPaginatedIterator(
+ *   (pagination) => client.clients.list.query(pagination)
+ * );
+ *
+ * for await (const client of iterator) {
+ *   console.log(client.name);
+ * }
+ * ```
+ */
+export declare function createPaginatedIterator<T>(fetchPage: (pagination: PaginationInput) => Promise<PaginatedResponse<T>>, options?: {
+    limit?: number;
+}): AsyncGenerator<T, void, undefined>;
+/**
+ * Collects all items from a paginated iterator into an array.
+ * Use with caution on large datasets.
+ *
+ * @param iterator - Async iterator to collect from
+ * @returns Array of all items
+ *
+ * @example
+ * ```typescript
+ * const allClients = await collectAll(
+ *   createPaginatedIterator((p) => client.clients.list.query(p))
+ * );
+ * ```
+ */
+export declare function collectAll<T>(iterator: AsyncGenerator<T, void, undefined>): Promise<T[]>;
+/**
+ * Collects items from a paginated iterator up to a maximum count.
+ * Useful when you only need a subset of results.
+ *
+ * @param iterator - Async iterator to collect from
+ * @param maxItems - Maximum number of items to collect
+ * @returns Array of collected items
+ *
+ * @example
+ * ```typescript
+ * // Get first 100 clients
+ * const clients = await collectUpTo(
+ *   createPaginatedIterator((p) => client.clients.list.query(p)),
+ *   100
+ * );
+ * ```
+ */
+export declare function collectUpTo<T>(iterator: AsyncGenerator<T, void, undefined>, maxItems: number): Promise<T[]>;
+/**
+ * Gets the first item from a paginated iterator, or undefined if empty.
+ *
+ * @param iterator - Async iterator to get first item from
+ * @returns First item or undefined
+ *
+ * @example
+ * ```typescript
+ * const firstClient = await getFirst(
+ *   createPaginatedIterator((p) => client.clients.list.query({ ...p, limit: 1 }))
+ * );
+ * ```
+ */
+export declare function getFirst<T>(iterator: AsyncGenerator<T, void, undefined>): Promise<T | undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAM1E;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AAMjC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,uBAAuB,CAAC,CAAC,EAC9C,SAAS,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EACzE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAkBpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAMd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAC5C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,GAC3C,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAGxB"}

package/dist/utils/pagination.js

@@ -0,0 +1,120 @@
+/**
+ * Pagination utilities
+ *
+ * Helpers for working with paginated API responses.
+ * Includes async iterators for automatic pagination.
+ */
+// ===========================
+// Constants
+// ===========================
+/**
+ * Default page size for paginated requests
+ */
+export const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Maximum page size allowed by the API
+ */
+export const MAX_PAGE_SIZE = 200;
+// ===========================
+// Functions
+// ===========================
+/**
+ * Creates an async iterator for paginated results.
+ * Automatically fetches subsequent pages as you iterate.
+ *
+ * @param fetchPage - Function that fetches a page of results
+ * @param options - Iterator options
+ * @returns Async generator yielding individual items
+ *
+ * @example
+ * ```typescript
+ * const iterator = createPaginatedIterator(
+ *   (pagination) => client.clients.list.query(pagination)
+ * );
+ *
+ * for await (const client of iterator) {
+ *   console.log(client.name);
+ * }
+ * ```
+ */
+export async function* createPaginatedIterator(fetchPage, options) {
+    let cursor;
+    let hasMore = true;
+    const pageSize = options?.limit ?? DEFAULT_PAGE_SIZE;
+    while (hasMore) {
+        const response = await fetchPage({
+            cursor,
+            limit: Math.min(pageSize, MAX_PAGE_SIZE),
+        });
+        for (const item of response.data) {
+            yield item;
+        }
+        hasMore = response.pagination.hasMore;
+        cursor = response.pagination.nextCursor ?? undefined;
+    }
+}
+/**
+ * Collects all items from a paginated iterator into an array.
+ * Use with caution on large datasets.
+ *
+ * @param iterator - Async iterator to collect from
+ * @returns Array of all items
+ *
+ * @example
+ * ```typescript
+ * const allClients = await collectAll(
+ *   createPaginatedIterator((p) => client.clients.list.query(p))
+ * );
+ * ```
+ */
+export async function collectAll(iterator) {
+    const items = [];
+    for await (const item of iterator) {
+        items.push(item);
+    }
+    return items;
+}
+/**
+ * Collects items from a paginated iterator up to a maximum count.
+ * Useful when you only need a subset of results.
+ *
+ * @param iterator - Async iterator to collect from
+ * @param maxItems - Maximum number of items to collect
+ * @returns Array of collected items
+ *
+ * @example
+ * ```typescript
+ * // Get first 100 clients
+ * const clients = await collectUpTo(
+ *   createPaginatedIterator((p) => client.clients.list.query(p)),
+ *   100
+ * );
+ * ```
+ */
+export async function collectUpTo(iterator, maxItems) {
+    const items = [];
+    for await (const item of iterator) {
+        items.push(item);
+        if (items.length >= maxItems) {
+            break;
+        }
+    }
+    return items;
+}
+/**
+ * Gets the first item from a paginated iterator, or undefined if empty.
+ *
+ * @param iterator - Async iterator to get first item from
+ * @returns First item or undefined
+ *
+ * @example
+ * ```typescript
+ * const firstClient = await getFirst(
+ *   createPaginatedIterator((p) => client.clients.list.query({ ...p, limit: 1 }))
+ * );
+ * ```
+ */
+export async function getFirst(iterator) {
+    const result = await iterator.next();
+    return result.done ? undefined : result.value;
+}

package/dist/utils/session.d.ts

@@ -0,0 +1,155 @@
+import type { Environment } from "./environment";
+export type SessionType = "session" | "apiKey";
+export interface SessionInfo {
+    organizationId: string;
+    permissions: string[];
+    environment: Environment;
+    userId: string;
+    type: SessionType;
+}
+/**
+ * Base options for fetchSession.
+ */
+interface SessionOptionsBase {
+    /**
+     * Base URL for the API (e.g. https://api.artu.ai)
+     */
+    baseUrl: string;
+    /**
+     * Environment header value ("test" | "live")
+     */
+    environment: Environment;
+    /**
+     * Credentials policy for fetch. Defaults to "include".
+     */
+    credentials?: "include" | "omit" | "same-origin";
+    /**
+     * Custom headers to include with the request.
+     * Useful for server-side cookie forwarding.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation (optional).
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Options for fetchSession when returnTo is provided.
+ */
+export interface SessionOptionsWithReturnTo extends SessionOptionsBase {
+    /**
+     * Full URL to return to after authentication.
+     * When provided, redirectUrl will be included in the result when not authenticated.
+     */
+    returnTo: string;
+}
+/**
+ * Options for fetchSession when returnTo is not provided.
+ */
+export interface SessionOptionsWithoutReturnTo extends SessionOptionsBase {
+    returnTo?: never;
+}
+/**
+ * Combined session options type.
+ */
+export type SessionOptions = SessionOptionsWithReturnTo | SessionOptionsWithoutReturnTo;
+/**
+ * Options for sdk.session() when returnTo is provided.
+ * Result will include redirectUrl when not authenticated.
+ */
+export interface SDKSessionOptionsWithReturnTo {
+    /**
+     * Full URL to return to after authentication.
+     * When provided, redirectUrl will be included in the result when not authenticated.
+     */
+    returnTo: string;
+}
+/**
+ * Options for sdk.session() when returnTo is not provided.
+ */
+export interface SDKSessionOptionsWithoutReturnTo {
+    returnTo?: never;
+}
+/**
+ * Combined SDK session options type.
+ */
+export type SDKSessionOptions = SDKSessionOptionsWithReturnTo | SDKSessionOptionsWithoutReturnTo;
+/**
+ * Result when user is authenticated.
+ */
+export interface SessionResultAuthenticated {
+    session: SessionInfo;
+    isAuthenticated: true;
+    redirectUrl?: never;
+}
+/**
+ * Result when user is NOT authenticated and returnTo was provided.
+ */
+export interface SessionResultUnauthenticatedWithRedirect {
+    session: null;
+    isAuthenticated: false;
+    redirectUrl: string;
+}
+/**
+ * Result when user is NOT authenticated and returnTo was NOT provided.
+ */
+export interface SessionResultUnauthenticatedNoRedirect {
+    session: null;
+    isAuthenticated: false;
+    redirectUrl?: never;
+}
+/**
+ * Session result when returnTo is provided.
+ * Either authenticated (session present, no redirect) or unauthenticated (no session, redirect present).
+ * This allows TypeScript to narrow: if redirectUrl exists, session is null; otherwise session is present.
+ */
+export type SessionResultWithRedirect = SessionResultAuthenticated | SessionResultUnauthenticatedWithRedirect;
+/**
+ * Session result when returnTo is NOT provided.
+ */
+export type SessionResultWithoutRedirect = SessionResultAuthenticated | SessionResultUnauthenticatedNoRedirect;
+/**
+ * Generic session result type.
+ */
+export type SessionResult = SessionResultAuthenticated | SessionResultUnauthenticatedWithRedirect | SessionResultUnauthenticatedNoRedirect;
+export declare function createAuthLoginUrl(options: {
+    apiBaseUrl: string;
+    returnTo: string;
+}): string;
+/**
+ * Fetches session from /auth/me.
+ * Returns a result object with session info if authenticated,
+ * or null session with optional redirectUrl if not.
+ *
+ * @example With returnTo (includes redirectUrl when not authenticated)
+ * ```typescript
+ * const result = await fetchSession({
+ *   baseUrl: "https://api.artu.ai",
+ *   environment: "test",
+ *   returnTo: "https://dashboard.artu.ai/env/test/dashboard",
+ * });
+ *
+ * if (result.redirectUrl) {
+ *   redirect(result.redirectUrl);
+ * }
+ *
+ * // TypeScript knows session is guaranteed here
+ * console.log("User:", result.session.userId);
+ * ```
+ *
+ * @example Without returnTo (just check if authenticated)
+ * ```typescript
+ * const result = await fetchSession({
+ *   baseUrl: "https://api.artu.ai",
+ *   environment: "test",
+ * });
+ *
+ * if (result.isAuthenticated) {
+ *   console.log("User:", result.session.userId);
+ * }
+ * ```
+ */
+export declare function fetchSession(options: SessionOptionsWithReturnTo): Promise<SessionResultWithRedirect>;
+export declare function fetchSession(options: SessionOptionsWithoutReturnTo): Promise<SessionResultWithoutRedirect>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/utils/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;CACnB;AAMD;;GAEG;AACH,UAAU,kBAAkB;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IAEjD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,0BAA0B,GAC1B,6BAA6B,CAAC;AAOlC;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,6BAA6B,GAC7B,gCAAgC,CAAC;AAMrC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,EAAE,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wCAAwC;IACvD,OAAO,EAAE,IAAI,CAAC;IACd,eAAe,EAAE,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,OAAO,EAAE,IAAI,CAAC;IACd,eAAe,EAAE,KAAK,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GACjC,0BAA0B,GAC1B,wCAAwC,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,0BAA0B,GAC1B,sCAAsC,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,0BAA0B,GAC1B,wCAAwC,GACxC,sCAAsC,CAAC;AAM3C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAKT;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC;AACtC,wBAAgB,YAAY,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/utils/session.js

@@ -0,0 +1,50 @@
+// ===========================
+// Helper
+// ===========================
+export function createAuthLoginUrl(options) {
+    const { apiBaseUrl, returnTo } = options;
+    const loginUrl = new URL("/auth/login", apiBaseUrl);
+    loginUrl.searchParams.set("return_to", returnTo);
+    return loginUrl.toString();
+}
+export async function fetchSession(options) {
+    const { baseUrl, environment, credentials = "include", headers: customHeaders = {}, fetchImpl = fetch, returnTo, } = options;
+    const normalizedBaseUrl = baseUrl.replace(/\/$/, "");
+    const handleUnauthenticated = () => {
+        if (returnTo) {
+            return {
+                session: null,
+                isAuthenticated: false,
+                redirectUrl: createAuthLoginUrl({
+                    apiBaseUrl: normalizedBaseUrl,
+                    returnTo,
+                }),
+            };
+        }
+        return {
+            session: null,
+            isAuthenticated: false,
+        };
+    };
+    try {
+        const res = await fetchImpl(`${normalizedBaseUrl}/auth/me`, {
+            headers: {
+                ...customHeaders,
+                "X-Environment": environment,
+            },
+            credentials,
+        });
+        if (res.status === 401 || !res.ok) {
+            return handleUnauthenticated();
+        }
+        const session = (await res.json());
+        return {
+            session,
+            isAuthenticated: true,
+        };
+    }
+    catch {
+        // Network error or other failure - treat as not authenticated
+        return handleUnauthenticated();
+    }
+}