vscode-apollo 2.5.6 → 2.6.1

package/sampleWorkspace/connectors-community/connectors/strapi/users.graphql

@@ -0,0 +1,227 @@
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.10", import: ["@key", "@requires"])
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(
+    name: "strapi"
+    http: {
+      # https://docs.strapi.io/dev-docs/api/rest#endpoints
+      baseURL: "http://localhost:1337/api" #See router.yaml for environment variable config option
+      headers: [{ name: "Authorization", value: "Bearer {$config.apiKey}" }]
+    }
+  )
+
+type User @key(fields: "id") {
+  id: ID!
+  username: String
+  email: String
+  provider: String
+  confirmed: Boolean
+  blocked: Boolean
+  role: Role
+}
+
+type Query {
+  user(id: ID!): User
+    @connect(
+      source: "strapi"
+      http: { GET: "/users/{$args.id}?populate=role" }
+      entity: true
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#get
+      id
+      username
+      email
+      provider
+      confirmed
+      blocked
+      role {
+        id 
+      }
+      """
+    )
+  users(start: Int = 0, limit: Int = 25): [User]
+    @connect(
+      source: "strapi"
+      http: {
+        GET: "/users"
+        queryParams: """
+        pagination[start]: $args.start
+        pagination[limit]: $args.limit
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#get-all
+      id
+      username
+      email
+      provider
+      confirmed
+      blocked
+      """
+    )
+  searchUsers(username: String!): User @connect(
+      source: "strapi"
+      http: {
+        GET: "/users?filters[username][$containsi]={$args.username}"
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest/filters-locale-publication#filtering
+      $ ->first {
+        id
+        username
+        email
+        provider
+        confirmed
+        blocked
+      }
+      """
+    )
+} 
+
+type DeleteUserResponse {
+  success: Boolean
+  message: String
+}
+
+type Mutation {
+  deleteUser(id: ID!): DeleteUserResponse 
+    @connect(
+      source: "strapi"
+      http: { DELETE: "/users/{$args.id}" }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#delete
+        success: $(true) 
+        message: $("User deleted")
+      """
+    )
+  createUser(
+    username: String!
+    email: String!
+    password: String!
+    role: Roles = PUBLIC
+  ): User
+    @connect(
+      source: "strapi"
+      http: {
+        POST: "/users"
+        body: """
+        $args {
+          username
+          email
+          password
+        }
+        role: {
+          connect: $([{
+            id: $args.role->match(
+              ["AUTHENTICATED", 1],
+              ["PUBLIC", 2],
+            )
+          }])
+        }
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#create
+      id
+      username
+      email
+      provider
+      confirmed
+      blocked
+      """
+    )
+  updateUserPassword(id: ID!, password: String!): User
+    @connect(
+      source: "strapi"
+      http: {
+        PUT: "/users/{$args.id}"
+        body: """
+        $args {
+          id
+          password: $args.password
+        }
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#update
+      id
+      """
+    )
+  updateUserUsername(id: ID!, username: String!): User
+    @connect(
+      source: "strapi"
+      http: {
+        PUT: "/users/{$args.id}"
+        body: """
+        $args {
+          id
+          username: $args.username
+        }
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#update
+      id
+      """
+    )
+  updateUserEmail(id: ID!, email: String!): User
+    @connect(
+      source: "strapi"
+      http: {
+        PUT: "/users/{$args.id}"
+        body: """
+        $args {
+          id
+          email: $args.email
+        }
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#update
+      id
+      """
+    )
+  updateUserRole(id: ID!, role: Roles): User
+    @connect(
+      source: "strapi"
+      http: {
+        POST: "/users"
+        body: """
+        $args {
+          id
+        }
+        role: {
+          connect: $([{
+            id: $args.role->match(
+              ["AUTHENTICATED", 1],
+              ["PUBLIC", 2],
+            )
+          }])
+          disconnect: $([])
+        } 
+        """
+      }
+      selection: """
+      # https://docs.strapi.io/dev-docs/api/rest#update
+      id
+      username
+      email
+      provider
+      confirmed
+      blocked
+      role { id }
+      """
+    )
+}
+
+type Role {
+  id: ID!
+}
+
+enum Roles {
+  AUTHENTICATED
+  PUBLIC
+}

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

@@ -0,0 +1,83 @@
+# Stripe REST Connector
+
+This connector currently covers a portion of the [Stripe REST API](https://docs.stripe.com/api).
+
+## Prerequisites
+
+To use the connector, you need a [Stripe API key](https://docs.stripe.com/keys).
+
+## 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 schema files you want to use for this connector—`checkouts.graphql` and/or `products.graphql`
+      - *Note: If you only want to one of the schema files, you need to modify the `supergraph.yaml` file to only contain the respective schema file .*
+1. Grab your Stripe API key and set it as an environment variable for your terminal:
+
+    ```
+    export STRIPE_API_KEY=....
+    ```
+
+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": {
+        "STRIPE_API_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:
+
+- [Core](https://docs.stripe.com/api/)
+- [Payment Methods](https://docs.stripe.com/api/balance)
+- [Checkout](https://docs.stripe.com/api/checkout/)
+- [Payment Link](https://docs.stripe.com/api/payment-link)
+- [Billing](https://docs.stripe.com/api/payment-link)
+...*see left column of https://docs.stripe.com/api*...
+
+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](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/stripe/checkout.graphql

@@ -0,0 +1,112 @@
+extend schema
+  @link(url: "https://specs.apollo.dev/federation/v2.10", import: ["@key", "@requires", "@shareable", "@external"])
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(
+    name: "stripe"
+    http: { 
+      baseURL: "https://api.stripe.com/v1"
+      headers: [
+        { name: "Authorization", value: "Bearer {$config.apiKey}" }
+        { name: "Stripe-Version", value: "2024-06-20" }
+        { name: "Content-Type", value: "application/x-www-form-urlencoded" }
+      ]
+    }
+)
+
+type Price @key(fields: "id", resolvable: false) @shareable {
+  id: ID!
+  active: Boolean 
+  currency: String
+  unitAmount: Float
+}
+
+type Session @key(fields: "id") {
+  id: ID!
+  subtotal: Float
+  shipping: Float
+  total: Float
+  paymentUrl: String
+  items: [LineItem] @connect(
+    source: "stripe"
+    http: { GET: "/checkout/sessions/{$this.id}/line_items" }
+    selection: """
+    # https://docs.stripe.com/api/checkout/sessions/line_items
+      $.data {
+        id
+        price {
+          id
+          active
+          currency
+          unitAmount: unit_amount
+        }
+        quantity
+      }
+    """
+  )
+}
+
+type Query {
+  session (id: ID!): Session 
+    @connect(
+      source: "stripe"
+      http: { GET: "/checkout/sessions/{$args.id}"}
+      selection: """
+      # https://docs.stripe.com/api/checkout/sessions/retrieve
+        id
+        subtotal: amount_subtotal
+        shipping: shipping_cost
+        total: amount_total
+        paymentUrl: url
+      """
+      entity: true
+    )
+  sessions(limit: Int = 3): [Session]
+    @connect(
+      source: "stripe"
+      http: { GET: "/checkout/sessions?limit={$args.limit}" }
+      selection: """
+      # https://docs.stripe.com/api/checkout/sessions/list
+        $.data {
+        id
+          subtotal: amount_subtotal
+          shipping: shipping_cost
+          total: amount_total
+          paymentUrl: url
+        }
+      """
+    )
+}
+
+type Mutation {
+  createSession(items: [LineItemInput!]!): Session
+    @connect(
+      source: "stripe"
+      http: { 
+        POST: "/checkout/sessions"
+        body: """
+          mode: $("payment")
+          line_items: $args.items 
+          success_url: $("https://my-website.com")
+        """
+      }
+      selection: """
+      # https://docs.stripe.com/api/checkout/sessions/create
+        id
+        paymentUrl: url
+      """
+    )
+}
+
+input LineItemInput {
+  price: ID!
+  quantity: Int
+}
+
+type LineItem {
+  id: ID
+  price: Price!
+  quantity: Int
+}