vscode-apollo 2.5.6 → 2.6.0

package/sampleWorkspace/connectors-community/connectors/googlemaps/places.graphql

@@ -0,0 +1,399 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.11"
+    import: ["@key", "@shareable", "@external"]
+  ) # Enable this schema to use Apollo Federation features
+  @link( # Enable this schema to use Apollo Connectors
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@connect", "@source"]
+  )
+ 
+ #this connector uses the legacy places API.  To enable this in Google, you must create an API key and give permissions to this API
+  @source(
+    name: "places"
+    http: {
+      baseURL: "https://places.googleapis.com/v1/places"
+      headers: [
+        {
+          name: "X-Goog-Api-Key"
+          value: "{$config.GOOGLE_MAPS_API_KEY}"
+        }
+      ]
+    }
+  )
+
+type Query {
+  """
+  search for a place using natural language such as 'Baltimore' or 'museum Chicago'
+  """
+  searchForPlace(query: String): [Place]
+    @connect(
+      source: "places"
+      http: {
+        POST: "/:searchText"
+        body: """
+        textQuery: $args.query
+        """
+        headers: [
+          {
+            name: "X-Goog-FieldMask"
+            value: "nextPageToken,places.attributions,places.id,places.name,places.accessibilityOptions,places.addressComponents,places.addressDescriptor,places.adrFormatAddress,places.businessStatus,places.containingPlaces,places.displayName,places.formattedAddress,places.googleMapsLinks,places.googleMapsUri,places.iconBackgroundColor,places.iconMaskBaseUri,places.location,places.photos,places.plusCode,places.postalAddress,places.primaryType,places.primaryTypeDisplayName,places.pureServiceAreaBusiness,places.shortFormattedAddress,places.subDestinations,places.types,places.utcOffsetMinutes,places.viewport,places.currentOpeningHours,places.currentSecondaryOpeningHours,places.internationalPhoneNumber,places.nationalPhoneNumber,places.priceLevel,places.priceRange,places.rating,places.regularOpeningHours,places.regularSecondaryOpeningHours,places.userRatingCount,places.websiteUri"
+          }
+        ]
+      }
+      selection: """
+       $.places {
+        name
+        id
+        types
+        nationalPhoneNumber
+        internationalPhoneNumber
+        formattedAddress
+        addressComponents {
+          longText
+          shortText
+          types
+          languageCode
+        }
+        plusCode {
+          globalCode
+          compoundCode
+        }
+        location {
+          latitude
+          longitude
+        }
+        viewport {
+          low {
+            latitude
+            longitude
+          }
+          high {
+            latitude
+            longitude
+          }
+        }
+        priceLevel
+        rating
+        googleMapsUri
+        websiteUri
+        regularOpeningHours {
+          openNow
+          periods {
+            open {
+              day
+              hour
+              minute
+            }
+            close {
+              day
+              hour
+              minute
+            }
+          }
+          weekdayDescriptions
+          nextCloseTime
+        }
+        utcOffsetMinutes
+        adrFormatAddress
+        businessStatus
+        userRatingCount
+        iconMaskBaseUri
+        iconBackgroundColor
+        displayName {
+          text
+          languageCode
+        }
+        primaryTypeDisplayName {
+          text
+          languageCode
+        }
+        currentOpeningHours {
+          openNow
+          periods {
+            open {
+              day
+              hour
+              minute
+              date {
+                year
+                month
+                day
+              }
+            }
+            close {
+              day
+              hour
+              minute
+              date {
+                year
+                month
+                day
+              }
+            }
+          }
+          weekdayDescriptions
+          nextCloseTime
+        }
+        primaryType
+        shortFormattedAddress
+        reviews {
+          name
+          relativePublishTimeDescription
+          rating
+          text {
+            text
+            languageCode
+          }
+          originalText {
+            text
+            languageCode
+          }
+          authorAttribution {
+            displayName
+            uri
+            photoUri
+          }
+          publishTime
+          flagContentUri
+          googleMapsUri
+        }
+        photos {
+          name
+          widthPx
+          heightPx
+          authorAttributions {
+            displayName
+            uri
+            photoUri
+          }
+          flagContentUri
+          googleMapsUri
+          url: authorAttributions->first.photoUri
+        }
+        paymentOptions {
+          acceptsDebitCards
+          acceptsCashOnly
+        }
+        accessibilityOptions {
+          wheelchairAccessibleParking
+          wheelchairAccessibleEntrance
+          wheelchairAccessibleRestroom
+        }
+        generativeSummary {
+          overview {
+            text
+            languageCode
+          }
+          overviewFlagContentUri
+          disclosureText {
+            text
+            languageCode
+          }
+        }
+        addressDescriptor {
+          landmarks {
+            name
+            placeId
+            displayName {
+              text
+              languageCode
+            }
+            types
+            straightLineDistanceMeters
+            travelDistanceMeters
+          }
+          areas {
+            name
+            placeId
+            displayName {
+              text
+              languageCode
+            }
+            containment
+          }
+        }
+        googleMapsLinks {
+          directionsUri
+          placeUri
+          writeAReviewUri
+          reviewsUri
+          photosUri
+        }
+      }
+      """
+    )
+}
+type Place @key(fields: "id"){
+  name: String
+  id: String
+  types: [String]
+  priceLevel: String
+  nationalPhoneNumber: String
+  internationalPhoneNumber: String
+  formattedAddress: String
+  addressComponents: [AddressComponent]
+  plusCode: PlusCode
+  location: Location
+  viewport: Viewport
+  rating: Float
+  googleMapsUri: String
+  websiteUri: String
+  regularOpeningHours: OpeningHours
+  utcOffsetMinutes: Int
+  adrFormatAddress: String
+  businessStatus: String
+  userRatingCount: Int
+  iconMaskBaseUri: String
+  iconBackgroundColor: String
+  displayName: LocalizedText
+  primaryTypeDisplayName: LocalizedText
+  currentOpeningHours: OpeningHoursWithPeriods
+  primaryType: String
+  shortFormattedAddress: String
+  reviews: [Review]
+  photos: [Photo]
+  paymentOptions: PaymentOptions
+  accessibilityOptions: AccessibilityOptions
+  generativeSummary: GenerativeSummary
+  addressDescriptor: AddressDescriptor
+  googleMapsLinks: GoogleMapsLinks
+  details: String
+    @connect(
+      source: "places"
+      http: {
+        GET: "/{$this.id}/"
+        headers: [
+          {
+            name: "X-Goog-FieldMask"
+            value: "photos"
+          }
+        ]
+      }
+      selection: """
+      $.result
+      """
+    )
+}
+type AddressComponent {
+  longText: String
+  shortText: String
+  types: [String]
+  languageCode: String
+}
+type PlusCode {
+  globalCode: String
+  compoundCode: String
+}
+type Location {
+  latitude: Float
+  longitude: Float
+}
+type Viewport {
+  low: Location
+  high: Location
+}
+type OpeningHours {
+  openNow: Boolean
+  periods: [OpeningPeriod]
+  weekdayDescriptions: [String]
+  nextCloseTime: String
+}
+type OpeningPeriod {
+  open: OpeningTime
+  close: OpeningTime
+}
+type OpeningTime {
+  day: Int
+  hour: Int
+  minute: Int
+}
+type Date {
+  year: Int
+  month: Int
+  day: Int
+}
+type LocalizedText {
+  text: String
+  languageCode: String
+}
+type OpeningHoursWithPeriods {
+  openNow: Boolean
+  periods: [OpeningPeriodWithDate]
+  weekdayDescriptions: [String]
+  nextCloseTime: String
+}
+type OpeningPeriodWithDate {
+  open: OpeningTimeWithDate
+  close: OpeningTimeWithDate
+}
+type OpeningTimeWithDate {
+  day: Int
+  hour: Int
+  minute: Int
+  date: Date
+}
+type Review {
+  name: String
+  relativePublishTimeDescription: String
+  rating: Float
+  text: LocalizedText
+  originalText: LocalizedText
+  authorAttribution: AuthorAttribution
+  publishTime: String
+  flagContentUri: String
+  googleMapsUri: String
+}
+type AuthorAttribution {
+  displayName: String
+  uri: String
+  photoUri: String
+}
+type Photo {
+  name: String
+  widthPx: Int
+  heightPx: Int
+  authorAttributions: [AuthorAttribution]
+  flagContentUri: String
+  googleMapsUri: String
+  url: String
+}
+type PaymentOptions {
+  acceptsDebitCards: Boolean
+  acceptsCashOnly: Boolean
+}
+type AccessibilityOptions {
+  wheelchairAccessibleParking: Boolean
+  wheelchairAccessibleEntrance: Boolean
+  wheelchairAccessibleRestroom: Boolean
+}
+type GenerativeSummary {
+  overview: LocalizedText
+  overviewFlagContentUri: String
+  disclosureText: LocalizedText
+}
+type AddressDescriptor {
+  landmarks: [Landmark]
+  areas: [Area]
+}
+type Landmark {
+  name: String
+  placeId: String
+  displayName: LocalizedText
+  types: [String]
+  straightLineDistanceMeters: Float
+  travelDistanceMeters: Float
+}
+type Area {
+  name: String
+  placeId: String
+  displayName: LocalizedText
+  containment: String
+}
+type GoogleMapsLinks {
+  directionsUri: String
+  placeUri: String
+  writeAReviewUri: String
+  reviewsUri: String
+  photosUri: String
+}

package/sampleWorkspace/connectors-community/connectors/googlemaps/router.yaml

@@ -0,0 +1,18 @@
+supergraph:
+  listen: 0.0.0.0:${env.PORT:-4000}
+
+headers:
+  all:
+    request:
+      - propagate:
+          matching: .*
+telemetry:
+  instrumentation:
+    spans: 
+      mode: spec_compliant
+
+connectors:
+  sources:
+    places.places:
+      $config:
+        GOOGLE_MAPS_API_KEY: ${env.GOOGLE_MAPS_API_KEY}

package/sampleWorkspace/connectors-community/connectors/googlemaps/supergraph.yaml

@@ -0,0 +1,18 @@
+subgraphs:
+  # places-legacy:
+  #   routing_url: http://places
+  #   schema:
+  #     file: places-legacy.graphql
+  places:
+    routing_url: http://places
+    schema:
+      file: places.graphql
+  distance:
+    routing_url: http://distancematrix
+    schema:
+      file: distancematrix.graphql
+  timezone:
+    routing_url: http://timezone
+    schema:
+      file: timezone.graphql
+federation_version: =2.11.0

package/sampleWorkspace/connectors-community/connectors/googlemaps/timezone.graphql

@@ -0,0 +1,64 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.11"
+    import: ["@key", "@shareable", "@external", "@requires"]
+  ) # Enable this schema to use Apollo Federation features
+  @link( # Enable this schema to use Apollo Connectors
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@connect", "@source"]
+  )
+
+  #this connector uses the legacy timezone API.  To enable this in Google, you must create an API key and give permissions to this API
+
+    @source(
+        name: "timezone"
+        http: { baseURL: "https://maps.googleapis.com/maps/api/timezone/" }
+    )
+
+type Query {
+  # Optional fallback query
+  timezoneByCoords(lat: Float!, lng: Float!, timestamp: Int!): TimezoneInfo
+    @connect(
+      source: "timezone"
+      http: {
+        GET: "json?location={$args.lat},{$args.lng}&timestamp={$args.timestamp}&key=YOUR_API_KEY"
+      }
+      selection: """
+        timeZoneId
+        timeZoneName
+        rawOffset
+        dstOffset
+      """
+    )
+}
+
+type TimezoneInfo {
+  timeZoneId: String
+  timeZoneName: String
+  rawOffset: Int
+  dstOffset: Int
+}
+
+type Place @key(fields: "id", resolvable: false) {
+  id: String @external
+  location: Location @external
+  timezone(timestamp: Int!): TimezoneInfo
+   @requires(fields: "location { latitude longitude }")
+    @connect(
+      source: "timezone"
+      http: {
+        GET: "json?location={$this.location.latitude},{$this.location.longitude}&timestamp={$args.timestamp}&key=YOUR_API_KEY"
+      }
+      selection: """
+        timeZoneId
+        timeZoneName
+        rawOffset
+        dstOffset
+      """
+    )
+}
+
+type Location {
+  latitude: Float @external
+  longitude: Float @external
+}

package/sampleWorkspace/connectors-community/connectors/heygen/README

@@ -0,0 +1,105 @@
+# HeyGen REST Connector
+
+This connector provides a GraphQL interface to HeyGen's REST API for AI video generation and avatar services. Currently implemented features include:
+
+- Photo Avatar Management
+- Avatar Management
+- More modules coming soon...
+
+## Features
+
+- 🎯 **Type Safety** - Full GraphQL schema with proper types and scalars
+- 🔄 **API Versioning** - Support for HeyGen API v2
+- 📦 **Modular** - Separate schema files for different API domains
+- 🚀 **Production Ready** - Optimized for production use
+
+## Setup
+
+### Environment Variables
+
+You'll need to set up the following environment variables:
+
+```bash
+HEYGEN_API_KEY=your_api_key_here
+```
+
+### VS Code Integration
+
+Edit your `.vscode/settings.json` to include the HeyGen specific configuration:
+
+```json
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": {
+        "APOLLO_KEY": "Your Key",
+        "APOLLO_GRAPH_REF": "your graph ref",
+        "APOLLO_ROVER_DEV_ROUTER_VERSION": "2.0.0-preview.3",
+        "HEYGEN_API_KEY": "Your HeyGen API Key"
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+```
+
+## Usage
+
+You can start the development server using either:
+
+1. VS Code Task Runner:
+
+   - Execute the "Tasks: Run Task" command
+   - Select the `rover dev` task
+
+2. Terminal:
+   ```bash
+   rover dev --supergraph-config supergraph.yaml --router-config router.yaml
+   ```
+
+## Implemented Modules
+
+### Photo Avatars (`photo-avatars.graphql`)
+
+- Generate photo-based avatars
+- Create and manage avatar groups
+- Add motion and sound effects
+- Train avatar models
+- Generate different looks
+
+### Avatars (`avatars.graphql`)
+
+- List available avatars
+- Manage avatar groups
+- Query avatar details
+
+## Planned Modules
+
+The following API domains are planned for future implementation:
+
+- Video Generation
+- Video Translation
+- Voice Management
+- Template Management
+- User Management
+- Asset Management
+- Interactive Avatars
+
+## Contributing
+
+To add a new API module:
+
+1. Create a new `.graphql` file for the module
+2. Add necessary configurations to `router.yaml` and `supergraph.yaml`
+3. Follow the existing patterns for:
+   - Type safety using proper scalars
+   - Input type usage for mutations
+   - Consistent error handling
+   - Documentation and descriptions
+
+## Resources
+
+- [HeyGen API Documentation](https://docs.heygen.com/docs)
+- [HeyGen TypeScript SDK](https://heygen.teamduality.dev/)

package/sampleWorkspace/connectors-community/connectors/heygen/avatars.graphql

@@ -0,0 +1,79 @@
+# These are the necessary federation and connector directives you will be using
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.10")
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@connect", "@source"]
+  )
+  # A @source directive defines a shared data source for multiple connectors.
+
+  @source(
+    name: "heygen-v2"
+    http: {
+      baseURL: "https://api.heygen.com/v2"
+      headers: [{ name: "X-API-KEY", value: "{$config.apiKey}" }]
+    }
+  )
+
+scalar Timestamp
+
+enum GroupType {
+  PUBLIC_PHOTO
+  PRIVATE
+}
+
+enum TrainStatus {
+  empty
+}
+
+type Avatar {
+  id: ID!
+  name: String
+  gender: String
+  previewImageUrl: String
+  previewVideoUrl: String
+}
+
+type AvatarGroup {
+  id: ID!
+  name: String!
+  createdAt: Timestamp
+  numLooks: Int
+  previewImageUrl: String
+  groupType: GroupType
+  trainStatus: TrainStatus
+}
+
+type Query {
+  listAvatars: [Avatar!]!
+    @connect(
+      source: "heygen-v2"
+      http: { GET: "/avatars" }
+      selection: """
+      $.data.avatars {
+        id: avatar_id
+        name: avatar_name
+        gender
+        previewImageUrl: preview_image_url
+        previewVideoUrl: preview_video_url
+      }
+      """
+    )
+
+  listAvatarGroups(includePublic: Boolean = false): [AvatarGroup!]!
+    @connect(
+      source: "heygen-v2"
+      http: { GET: "/avatar_group.list?include_public={$args.includePublic}" }
+      selection: """
+      $.data.avatar_group_list {
+        id
+        name
+        createdAt: created_at
+        numLooks: num_looks
+        previewImageUrl: preview_image_url
+        groupType: group_type
+        trainStatus: train_status
+      }
+      """
+    )
+}