vscode-apollo 2.5.6 → 2.6.1

package/sampleWorkspace/connectors-community/connectors/jira/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:
+  subgraphs:
+    connector:
+      $config:
+        apiKey: ${env.API_KEY}

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

@@ -0,0 +1,6 @@
+federation_version: =2.11.0
+subgraphs:
+  connector:
+    routing_url: http://connector
+    schema:
+      file: connector.graphql

package/sampleWorkspace/connectors-community/connectors/museums/README.md

@@ -0,0 +1,40 @@
+# Public Art Museum REST Connector
+
+This connector currently contains subgraphs schemas for:
+
+[The Art Institute of Chicago API](https://api.artic.edu/docs/#introduction)
+[The Metropolitan Museum of Art](https://metmuseum.github.io/?ref=public_apis&utm_medium=website)
+
+These Apis are public and free to use, see the respective documentaiton for more information about usage and limitations.
+
+These subgraph files are complimentary but do not depend on each other, they can be used independently.
+
+## Additional Setup for VS Code Task runner
+
+Edit your `.vscode/settings.json` to include the following keys:
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": {
+        "APOLLO_KEY": "",
+        ...
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+```
+
+Once you've set this up, you can execute the `Tasks: Run Task` command in VS Code to run the `rover dev` task.
+Alternatively, you can open a new terminal window in VS Code with the `graphos` profile, then run `rover dev --supergraph-config supergraph.yaml`.
+
+## Contributing
+
+Other Art Museums with public apis are good candidates to contribute to this schema.
+
+1. Add a schema designed for the module as a new `.graphql` file.
+2. Update the `supergraph.yaml` file accordingly.

package/sampleWorkspace/connectors-community/connectors/museums/chicagoArt.graphql

@@ -0,0 +1,150 @@
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.11", import: ["@key", "@external", "@provides"]) # 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 api is blocked on localhost without a user agent header, it can be any value you like
+  @source(
+    name: "artic"
+    http: {
+      baseURL: "https://api.artic.edu/api/v1/"
+      headers: [
+        { name: "Content-Type", value: "application/json" }
+        { name: "User-Agent", value: "Apollo-Connect" }
+      ]
+    }
+  )
+
+type Query {
+  # Fetch artworks by artist name or title or general term like sunflowers
+  searchArtwork(searchTerm: String!, limit: Int = 5): ArtworkSearchResponse
+    @connect(
+      source: "artic"
+      http: { GET: "artworks/search?q={$args.searchTerm}&limit={$args.limit}" }
+      selection: """
+      pagination {
+        limit
+        totalPages: total_pages
+        currentPage: current_page
+      }
+      data {
+        id
+        apiModel: api_model
+        title
+        thumbnail {
+          imgData: lqip
+          width
+          height
+          altText: alt_text
+        }
+        timestamp
+      }
+      info {
+        licenseText: license_text
+        licenseLinks: license_links
+        version
+      }
+      """
+    )
+
+  searchArtworkById(artId: String!): ArtworkDetailResponse
+    @connect(
+      source: "artic"
+      http: { GET: "artworks/{$args.artId}" }
+      selection: """
+      data {
+        id
+        apiModel: api_model
+        title
+        thumbnail {
+          imgData: lqip
+          width
+          height
+          altText: alt_text
+        }
+        dateStart: date_start
+        dateEnd: date_end
+        dateDisplay: date_display
+        artistDisplay: artist_display
+        placeOfOrigin: place_of_origin
+        description
+        dimensions
+        mediumDisplay: medium_display
+        inscriptions
+        artworkTypeTitle: artwork_type_title
+        departmentTitle: department_title
+        artistTitle: artist_title
+        styleTitle: style_title
+        timestamp
+      }
+      info {
+        licenseText: license_text
+        licenseLinks: license_links
+        version
+      }
+      """
+    )
+}
+
+type ArtworkSearchResponse {
+  pagination: Pagination
+  data: [Artwork]
+  info: Info
+}
+
+type ArtworkDetailResponse {
+  data: ArtworkDetail
+  info: Info
+}
+
+type Artwork {
+  id: ID!
+  apiModel: String
+  title: String
+  thumbnail: Thumbnail
+  timestamp: String
+}
+
+type ArtworkDetail {
+  id: ID!
+  apiModel: String
+  title: String
+  thumbnail: Thumbnail
+  timestamp: String
+  
+  # Detail-specific fields
+  dateStart: Int
+  dateEnd: Int
+  dateDisplay: String
+  artistDisplay: String
+  placeOfOrigin: String
+  description: String
+  dimensions: String
+  mediumDisplay: String
+  inscriptions: String
+  artworkTypeTitle: String
+  departmentTitle: String
+  artistTitle: String 
+  styleTitle: String
+}
+
+type Thumbnail {
+  imgData: String
+  width: Int
+  height: Int
+  altText: String
+}
+
+type Pagination {
+  limit: Int
+  totalPages: Int
+  currentPage: Int
+}
+
+type Info {
+  licenseText: String
+  licenseLinks: [String]
+  version: String
+}

package/sampleWorkspace/connectors-community/connectors/museums/met.graphql

@@ -0,0 +1,119 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.11"
+    import: ["@key", "@external", "@provides", "@shareable"]
+  ) # 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 api is blocked on localhost without a user agent header, it can be any value you like
+  @source(
+    name: "metmuseum"
+    http: {
+      baseURL: "https://collectionapi.metmuseum.org/public/collection/v1/"
+    }
+  )
+
+type Query {
+  # Search for artworks by natural language, returns an array of iDs
+  getMetArtworkIds(searchTerm: String!): ArtworkSearchResult
+    @connect(
+      source: "metmuseum"
+      http: { GET: "search?q={$args.searchTerm}" }
+      selection: """
+      total
+      objectIDs
+      """
+    )
+
+  
+  # Direct query by specific ID 
+  getMetArtworkDetailsById(objectId: Int!): ArtworkDetails
+    @connect(
+      source: "metmuseum"
+      http: { GET: "objects/{$args.objectId}" }
+      selection: """
+              objectID
+      accessionYear
+      isPublicDomain
+      primaryImage
+      additionalImages
+      department
+      objectName
+      title
+      artistDisplayName
+      artistDisplayBio
+      artistNationality
+      artistBeginDate
+      artistEndDate
+      artistGender
+      artistWikidata: artistWikidata_URL
+      objectDate
+      objectBeginDate
+      objectEndDate
+      medium
+      classification
+      objectURL
+      """
+    )
+}
+
+type ArtworkSearchResult {
+  total: Int
+  objectIDs: [Int]
+  # Automatically fetch the first artwork details
+  firstArtwork: ArtworkDetails
+    @connect(
+      source: "metmuseum"
+      http: { GET: "objects/{$this.objectIDs->first}" }
+      selection: """
+      objectID
+      accessionYear
+      isPublicDomain
+      primaryImage
+      additionalImages
+      department
+      objectName
+      title
+      artistDisplayName
+      artistDisplayBio
+      artistNationality
+      artistBeginDate
+      artistEndDate
+      artistGender
+      artistWikidata: artistWikidata_URL
+      objectDate
+      objectBeginDate
+      objectEndDate
+      medium
+      classification
+      objectURL
+      """
+    )
+}
+
+
+type ArtworkDetails @shareable {
+  objectID: Int
+  accessionYear: String
+  isPublicDomain: Boolean
+  primaryImage: String
+  additionalImages: [String]
+  department: String
+  objectName: String
+  title: String
+  artistDisplayName: String 
+  artistDisplayBio: String
+  artistNationality: String
+  artistBeginDate: Int
+  artistEndDate: Int
+  artistGender: String
+  artistWikidata: String
+  objectDate: String
+  objectBeginDate: Int
+  objectEndDate: Int
+  medium: String
+  classification: String
+  objectURL: String
+}

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

@@ -0,0 +1,10 @@
+subgraphs:
+  aic:
+    routing_url: http://aic
+    schema:
+      file: chicagoArt.graphql
+  met:
+    routing_url: http://met
+    schema:
+      file: metMuseum.graphql
+federation_version: =2.11.0

package/sampleWorkspace/connectors-community/connectors/nws/README.md

@@ -0,0 +1,45 @@
+# NWS COnnector
+
+This connector implements NWS APIs.
+
+## Prerequisites
+
+NWS maintains free to access APIs that enforce their own rate limits. 
+[NWS API Documentation](https://api.weather.gov/)
+
+It is required to have a user-agent header with the best practice of adding contact information in the case of a security event. [See more information here](https://www.weather.gov/documentation/services-web-api)
+
+## Getting Started
+
+1. Create an [Apollo Studio](https://studio.apollographql.com/) account. This will provide the abilty to create and manage your graph including necesary credentials APOLLO_KEY and APOLLO_GRAPH_REF
+2. [Install](https://www.apollographql.com/docs/rover/getting-started#installation-methods) and [authenticate](https://www.apollographql.com/docs/rover/configuring) Rover CLI to configure your graph and run locally.
+3. Run `rover init` to generate a new connector.  See the [Rover CLI documentation](https://www.apollographql.com/docs/rover) for more information and commands.
+
+
+## Additional Setup for VS Code Task runner
+
+Edit your `.vscode/settings.json` to include the following keys:
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": {
+        "API_KEY": "",
+        "APOLLO_KEY": "",
+        ...
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+```
+
+Once you've set this up, you can execute the `Tasks: Run Task` command in VS Code to run the `rover dev` task.
+Alternatively, you can open a new terminal window in VS Code with the `graphos` profile, then run `rover dev --supergraph-config supergraph.yaml --router-config router.yaml`.
+
+## Contributing
+
+If you are interested in contributing to this or other connectors we welcome contributions. PLease see the [contributing guide](https://github.com/apollographql/connectors-community?tab=readme-ov-file#contributing-a-connector-to-the-community) for more information