Search Engine Site (GraphQL-based) in TypeScript and NestJS

This is a search engine site built using TypeScript and NestJS, with a GraphQL API. The application allows users to search for content and retrieve relevant results. It utilizes the power of GraphQL for efficient querying and retrieving data from various sources.

Features

Search for content using keywords or phrases
Retrieve relevant search results based on the query
Support for advanced search filters and sorting options
Pagination for browsing through search results
Integration with various data sources for retrieving content
Full-text search capabilities for accurate and fast results
User authentication and authorization for personalized search experiences
Filters could be these things : (Category or Type : string , Date Range : {from : Time , to : Time} , Location : string, Price Range : {from : number, to : number} , Rating or Reviews : )

Requirements

Node.js (v12 or above)
TypeScript (v4 or above)
NestJS (v8 or above)
MongoDB or any other supported database for data storage

Getting Started

Clone the repository:

https://github.com/BaseMax/GoogleCloneGraphQLTS
cd GoogleCloneGraphQLTS

Install the dependencies:

npm install

Configure the environment variables:

Rename the .env.example file to .env.
Modify the values in the .env file according to your setup.
Ensure you provide the necessary credentials and configurations for the database.
Build the application:

npm run build

GraphQL

Queries

search(query: String!, filters: SearchFilters, pagination: PaginationInput): SearchResult: Retrieves search results based on the provided query string and optional filters and pagination.
getSearchResult(id: ID!): SearchResult: Retrieves a specific search result by its unique identifier.
getUserSearchHistory(userId: ID!): [SearchHistory]: Retrieves the search history of a specific user.
getPopularSearches: [String]: Retrieves a list of popular search terms or queries.

Mutations

createUserSearchHistory(userId: ID!, query: String!): SearchHistory: Creates a new search history entry for a user with the provided query string.
clearUserSearchHistory(userId: ID!): Boolean: Clears the search history of a specific user.
createSearchResult(title: String!, url: String!, description: String!): SearchResult: Creates a new search result with the provided title, URL, and description.
updateSearchResult(id: ID!, title: String, url: String, description: String): SearchResult: Updates an existing search result identified by its unique identifier with the provided fields.
deleteSearchResult(id: ID!): Boolean: Deletes a search result identified by its unique identifier.

GraphQL Examples

search(query: String!, filters: SearchFilters, pagination: PaginationInput): SearchResult

Example usage:

query {
  search(query: "cat videos", filters: { category: "videos" }, pagination: { page: 1, limit: 10 }) {
    totalCount
    results {
      id
      title
      url
      description
    }
  }
}

getSearchResult(id: ID!): SearchResult

Example usage:

query {
  getSearchResult(id: "abc123") {
    id
    title
    url
    description
  }
}

getUserSearchHistory(userId: ID!): [SearchHistory]

Example usage:

query {
  getUserSearchHistory(userId: "user123") {
    id
    query
    createdAt
  }
}

getPopularSearches: [String]

Example usage:

query {
  getPopularSearches
}

createUserSearchHistory(userId: ID!, query: String!): SearchHistory

Example usage:

mutation {
  createUserSearchHistory(userId: "user123", query: "kittens") {
    id
    query
    createdAt
  }
}

clearUserSearchHistory(userId: ID!): Boolean

Example usage:

mutation {
  clearUserSearchHistory(userId: "user123")
}

createSearchResult(title: String!, url: String!, description: String!): SearchResult

Example usage:

mutation {
  createSearchResult(title: "Funny Cat Videos", url: "https://example.com/videos", description: "Watch hilarious cat videos!") {
    id
    title
    url
    description
  }
}

updateSearchResult(id: ID!, title: String, url: String, description: String): SearchResult

Example usage:

mutation {
  updateSearchResult(id: "abc123", title: "New Title") {
    id
    title
    url
    description
  }
}

deleteSearchResult(id: ID!): Boolean

Example usage:

mutation {
  deleteSearchResult(id: "abc123")
}