Merge branch 'next' into T-23255/js-actions-add-username-mutations

packages/client/src/actions/timeline.ts

@@ -32,7 +32,7 @@ export function fetchTimeline(
 }
 
 /**
- * Fetch fetchTimelineHighlights from an account.
+ * Fetch Timeline Highlights for an account.
  *
  * ```ts
  * const result = await fetchTimelineHighlights(anyClient, {

packages/client/src/actions/username.ts

@@ -5,17 +5,25 @@ import type {
   CreateUsernameResult,
   UnassignUsernameFromAccountRequest,
   UnassignUsernameToAccountResult,
+  Username,
+  UsernameRequest,
+  UsernamesRequest,
 } from '@lens-protocol/graphql';
 import {
   AssignUsernameToAccountMutation,
   CreateUsernameMutation,
   UnassignUsernameFromAccountMutation,
+  UsernameQuery,
+  UsernamesQuery,
 } from '@lens-protocol/graphql';
 import type { ResultAsync } from '@lens-protocol/types';
 
 import type { SessionClient } from '../clients';
 import type { UnauthenticatedError, UnexpectedError } from '../errors';
 
+import type { AnyClient } from '../clients';
+import type { Paginated } from '../types';
+
 /**
  * Create a username
  *
@@ -81,3 +89,43 @@ export function unassignUsernameFromAccount(
 ): ResultAsync<UnassignUsernameToAccountResult, UnauthenticatedError | UnexpectedError> {
   return client.query(UnassignUsernameFromAccountMutation, { request });
 }
+
+/**
+ * Fetch username details.
+ *
+ * ```ts
+ * const result = await fetchUsername(anyClient, {
+ *   username: { localName: 'wagmi' },
+ * });
+ * ```
+ *
+ * @param client - Any Lens client.
+ * @param request - The query request.
+ * @returns The username details.
+ */
+export function fetchUsername(
+  client: AnyClient,
+  request: UsernameRequest,
+): ResultAsync<Username | null, UnexpectedError> {
+  return client.query(UsernameQuery, { request });
+}
+
+/**
+ * Fetch usernames owned by an address.
+ *
+ * ```ts
+ * const result = await fetchUsernames(anyClient, {
+ *   owner: evmAddress('0xe2f2a5C287993345a840db3B0845fbc70f5935a5'),
+ * });
+ * ```
+ *
+ * @param client - Any Lens client.
+ * @param request - The query request.
+ * @returns The list of owned usernames.
+ */
+export function fetchUsernames(
+  client: AnyClient,
+  request: UsernamesRequest,
+): ResultAsync<Paginated<Username> | null, UnexpectedError> {
+  return client.query(UsernamesQuery, { request });
+}

packages/graphql/src/fragments/index.ts

@@ -7,3 +7,4 @@ export * from './SponsoredTransactionRequest';
 export * from './SelfFundedTransactionRequest';
 export * from './TransactionWillFail';
 export * from './username';
+export * from './namespace';

packages/graphql/src/fragments/namespace.ts

@@ -0,0 +1,27 @@
+import type { FragmentOf } from 'gql.tada';
+import { graphql } from '../graphql';
+
+export const UsernameNamespace = graphql(
+  `fragment UsernameNamespace on UsernameNamespace {
+      __typename
+      address
+      namespace
+      createdAt
+      metadata {
+        __typename
+        description
+        id
+      }
+      owner
+      # TODO: Implement rules
+      # rules {
+      #   anyOf {
+      #     ...RULE
+      #   }
+      #   required {
+      #     ...RULE
+      #   }
+      # }
+    }`,
+);
+export type UsernameNamespace = FragmentOf<typeof UsernameNamespace>;

packages/graphql/src/fragments/username.ts

@@ -1,22 +1,20 @@
 import type { FragmentOf } from 'gql.tada';
 import { graphql } from '../graphql';
+import { UsernameNamespace } from './namespace';
 
-export const Username = graphql(`
-    fragment Username on Username {
+export const Username = graphql(
+  `fragment Username on Username {
       __typename
       id
       value
-      namespace {
-        address
-        namespace
-        metadata {
-          description
-          id
-        }
-      }
+      localName
       linkedTo
       ownedBy
       timestamp
-    }
-  `);
+      namespace {
+        ...UsernameNamespace
+      }
+  }`,
+  [UsernameNamespace],
+);
 export type Username = FragmentOf<typeof Username>;

packages/graphql/src/username.ts

@@ -1,8 +1,10 @@
 import type { FragmentOf } from 'gql.tada';
 import {
+  PaginatedResultInfo,
   SelfFundedTransactionRequest,
   SponsoredTransactionRequest,
   TransactionWillFail,
+  Username,
 } from './fragments';
 import { type RequestOf, graphql } from './graphql';
 
@@ -133,3 +135,29 @@ export const UnassignUsernameFromAccountMutation = graphql(
 export type UnassignUsernameFromAccountRequest = RequestOf<
   typeof UnassignUsernameFromAccountMutation
 >;
+
+export const UsernameQuery = graphql(
+  `query Username($request: UsernameRequest!) {
+    value: username(request: $request) {
+      ...Username
+    }
+  }`,
+  [Username],
+);
+export type UsernameRequest = RequestOf<typeof UsernameQuery>;
+
+export const UsernamesQuery = graphql(
+  `query Usernames($request: UsernamesRequest!) {
+    value: usernames(request: $request) {
+      __typename
+      items {
+        ...Username
+      }
+      pageInfo {
+        ...PaginatedResultInfo
+      }
+    }
+  }`,
+  [Username, PaginatedResultInfo],
+);
+export type UsernamesRequest = RequestOf<typeof UsernamesQuery>;