vscode-apollo 2.5.6 → 2.6.0

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

@@ -0,0 +1,18 @@
+federation_version: =2.11.0
+subgraphs:
+  stripe-checkout:
+    routing_url: http://stripe-checkout
+    schema:
+      file: checkout.graphql
+  stripe-core-resources:
+    routing_url: http://stripe-core-resources
+    schema:
+      file: core-resources.graphql
+  stripe-payment-methods:
+    routing_url: http://stripe-payment-methods
+    schema:
+      file: payment-methods.graphql
+  stripe-product:
+    routing_url: http://stripe-products
+    schema:
+      file: products.graphql

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

@@ -0,0 +1,80 @@
+# Stripe REST Connector
+
+This connector currently covers a portion of the [Supabase API](https://supabase.com/docs/guides/api).
+
+## Prerequisites
+
+To use the connector, you need to set up a new account in supabase and at least one table schema.
+In the connector template you will point to your unique supabase url and update and table names and fields to match your schema.
+Supabase requires passing a key on the header which can be found in your Supabase dashboard.
+
+Please note that the queries and mutations in this template do not take into consideration RLS (Row Level Security) policies.
+If you have any RLS policies set on your table for CRUD operations, you may need to adjust the schema.
+
+See Supabase documentation for more information about working with [RLS policies](https://supabase.com/docs/guides/database/postgres/row-level-security)
+
+## Getting started 
+
+1. If you haven't already, [create a new graph in GraphOS](https://www.apollographql.com/docs/graphos/get-started/guides/rest#step-1-set-up-your-graphql-api). Once you get to the **Set up your local development environment** modal in the [Create a graph](https://www.apollographql.com/docs/graphos/get-started/guides/rest#create-a-graph) section:
+    - Copy the `supergraph.yaml` and `router.yaml` files from this folder instead of the `supergraph.yaml` provided by the modal.
+    - Instead of downloading the example schema provided by the modal, copy the supabase schema files you want to use for this connector
+1. Grab your Supabase anon API key and set it as an environment variable for your terminal:
+
+    ```
+    export anonKey=....
+    ```
+
+1. Run `rover dev` to start the local development session:
+
+    ```
+    APOLLO_KEY=service:My-Graph-s1ff1u:•••••••••••••••••••••• \
+      APOLLO_GRAPH_REF=My-Graph-s1ff1u@main \
+      rover dev --supergraph-config supergraph.yaml --router-config router.yaml
+    ```
+
+You’re all set! Open up http://localhost:4000 to query your graph using Apollo Sandbox.
+
+### Adding to an existing graph in GraphOS
+
+To add these connectors to an existing graph, publish the schema files to your graph ref using `rover subgraph publish`:
+
+```
+APOLLO_KEY=service:My-Graph-s1ff1u:•••••••••••••••••••••• \
+  rover subgraph publish My-Graph-s1ff1u@main --name products --schema products.graphql --routing-url http://products
+
+APOLLO_KEY=service:My-Graph-s1ff1u:•••••••••••••••••••••• \
+  rover subgraph publish My-Graph-s1ff1u@main --name checkout --schema checkout.graphql --routing-url http://checkout
+```
+
+## Additional setup for VS Code task runner
+
+Edit your `.vscode/settings.json` to include the following Stripe-specific key:
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": {
+        "anonKey": "",
+        ...
+      }
+    }
+  },
+  "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
+
+To contribute additional modules to this connector, make sure to:
+
+1. Add a schema designed for the module as a new `.graphql` file.
+2. Update the `router.yaml` and `supergraph.yaml` files accordingly.
+
+See [REST API reference](https://docs.stripe.com/api) for other modules that can be implemented. You can use the current modules in this folder as examples to work with. 

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

@@ -0,0 +1,5 @@
+connectors:
+  sources:
+    speakerSubmission.supabase:
+      $config:
+        anonKey: ${env.anonKey}

package/sampleWorkspace/connectors-community/connectors/supabase/supabase.graphql

@@ -0,0 +1,143 @@
+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"]
+  )
+  
+  #to use this prebuilt connector, you must create at least one table in your supabase project
+  #and replace <YOUR_TABLE_NAME> with the name of your table
+  #field names here are examples, you can change them to match your table schema
+  # to use this connector, you must also set the anonKey in the config
+  @source(
+    name: "supabase"
+    http: {
+      baseURL: "<YOUR_SUPABASE_URL>/rest/v1/"
+      headers: [{ name: "Authorization", value: "Bearer {$config.anonKey}" },
+      {name: "apiKey", value: "{$config.anonKey}"}]
+    }
+  )
+
+type Query {
+  # Get all rows with pagination - pagination in supabase is a range of rows starting from 0.
+  #if null is passed, all rows will return
+  # single arguments will result in either all rows returned or an error
+  getAllRows(start: Int, end: Int): [Columns]
+    @connect(
+      source: "supabase"
+      http: {
+        GET: "<YOUR_TABLE_NAME>"
+        headers: [
+        {
+          name: "Range"
+          value: "{$args.start}-{$args.end}"
+        }
+      ]
+      }
+      selection: """
+        name
+      """
+    )
+
+  # Get filtered rows with pagination - pagination in supabase is a range of rows starting from 0.
+  #if null is passed, all rows will return
+  # single arguments will result in either all rows returned or an error
+  #see supbase documentation for more details on filtering
+  #https://supabase.com/docs/reference/javascript/using-filters
+getFilteredRows(start: Int, end: Int): [Columns]
+    @connect(
+      source: "supabase"
+      http: {
+        GET: "<YOUR_TABLE_NAME>?select=<COLUMN_NAME>"
+        headers: [
+        {
+          name: "Range"
+          value: "{$args.start}-{$args.end}"
+        }
+      ]
+      }
+      selection: """
+          name
+      """
+    )
+}
+
+type Mutation {
+  insertRow(input: InputRow!): Submission!
+    @connect(
+      source: "supabase"
+      http: {
+        POST: "<YOUR_TABLE_NAME>"
+        body: """
+          name: $args.input.name
+         
+        """
+      }
+      selection: """
+        id
+        name
+      """
+    )
+
+# for supabase this will return 204 no content unless you specify a header to return the row
+  updateRow(id: ID!, input: UpdateRow!): UpdateResponse!
+    @connect(
+      source: "supabase"
+      http: {
+        PATCH: "<YOUR_TABLE_NAME>?id=eq.{$args.id}"
+        body: """
+         name: $args.input.name
+        """
+      }
+      selection: """
+        submission {
+          id
+          name
+        }
+      """
+    )
+  
+  # for supabase this will return 204 no content unless you specify a header to return the row
+  deleteRow(id: ID!): DeleteResponse!
+    @connect(
+      source: "supabase"
+      http: {
+        DELETE: "<YOUR_TABLE_NAME>?id=eq.{$args.id}"
+      }
+      selection: """
+        message
+      """
+    )
+}
+
+
+input InputRow {
+  name: String!
+ 
+}
+
+input UpdateRow {
+  name: String
+ 
+}
+
+type Columns {
+ name: String
+ 
+}
+
+type Submission {
+  id: ID!
+  name: String!
+}
+
+type UpdateResponse {
+  submission: Submission!
+}
+
+type DeleteResponse {
+  message: String!
+}

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

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

package/sampleWorkspace/connectors-community/connectors/thespacedevs/README

@@ -0,0 +1,46 @@
+# The Space Devs Launch Library REST Connector
+
+This connector currently covers [The Space Devs Launch Library REST API](https://ll.thespacedevs.com/).
+
+## Prerequisites
+
+The Space Devs is a free to access API that enforces their own rate limits; all the API data is available at no cost for up to 15 requests per hour.
+
+## 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
+
+
+The following schema modules can be added to this connector:
+
+- Example 1
+- Example 2
+
+To contribute them, make sure to:
+
+1. Add a schema designed for the module as a new `.graphql` file.
+2. Update the `router.yaml` and `supergraph.yaml` files accordingly.
+
+See [REST API reference]() for other modules that can be implemented. You can use the current modules in this folder as examples to work with. 

package/sampleWorkspace/connectors-community/connectors/thespacedevs/agencies.graphql

@@ -0,0 +1,193 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.10"
+    import: ["@key", "@requires", "@shareable"]
+  )
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(name: "llv2", http: { baseURL: "https://ll.thespacedevs.com/2.3.0/" })
+
+type Agency @key(fields: "id") {
+  id: ID!
+  name: String @shareable
+  abbrev: String @shareable 
+  type: String @shareable
+  featured: Boolean @shareable
+  country: [Country] @shareable
+  description: String @shareable
+  administrator: String @shareable
+  foundingYear: Int @shareable
+  spacecraft: String @shareable
+  image: Image @shareable
+  logo: Image @shareable
+  socialLogo: Image @shareable
+}
+type Image @shareable{
+  id: ID!
+  name: String
+  url: String
+  thumbnail: String
+  credit: String
+  singleUse: Boolean
+  license: ImageLicense
+}
+type ImageLicense @shareable{
+  name: String
+  link: String
+}
+type AgencyConnection {
+  pageInfo: PageInfo
+  results: [Agency]
+}
+type Country @shareable {
+  id: ID!
+  name: String
+  alpha2Code: String
+  alpha3Code: String
+  nationalityName: String
+  nationalityNameComposed: String
+}
+type PageInfo @shareable {
+  count: Int
+  next: String
+  previous: String
+}
+type Query {
+  agency(id: ID!): Agency
+    @connect(
+      source: "llv2"
+      entity: true
+      http: { GET: "/agencies/{$args.id}/?format=json" }
+      selection: """
+      id
+      name
+      abbrev
+      type: type.name
+      featured
+      country {
+        id
+        name
+        alpha2Code: alpha_2_code
+        alpha3Code: alpha_3_code
+        nationalityName: nationality_name
+        nationalityNameComposed: nationality_name_composed
+      }
+      description
+      administrator
+      foundingYear: founding_year
+      spacecraft
+      image {
+        id
+        name
+        url: image_url
+        thumbnail: thumbnail_url
+        credit
+        license {
+          name
+          link
+        }
+        singleUse: single_use
+      }
+      logo {
+        id
+        name
+        url: image_url
+        thumbnail: thumbnail_url
+        credit
+        license {
+          name
+          link
+        }
+        singleUse: single_use
+      }
+      socialLogo: social_logo {
+        id
+        name
+        url: image_url
+        thumbnail: thumbnail_url
+        credit
+        license {
+          name
+          link
+        }
+        singleUse: single_use
+      }
+      """
+    )
+  agencies(search: String, offset: Int = 0, limit: Int = 20): AgencyConnection
+    @connect(
+      source: "llv2"
+      http: { 
+        GET: "/agencies/?format=json"
+        queryParams: """
+        search: $args.search
+        limit: $args.limit
+        offset: $args.offset
+        """
+         }
+      selection: """
+      pageInfo {
+        count
+        next
+        previous
+      }
+      results {
+        id
+        name
+        abbrev
+        type: type.name
+        featured
+        country {
+          id
+          name
+          alpha2Code: alpha_2_code
+          alpha3Code: alpha_3_code
+          nationalityName: nationality_name
+          nationalityNameComposed: nationality_name_composed
+        }
+        description
+        administrator
+        foundingYear: founding_year
+        spacecraft
+        image {
+          id
+          name
+          url: image_url
+          thumbnail: thumbnail_url
+          credit
+          license {
+            name
+            link
+          }
+          singleUse: single_use
+        }
+        logo {
+          id
+          name
+          url: image_url
+          thumbnail: thumbnail_url
+          credit
+          license {
+            name
+            link
+          }
+          singleUse: single_use
+        }
+        socialLogo: social_logo {
+          id
+          name
+          url: image_url
+          thumbnail: thumbnail_url
+          credit
+          license {
+            name
+            link
+          }
+          singleUse: single_use
+        }
+      }
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/thespacedevs/api-throttle.graphql

@@ -0,0 +1,33 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.10"
+    import: ["@key", "@requires", "@shareable"]
+  )
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(name: "llv2", http: { baseURL: "https://ll.thespacedevs.com/2.3.0/" })
+
+type ApiThrottle{
+  yourRequestLimit: Int
+  limitFrequencySecs: Int
+  currentUse: Int
+  nextUseSecs: Int
+  ident: String
+}
+
+type Query {
+  apiThrottle: ApiThrottle
+    @connect(
+      source: "llv2"
+      http: { GET: "/api-throttle/?format=json" }
+      selection: """
+      yourRequestLimit: your_request_limit
+      limitFrequencySecs: limit_frequency_secs
+      currentUse: current_use
+      nextUseSecs: next_use_secs
+      ident
+      """
+    )
+}