@constructive-io/react 0.27.1 → 0.27.2

package/esm/auth/hooks/mutations/useUpdatePrincipalEntityMutation.js

@@ -0,0 +1,37 @@
+/**
+ * Association table scoping principals to specific organizations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { principalEntityKeys } from '../query-keys';
+import { principalEntityMutationKeys } from '../mutation-keys';
+export function useUpdatePrincipalEntityMutation(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...mutationOptions } = params ?? {};
+    void _selection;
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationKey: principalEntityMutationKeys.all,
+        mutationFn: ({ id, principalEntityPatch, }) => getClient()
+            .principalEntity.update({
+            where: {
+                id,
+            },
+            data: principalEntityPatch,
+            select: args.select,
+        })
+            .unwrap(),
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({
+                queryKey: principalEntityKeys.detail(variables.id),
+            });
+            queryClient.invalidateQueries({
+                queryKey: principalEntityKeys.lists(),
+            });
+        },
+        ...mutationOptions,
+    });
+}

package/esm/auth/hooks/queries/index.d.ts

@@ -3,6 +3,12 @@
  * @generated by @constructive-io/graphql-codegen
  * DO NOT EDIT - changes will be overwritten
  */
+export * from './usePrincipalsQuery';
+export * from './usePrincipalQuery';
+export * from './usePrincipalEntitiesQuery';
+export * from './usePrincipalEntityQuery';
+export * from './usePrincipalScopeOverridesQuery';
+export * from './usePrincipalScopeOverrideQuery';
 export * from './useEmailsQuery';
 export * from './useEmailQuery';
 export * from './usePhoneNumbersQuery';
@@ -18,10 +24,12 @@ export * from './useRoleTypesQuery';
 export * from './useRoleTypeQuery';
 export * from './useUserConnectedAccountsQuery';
 export * from './useUserConnectedAccountQuery';
+export * from './useOrgApiKeyListsQuery';
+export * from './useOrgApiKeyListQuery';
 export * from './useUsersQuery';
 export * from './useUserQuery';
 export * from './useCurrentUserAgentQuery';
-export * from './useCurrentIpAddressQuery';
 export * from './useCurrentUserIdQuery';
+export * from './useCurrentIpAddressQuery';
 export * from './useRequireStepUpQuery';
 export * from './useCurrentUserQuery';

package/esm/auth/hooks/queries/index.js

@@ -3,6 +3,12 @@
  * @generated by @constructive-io/graphql-codegen
  * DO NOT EDIT - changes will be overwritten
  */
+export * from './usePrincipalsQuery';
+export * from './usePrincipalQuery';
+export * from './usePrincipalEntitiesQuery';
+export * from './usePrincipalEntityQuery';
+export * from './usePrincipalScopeOverridesQuery';
+export * from './usePrincipalScopeOverrideQuery';
 export * from './useEmailsQuery';
 export * from './useEmailQuery';
 export * from './usePhoneNumbersQuery';
@@ -18,10 +24,12 @@ export * from './useRoleTypesQuery';
 export * from './useRoleTypeQuery';
 export * from './useUserConnectedAccountsQuery';
 export * from './useUserConnectedAccountQuery';
+export * from './useOrgApiKeyListsQuery';
+export * from './useOrgApiKeyListQuery';
 export * from './useUsersQuery';
 export * from './useUserQuery';
 export * from './useCurrentUserAgentQuery';
-export * from './useCurrentIpAddressQuery';
 export * from './useCurrentUserIdQuery';
+export * from './useCurrentIpAddressQuery';
 export * from './useRequireStepUpQuery';
 export * from './useCurrentUserQuery';

package/esm/auth/hooks/queries/useOrgApiKeyListQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Single item query hook for OrgApiKeyList
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { OrgApiKeyListSelect, OrgApiKeyListWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { OrgApiKeyListSelect, OrgApiKeyListWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const orgApiKeyListQueryKey: (id: string | number) => readonly ["orgapikeylist", "detail", string | number];
+/**
+ * Query hook for fetching a single OrgApiKeyList
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useOrgApiKeyListQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function useOrgApiKeyListQuery<S extends OrgApiKeyListSelect, TData = {
+    orgApiKeyList: InferSelectResult<OrgApiKeyListWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+} & Omit<UseQueryOptions<{
+    orgApiKeyList: InferSelectResult<OrgApiKeyListWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Fetch a single OrgApiKeyList without React hooks
+ *
+ * @example
+ * ```ts
+ * const data = await fetchOrgApiKeyListQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchOrgApiKeyListQuery<S extends OrgApiKeyListSelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+}): Promise<{
+    orgApiKeyList: InferSelectResult<OrgApiKeyListWithRelations, S> | null;
+}>;
+/**
+ * Prefetch a single OrgApiKeyList for SSR or cache warming
+ *
+ * @example
+ * ```ts
+ * await prefetchOrgApiKeyListQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchOrgApiKeyListQuery<S extends OrgApiKeyListSelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+}): Promise<void>;

package/esm/auth/hooks/queries/useOrgApiKeyListQuery.js

@@ -0,0 +1,47 @@
+/**
+ * Single item query hook for OrgApiKeyList
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { orgApiKeyListKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const orgApiKeyListQueryKey = orgApiKeyListKeys.detail;
+export function useOrgApiKeyListQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: orgApiKeyListKeys.detail(params.id),
+        queryFn: () => getClient()
+            .orgApiKeyList.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchOrgApiKeyListQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .orgApiKeyList.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchOrgApiKeyListQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: orgApiKeyListKeys.detail(params.id),
+        queryFn: () => getClient()
+            .orgApiKeyList.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/auth/hooks/queries/useOrgApiKeyListsQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * List query hook for OrgApiKeyList
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { OrgApiKeyListSelect, OrgApiKeyListWithRelations, OrgApiKeyListFilter, OrgApiKeyListOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { OrgApiKeyListSelect, OrgApiKeyListWithRelations, OrgApiKeyListFilter, OrgApiKeyListOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const orgApiKeyListsQueryKey: (variables?: object) => readonly ["orgapikeylist", "list", object];
+/**
+ * Query hook for fetching OrgApiKeyList list
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useOrgApiKeyListsQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function useOrgApiKeyListsQuery<S extends OrgApiKeyListSelect, TData = {
+    orgApiKeyLists: ConnectionResult<InferSelectResult<OrgApiKeyListWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, OrgApiKeyListFilter, OrgApiKeyListOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+} & Omit<UseQueryOptions<{
+    orgApiKeyLists: ConnectionResult<InferSelectResult<OrgApiKeyListWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Fetch OrgApiKeyList list without React hooks
+ *
+ * @example
+ * ```ts
+ * const data = await fetchOrgApiKeyListsQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchOrgApiKeyListsQuery<S extends OrgApiKeyListSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, OrgApiKeyListFilter, OrgApiKeyListOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+}): Promise<{
+    orgApiKeyLists: ConnectionResult<InferSelectResult<OrgApiKeyListWithRelations, S>>;
+}>;
+/**
+ * Prefetch OrgApiKeyList list for SSR or cache warming
+ *
+ * @example
+ * ```ts
+ * await prefetchOrgApiKeyListsQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchOrgApiKeyListsQuery<S extends OrgApiKeyListSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, OrgApiKeyListFilter, OrgApiKeyListOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, OrgApiKeyListSelect>;
+}): Promise<void>;

package/esm/auth/hooks/queries/useOrgApiKeyListsQuery.js

@@ -0,0 +1,32 @@
+/**
+ * List query hook for OrgApiKeyList
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { orgApiKeyListKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const orgApiKeyListsQueryKey = orgApiKeyListKeys.list;
+export function useOrgApiKeyListsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: orgApiKeyListKeys.list(args),
+        queryFn: () => getClient().orgApiKeyList.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchOrgApiKeyListsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().orgApiKeyList.findMany(args).unwrap();
+}
+export async function prefetchOrgApiKeyListsQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: orgApiKeyListKeys.list(args),
+        queryFn: () => getClient().orgApiKeyList.findMany(args).unwrap(),
+    });
+}

package/esm/auth/hooks/queries/usePrincipalEntitiesQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Association table scoping principals to specific organizations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { PrincipalEntitySelect, PrincipalEntityWithRelations, PrincipalEntityFilter, PrincipalEntityOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { PrincipalEntitySelect, PrincipalEntityWithRelations, PrincipalEntityFilter, PrincipalEntityOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const principalEntitiesQueryKey: (variables?: object) => readonly ["principalentity", "list", object];
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePrincipalEntitiesQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function usePrincipalEntitiesQuery<S extends PrincipalEntitySelect, TData = {
+    principalEntities: ConnectionResult<InferSelectResult<PrincipalEntityWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PrincipalEntityFilter, PrincipalEntityOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+} & Omit<UseQueryOptions<{
+    principalEntities: ConnectionResult<InferSelectResult<PrincipalEntityWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPrincipalEntitiesQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchPrincipalEntitiesQuery<S extends PrincipalEntitySelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PrincipalEntityFilter, PrincipalEntityOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+}): Promise<{
+    principalEntities: ConnectionResult<InferSelectResult<PrincipalEntityWithRelations, S>>;
+}>;
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```ts
+ * await prefetchPrincipalEntitiesQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchPrincipalEntitiesQuery<S extends PrincipalEntitySelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, PrincipalEntityFilter, PrincipalEntityOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+}): Promise<void>;

package/esm/auth/hooks/queries/usePrincipalEntitiesQuery.js

@@ -0,0 +1,32 @@
+/**
+ * Association table scoping principals to specific organizations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { principalEntityKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const principalEntitiesQueryKey = principalEntityKeys.list;
+export function usePrincipalEntitiesQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: principalEntityKeys.list(args),
+        queryFn: () => getClient().principalEntity.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPrincipalEntitiesQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().principalEntity.findMany(args).unwrap();
+}
+export async function prefetchPrincipalEntitiesQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: principalEntityKeys.list(args),
+        queryFn: () => getClient().principalEntity.findMany(args).unwrap(),
+    });
+}

package/esm/auth/hooks/queries/usePrincipalEntityQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Association table scoping principals to specific organizations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { PrincipalEntitySelect, PrincipalEntityWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { PrincipalEntitySelect, PrincipalEntityWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const principalEntityQueryKey: (id: string | number) => readonly ["principalentity", "detail", string | number];
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePrincipalEntityQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function usePrincipalEntityQuery<S extends PrincipalEntitySelect, TData = {
+    principalEntity: InferSelectResult<PrincipalEntityWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+} & Omit<UseQueryOptions<{
+    principalEntity: InferSelectResult<PrincipalEntityWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPrincipalEntityQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchPrincipalEntityQuery<S extends PrincipalEntitySelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+}): Promise<{
+    principalEntity: InferSelectResult<PrincipalEntityWithRelations, S> | null;
+}>;
+/**
+ * Association table scoping principals to specific organizations
+ *
+ * @example
+ * ```ts
+ * await prefetchPrincipalEntityQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchPrincipalEntityQuery<S extends PrincipalEntitySelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalEntitySelect>;
+}): Promise<void>;

package/esm/auth/hooks/queries/usePrincipalEntityQuery.js

@@ -0,0 +1,47 @@
+/**
+ * Association table scoping principals to specific organizations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { principalEntityKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const principalEntityQueryKey = principalEntityKeys.detail;
+export function usePrincipalEntityQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: principalEntityKeys.detail(params.id),
+        queryFn: () => getClient()
+            .principalEntity.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPrincipalEntityQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .principalEntity.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchPrincipalEntityQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: principalEntityKeys.detail(params.id),
+        queryFn: () => getClient()
+            .principalEntity.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/auth/hooks/queries/usePrincipalQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Scoped sub-identities (API keys and agents) with precomputed SPRT
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { PrincipalSelect, PrincipalWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { PrincipalSelect, PrincipalWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const principalQueryKey: (id: string | number) => readonly ["principal", "detail", string | number];
+/**
+ * Scoped sub-identities (API keys and agents) with precomputed SPRT
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = usePrincipalQuery({
+ *   principalId: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function usePrincipalQuery<S extends PrincipalSelect, TData = {
+    principal: InferSelectResult<PrincipalWithRelations, S> | null;
+}>(params: {
+    principalId: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalSelect>;
+} & Omit<UseQueryOptions<{
+    principal: InferSelectResult<PrincipalWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Scoped sub-identities (API keys and agents) with precomputed SPRT
+ *
+ * @example
+ * ```ts
+ * const data = await fetchPrincipalQuery({
+ *   principalId: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchPrincipalQuery<S extends PrincipalSelect>(params: {
+    principalId: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalSelect>;
+}): Promise<{
+    principal: InferSelectResult<PrincipalWithRelations, S> | null;
+}>;
+/**
+ * Scoped sub-identities (API keys and agents) with precomputed SPRT
+ *
+ * @example
+ * ```ts
+ * await prefetchPrincipalQuery(queryClient, { principalId: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchPrincipalQuery<S extends PrincipalSelect>(queryClient: QueryClient, params: {
+    principalId: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, PrincipalSelect>;
+}): Promise<void>;

package/esm/auth/hooks/queries/usePrincipalQuery.js

@@ -0,0 +1,47 @@
+/**
+ * Scoped sub-identities (API keys and agents) with precomputed SPRT
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { principalKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const principalQueryKey = principalKeys.detail;
+export function usePrincipalQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: principalKeys.detail(params.principalId),
+        queryFn: () => getClient()
+            .principal.findOne({
+            principalId: params.principalId,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchPrincipalQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .principal.findOne({
+        principalId: params.principalId,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchPrincipalQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: principalKeys.detail(params.principalId),
+        queryFn: () => getClient()
+            .principal.findOne({
+            principalId: params.principalId,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}