vscode-apollo 2.5.5 → 2.6.0

package/sampleWorkspace/connectors-community/connectors/twilio/messages.graphql

@@ -0,0 +1,107 @@
+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"]
+  )
+  @source(
+    name: "twilio"
+    http: {
+      baseURL: "https://api.twilio.com/2010-04-01/Accounts/<YOUR_ACCOUNT_ID>/"
+      headers: [
+        {
+          name: "Authorization"
+          value: "Basic {$config.twilioKey}" # Base64(AccountSID:AuthToken)
+        }
+        { name: "Content-Type", value: "application/x-www-form-urlencoded" }
+      ]
+    }
+  )
+
+#this mutation allows you to send to Twilio or personal verified phone numbers
+type Mutation {
+  sendSMS(to: String!, body: String!): SmsResponse
+    @connect(
+      source: "twilio"
+      http: {
+        POST: "Messages.json"
+        body: """
+        MessagingServiceSid: $('<YOUR_MESSAGING_SERVICE_SID>')
+        To: $args.to
+        Body: $args.body
+        """
+      }
+      selection: """
+      sid
+      to
+      from
+      body
+      status
+      """
+      errors: { message: "$.message" }
+    )
+}
+
+#this query retrieves the last 5 messages sent or received from your Twilio account
+type Query {
+  recentMessages(pageSize: Int=5): [SMSLog]
+    @connect(
+      source: "twilio"
+      http: { GET: "Messages.json?PageSize={$args.pageSize}" }
+      selection: """
+      $.messages{
+      accountSid: account_sid
+       apiVersion: api_version
+       body
+       dateCreated: date_created
+       dateSent: date_sent
+       dateUpdated: date_updated
+       direction
+       errorCode: error_code
+       errorMessage: error_message
+       from
+       messagingServiceSid: messaging_service_sid
+       numMedia: num_media
+       numSegments: num_segments
+       price
+       priceUnit: price_unit
+       sid
+       status
+       to
+       uri
+       }
+      """
+    )
+}
+
+type SmsResponse {
+  sid: String
+  to: String
+  from: String
+  body: String
+  status: String
+}
+type SMSLog {
+  accountSid: String
+  apiVersion: String
+  body: String
+  dateCreated: String
+  dateSent: String
+  dateUpdated: String
+  direction: String
+  errorCode: Int
+  errorMessage: String
+  from: String
+  messagingServiceSid: String
+  numMedia: Int
+  numSegments: Int
+  price: Float
+  priceUnit: String
+  sid: String
+  status: String
+  to: String
+  uri: String
+}

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

@@ -0,0 +1,6 @@
+#this value should be a Base64 encoded string comprised of your twilioAcctID:authToken
+connectors:
+  subgraphs:
+    messages:
+      $config:
+        apiKey: ${env.twilioKey}

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

@@ -0,0 +1,6 @@
+subgraphs:
+  twilio:
+    routing_url: http://localhost:4000
+    schema:
+      file: messages.graphql
+federation_version: =2.11.0

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes/README.md

@@ -0,0 +1,44 @@
+# USGS earthquakes with location data from Nominatum REST Connector
+
+This connector is a minimal implementation of USGS Earthquakes and Nominatum reverse geocoding API developed to support a tutorial demo in //blog link coming soon// and is implemented in [graphql-version branch](https://github.com/AmandaApollo/earthquake-finder/tree/graphql-version) of [this repository](https://github.com/AmandaApollo/earthquake-finder).
+
+## Prerequisites
+
+USGS and Nominatum are free to access APIs that enforce their own rate limits. 
+[USGS API Documentation](https://earthquake.usgs.gov/fdsnws/event/1/)
+[Nominatum API Documentation](https://nominatim.org/release-docs/develop/api/Overview/)
+
+## 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
+
+This implementation was created to support a tutorial and therefore will not accept modifications to evolve it at this time.  If you are interested in contributing to this resource, you may do so as a separate .`graphql` file. 

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes/earthquakes.graphql

@@ -0,0 +1,235 @@
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.10", import: ["@key"]) # 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"]
+  )
+  @source(
+    name: "usgs"
+    http: { baseURL: "https://earthquake.usgs.gov/fdsnws/event/1/" }
+  )
+
+type EarthquakeProperties {
+  mag: Float
+  place: String
+  time: Float
+  updated: Float
+  tz: Int
+  url: String
+  detail: String #detail contains the direct endpoint for earthquake by id
+  felt: Int
+  cdi: Float
+  mmi: Float
+  alert: String
+  status: String
+  tsunami: Int
+  sig: Int
+  net: String
+  code: String
+  ids: String
+  sources: String
+  types: String
+  nst: Int
+  dmin: Float
+  rms: Float
+  gap: Float
+  magType: String
+  type: String
+  title: String
+  products: [ProductEntry]
+}
+
+type ProductEntry {
+  name: String
+  products: [Product]
+}
+scalar JSON
+
+type Product {
+  id: ID!
+  type: String
+  properties: JSON #data will vary
+  contents: JSON #data will vary
+}
+
+type EarthquakeGeometry {
+  #this returns 3 values - lon,lat,depth in km
+  coordinates: [Float]
+}
+
+type Earthquake @key(fields: "id") {
+  id: ID!
+  properties: EarthquakeProperties
+  geometry: EarthquakeGeometry
+}
+
+type Query {
+  """
+  Returns recent earthquakes with summary properties.
+  """
+  recentEarthquakes(limit: Int = 5): [Earthquake]
+    @connect(
+      source: "usgs"
+      http: { GET: "query" 
+      queryParams: """
+        limit: $args.limit
+        format: $('geojson')
+        """
+      }
+      selection: """
+        $.features
+       {
+       id
+        properties{
+          mag
+        place
+        time
+        updated
+        tz
+        url
+        detail
+        felt
+        cdi
+        mmi
+        alert
+        status
+        tsunami
+        sig
+        net
+        code
+        ids
+        sources
+        types
+        nst
+        dmin
+        rms
+        gap
+        magType
+        type
+        title
+        }
+        geometry{
+         coordinates
+        }
+      }
+      """
+    )
+
+  """
+  Returns detailed earthquake data by Id.
+  """
+  earthquakeById(id: ID!): Earthquake
+    @connect(
+      source: "usgs"
+      http: { GET: "query" 
+      queryParams: """
+        eventid: $args.id
+        format: $('geojson')
+        """
+      }
+      selection: """
+      id
+       properties {
+       mag
+       place
+       time
+       updated
+       tz
+       url
+       detail
+       felt
+       cdi
+       mmi
+       alert
+       status
+       tsunami
+       sig
+       net
+       code
+       ids
+       sources
+       types
+       nst
+       dmin
+       rms
+       gap
+       magType
+       type
+       title
+       products: products->entries {
+              name: key
+              products: value {
+                id
+                type
+                properties
+                contents
+              }
+            }
+       }
+       geometry{
+        coordinates
+       }
+      """
+      entity: true
+    )
+
+  """
+  Returns detailed earthquake data by a given radius for a locaation.
+  """
+  recentEarthquakesInRadius(
+    limit: Int = 5
+    lat: String!
+    lon: String!
+    maxRadius: Int = 100
+  ): [Earthquake]
+    @connect(
+      source: "usgs"
+      http: {
+        GET: "query"
+        queryParams: """
+        latitude: $args.lat
+        longitude: $args.lon
+        maxradiuskm: $args.maxRadius
+        limit: $args.limit
+        format: $('geojson')
+        """
+      }
+      selection: """
+        $.features
+       {
+       id
+        properties{
+        mag
+        place
+        time
+        updated
+        tz
+        url
+        detail
+        felt
+        cdi
+        mmi
+        alert
+        status
+        tsunami
+        sig
+        net
+        code
+        ids
+        sources
+        types
+        nst
+        dmin
+        rms
+        gap
+        magType
+        type
+        title
+        }
+        geometry{
+         coordinates
+        }
+      }
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes/supergraph.yaml

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

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes-nominatum/README.md

@@ -0,0 +1,44 @@
+# USGS earthquakes with location data from Nominatum REST Connector
+
+This connector is a minimal implementation of USGS Earthquakes and Nominatum reverse geocoding API developed to support a tutorial demo in //blog link coming soon// and is implemented in [graphql-version branch](https://github.com/AmandaApollo/earthquake-finder/tree/graphql-version) of [this repository](https://github.com/AmandaApollo/earthquake-finder).
+
+## Prerequisites
+
+USGS and Nominatum are free to access APIs that enforce their own rate limits. 
+[USGS API Documentation](https://earthquake.usgs.gov/fdsnws/event/1/)
+[Nominatum API Documentation](https://nominatim.org/release-docs/develop/api/Overview/)
+
+## 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
+
+This implementation was created to support a tutorial and therefore will not accept modifications to evolve it at this time.  If you are interested in contributing to this resource, you may do so as a separate .`graphql` file. 

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes-nominatum/earthquake-simple.graphql

@@ -0,0 +1,87 @@
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.10", import: ["@key"]) # 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"]
+  )
+  @source(
+    name: "usgs"
+    http: { baseURL: "https://earthquake.usgs.gov/fdsnws/event/1/" }
+  )
+
+ @source(
+    name: "location"
+    http: {
+      baseURL: "https://nominatim.openstreetmap.org/"
+      headers: [{ name: "User-Agent", value: "testing" }]
+    }
+  )
+
+type EarthquakeProperties {
+  mag: Float
+  place: String
+  time: Float
+  updated: Float
+  url: String
+  title: String
+}
+
+type EarthquakeGeometry {
+  #this returns 3 values - lon,lat,depth in km
+  coordinates: [Float]
+}
+
+type Earthquake {
+  id: ID!
+  properties: EarthquakeProperties
+  geometry: EarthquakeGeometry
+  display_name: String
+  @connect(
+    source: "location"
+    http: {
+      GET: "reverse"
+      queryParams: """
+        lat: $this.geometry.coordinates->slice(1,2)->first
+        lon: $this.geometry.coordinates->first
+        format: $('json')
+        """
+    }
+    selection: """
+    $.display_name
+    """
+  )
+}
+
+type Query {
+  recentEarthquakes(limit: Int = 5 lat: String! lon: String! maxRadius: Int = 100): [Earthquake]
+    @connect(
+      source: "usgs"
+      http: {
+        GET: "query?format=geojson"
+        queryParams: """
+        latitude: $args.lat
+        longitude: $args.lon
+        maxradiuskm: $args.maxRadius
+        limit: $args.limit
+        """
+      }
+      selection: """
+        $.features
+       {
+        properties{
+          mag
+          place
+          time
+          updated
+          url
+          title
+        }
+        geometry{
+         coordinates
+        }
+        id
+      }
+      
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes-nominatum/router.yaml

@@ -0,0 +1,3 @@
+# only for use in development
+cors:
+  allow_any_origin: true

package/sampleWorkspace/connectors-community/connectors/usgs/earthquakes-nominatum/supergraph.yaml

@@ -0,0 +1,6 @@
+subgraphs:
+  earthquake-simple:
+    routing_url: http://localhost:4000
+    schema:
+      file: earthquake-simple.graphql
+federation_version: =2.11.0

package/sampleWorkspace/connectors-community/connectors/usps/README

@@ -0,0 +1,36 @@
+# USPS REST Connector
+
+This connector currently covers the [Tracking object](https://developer.usps.com/trackingv3) in the [USPS REST API](https://developer.usps.com/). To use this, you'll need to add a `API_KEY` in your environment variables then running `rover` or the `router` with the config files in this folder. 
+
+## Additional Setup for VS Code Task runner
+
+Edit your `.vscode/settings.json` to include the Strapi specific keys
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": { 
+        "API_KEY": "",
+        "APOLLO_KEY": "",
+        ...
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+
+```
+
+Then you can execute the "Tasks: Run Task" command in VS code to execute the `rover dev` task or simply open a new terminal window in vscode with the `graphos` profile, then you can simply run `rover dev --supergraph-config supergraph.yaml --router-config router.yaml`.
+
+## Contributing
+
+The following schema modules need to include:
+
+1. A schema designed for that portion of the rest API as a new `.graphql` file
+2. Additions to the `router.yaml` and `supergraph.yaml` files
+
+You can view the [USPS API Catalog](https://developer.usps.com/apis) for other modules to implement.

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

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

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