vscode-apollo 2.5.6 → 2.6.0

package/sampleWorkspace/connectors-community/connectors/usps/tracking.graphql

@@ -0,0 +1,118 @@
+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"]
+  )
+  # http://developers.usps.com/trackingv3
+  # https://developers.usps.com/sites/default/files/apidoc_specs/tracking_v3.yaml
+  @source(
+    name: "usps-tracking"
+    http: {
+      baseURL: "https://apis.usps.com/tracking/v3"
+      headers: [{ name: "Authorization", value: "Bearer {$config.apiKey}" }]
+    }
+  )
+
+type TrackingStatus @key(fields:"trackingNumber") {
+  trackingNumber: ID!
+  expectedDeliveryDate: String
+  expectedDeliveryTime: String
+  guaranteedDeliveryDate: String
+  eventSummaries: [String]
+}
+
+type Query {
+  tracking(trackingNumber: ID!): TrackingStatus
+    # https://developers.usps.com/trackingv3#tag/Resources/operation/get-package-tracking
+    @connect(
+      source: "usps-tracking"
+      http: { GET: "/tracking/{$args.trackingNumber}" }
+      selection: """
+        trackingNumber
+        expectedDeliveryDate
+        expectedDeliveryTime
+        guaranteedDeliveryDate
+        eventSummaries
+      """
+      entity: true
+    )
+}
+
+type Mutation {
+  registerForNotifications(trackingNumber: ID!, options: NotificationsInput!): TrackingResponse
+    @connect(
+      source: "usps-tracking"
+      http: { 
+        POST: "/tracking/{$args.trackingNumber}/notifications" 
+        body: """
+        notifications: $args.options.emails
+        $args.options {
+          firstName
+          lastName
+          uniqueMailPieceId
+          mailPieceIntakeDate
+          notifyEventTypes
+        }
+        """
+      }
+      selection: """
+        result: resultText
+        code: returnCode
+      """
+    )
+  proofOfDelivery(trackingNumber: ID!, options: ProofOfDeliveryInput!): TrackingResponse
+    @connect(
+      source: "usps-tracking"
+      http: { 
+        POST: "/tracking/{$args.trackingNumber}/proof-of-delivery" 
+        body: """
+        $args.options
+        """
+      }
+      selection: """
+        result: resultText
+        code: returnCode
+      """
+    )
+}
+
+enum NotifyEventTypes {
+  EMAIL_ALERT
+  EMAIL_FUTURE_DELIVERY
+  EMAIL_TODAY_DELIVERY
+  EMAIL_AVAILABLE_FOR_PICKUP
+  OTHER_ACTIVITY
+}
+
+input ProofOfDeliveryInput {
+  uniqueMailPieceID: String!
+  mailPieceIntakeDate: String!
+  tableCode: String!
+  requestType: String!
+  firstName: String!
+  lastName: String!
+  email: [String!]!
+  faxNumber: String
+  streetAddress: String
+  secondaryAddress: String
+  city: String
+  state: String
+  ZIPCode: String
+  ZIPPlus4: String
+  CRID: String
+}
+
+input NotificationsInput {
+  emails: [String!]!
+  firstName: String
+  lastName: String
+  uniqueMailPieceId: String
+  mailPieceIntakeDate: String
+  notifyEventTypes: [NotifyEventTypes]
+}
+
+type TrackingResponse {
+  result: String
+  code: String
+}

package/sampleWorkspace/connectors-community/connectors/zendesk/README

@@ -0,0 +1,36 @@
+# Zendesk REST Connector
+
+This connector currently covers the Orders and LineItem objects in the [Zendesk Sales CRM REST API](https://developer.zendesk.com/api-reference/sales-crm). 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
+
+See [developer documentation](https://developer.zendesk.com/api-reference/sales-crm) navigation panel 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/zendesk/connector.graphql

@@ -0,0 +1,98 @@
+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: "zendesk-sales-crm"
+    http: {
+      baseURL: "https://api.getbase.com/v2/"
+      headers: [{ name: "Authorization", value: "Bearer {$config.apiKey}" }]
+    }
+  )
+
+type Order {
+  id: ID!
+  discount: String
+  updatedAt: String
+  createdAt: String
+  deal: Deal
+  lineItems: [LineItem]
+    # https://developer.zendesk.com/api-reference/sales-crm/resources/line-items/#retrieve-orders-line-items
+    @connect(
+      source: "zendesk-sales-crm"
+      http: { GET: "/orders/{$this.id}/line_items" }
+      selection: """
+        $.items.data {
+          id
+          name
+          sku
+          description
+          value
+          variation
+          price
+          currency
+          quantity
+          updatedAt: updated_at
+          createdAt: created_at
+        }
+      """
+    )
+}
+
+type LineItem {
+  id: ID!
+  name: String
+  sku: String
+  description: String
+  value: Float
+  variation: Float
+  price: Float
+  currency: String
+  quantity: Int
+  updatedAt: String
+  createdAt: String
+}
+
+type Deal {
+  id: ID!
+}
+
+type Query {
+  order(id:ID!): Order
+    # https://developer.zendesk.com/api-reference/sales-crm/resources/orders/#retrieve-a-single-order
+    @connect(
+      source: "zendesk-sales-crm"
+      http: { GET: "/orders/{$args.id}" }
+      selection: """
+        $.data {
+          id
+          deal: {
+            id: deal_id
+          }
+          discount
+          updatedAt: updated_at
+          createdAt: created_at
+        }
+        ## Example of connecting metadata to USPS tracking
+        ## See connectors/usps/tracking.graphql
+        # $.meta {
+        #   tracking: {
+        #     trackingNumber: trackingId
+        #   }
+        # }
+      """
+      entity: true 
+    )
+}
+
+## Example of connecting metadata to USPS tracking
+## See connectors/usps/tracking.graphql
+# extend type Order {
+#   tracking: TrackingStatus
+# }
+
+# type TrackingStatus @key(fields:"trackingNumber", resolvable: false) {
+#   trackingNumber: ID!
+# }

package/sampleWorkspace/connectors-community/connectors/zendesk/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/zendesk/supergraph.yaml

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