vscode-apollo 2.5.6 → 2.6.1

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

@@ -0,0 +1,381 @@
+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: "todoist"
+    http: {
+      baseURL: "https://api.todoist.com/api/v1"
+      headers: [
+        { name: "Authorization", value:"Bearer {$config.todoistKey}" }
+      ]
+    }
+  )
+
+#post projects https://developer.todoist.com/api/v1/projects
+#get projects https://developer.todoist.com/api/v1/projects
+#post tasks https://developer.todoist.com/api/v1/tasks
+#get tasks https://developer.todoist.com/api/v1/tasks
+#close task https://developer.todoist.com/api/v1/tasks/{task_id}/close
+#update taks https://developer.todoist.com/api/v1/tasks/{task_id}
+
+
+scalar JSON
+
+input CreateTaskInput {
+  content: String!
+  description: String
+  projectId: String
+  deadlineDate: String
+}
+
+type ProjectAccess {
+  visibility: String!
+  configuration: JSON
+}
+
+type ProjectsResponse {
+  results: [Project!]!
+  nextCursor: String
+}
+
+type Project @key(fields: "id") {
+  id: ID!
+  childOrder: Int
+  color: String
+  creatorUid: String
+  createdAt: String
+  isArchived: Boolean
+  isDeleted: Boolean
+  isFavorite: Boolean
+  isFrozen: Boolean
+  name: String
+  updatedAt: String
+  viewStyle: String
+  defaultOrder: Int
+  description: String
+  access: ProjectAccess
+  role: String
+  parentId: String
+  inboxProject: Boolean
+  isCollapsed: Boolean
+  isShared: Boolean
+}
+
+type Task @key(fields: "id") {
+  userId: ID!
+  id: ID!
+  projectId: String!
+  sectionId: String
+  parentId: String
+  addedByUid: String
+  assignedByUid: String
+  responsibleUid: String
+  labels: [String]
+  checked: Boolean
+  isDeleted: Boolean
+  addedAt: String
+  completedAt: String
+  updatedAt: String
+  priority: Int
+  childOrder: Int
+  content: String
+  description: String
+  noteCount: Int
+  dayOrder: Int
+}
+
+type TasksResponse {
+  results: [Task!]!
+  nextCursor: String
+}
+
+type Query {
+  # Project queries
+  getProjectById(id: ID!): Project
+    @connect(
+      source: "todoist"
+      http: { GET: "/projects/{$args.id}" }
+      selection: """
+       id
+      childOrder: child_order
+      color
+      creatorUid: creator_uid
+      createdAt: created_at
+      isArchived: is_archived
+      isDeleted: is_deleted
+      isFavorite: is_favorite
+      isFrozen: is_frozen
+      name
+      updatedAt: updated_at
+      viewStyle: view_style
+      defaultOrder: default_order
+      description
+      access {
+        visibility
+        configuration
+      }
+      role
+      parentId: parent_id
+      inboxProject: inbox_project
+      isCollapsed: is_collapsed
+      isShared: is_shared
+      """
+      entity: true
+    )
+  
+  getAllProjects: ProjectsResponse!
+    @connect(
+      source: "todoist"
+      http: { GET: "/projects" }
+      selection: """
+     results{
+     id
+      childOrder: child_order
+      color
+      creatorUid: creator_uid
+      createdAt: created_at
+      isArchived: is_archived
+      isDeleted: is_deleted
+      isFavorite: is_favorite
+      isFrozen: is_frozen
+      name
+      updatedAt: updated_at
+      viewStyle: view_style
+      defaultOrder: default_order
+      description
+      access {
+        visibility
+        configuration
+      }
+      role
+      parentId: parent_id
+      inboxProject: inbox_project
+      isCollapsed: is_collapsed
+      isShared: is_shared
+      }
+      nextCursor: next_cursor
+      """
+    )
+  
+  # Task queries
+  getTaskById(id: ID!): Task
+    @connect(
+      source: "todoist"
+      http: { GET: "/tasks/{$args.id}" }
+      selection: """
+     userId: user_id
+      id
+      projectId: project_id
+      sectionId: section_id
+      parentId: parent_id
+      addedByUid: added_by_uid
+      assignedByUid: assigned_by_uid
+      responsibleUid: responsible_uid
+      labels
+      checked
+      isDeleted: is_deleted
+      addedAt: added_at
+      completedAt: completed_at
+      updatedAt: updated_at
+      priority
+      childOrder: child_order
+      content
+      description
+      noteCount: note_count
+      dayOrder: day_order
+      """
+      entity: true
+    )
+  
+  #returns tasks in inbox, not by project
+  getAllTasks(cursor: String): TasksResponse!
+    @connect(
+      source: "todoist"
+      http: { GET: "/tasks" 
+        queryParams: "cursor: $args.cursor"
+      }
+      selection: """
+      results {
+        userId: user_id
+        id
+        projectId: project_id
+        sectionId: section_id
+        parentId: parent_id
+        addedByUid: added_by_uid
+        assignedByUid: assigned_by_uid
+        responsibleUid: responsible_uid
+        labels
+        checked
+        isDeleted: is_deleted
+        addedAt: added_at
+        completedAt: completed_at
+        updatedAt: updated_at
+        priority
+        childOrder: child_order
+        content
+        description
+        noteCount: note_count
+        dayOrder: day_order
+      }
+      nextCursor: next_cursor
+      """
+    )
+  
+  getTasksByProject(projectId: String!, cursor: String): TasksResponse!
+    @connect(
+      source: "todoist"
+      http: { GET: "/tasks" 
+        queryParams: """
+        project_id: $args.projectId 
+        cursor: $args.cursor
+        """
+      }
+      selection: """
+      results {
+        userId: user_id
+        id
+        projectId: project_id
+        sectionId: section_id
+        parentId: parent_id
+        addedByUid: added_by_uid
+        assignedByUid: assigned_by_uid
+        responsibleUid: responsible_uid
+        labels
+        checked
+        isDeleted: is_deleted
+        addedAt: added_at
+        completedAt: completed_at
+        updatedAt: updated_at
+        priority
+        childOrder: child_order
+        content
+        description
+        noteCount: note_count
+        dayOrder: day_order
+      }
+      nextCursor: next_cursor
+      """
+    )
+}
+
+type Mutation {
+  # Project mutations
+  createProject(name: String!, description: String): Project!
+    @connect(
+      source: "todoist"
+      http: { POST: "/projects" 
+        body: """
+       name: $args.name
+       description: $args.description
+        """
+      }
+      selection: """
+      id
+      childOrder: child_order
+      color
+      creatorUid: creator_uid
+      createdAt: created_at
+      isArchived: is_archived
+      isDeleted: is_deleted
+      isFavorite: is_favorite
+      isFrozen: is_frozen
+      name
+      updatedAt: updated_at
+      viewStyle: view_style
+      defaultOrder: default_order
+      description
+      access {
+        visibility
+        configuration
+      }
+      role
+      parentId: parent_id
+      inboxProject: inbox_project
+      isCollapsed: is_collapsed
+      isShared: is_shared
+      """
+    )
+  
+  updateProject(id: String!, name: String, description: String): Project!
+    @connect(
+      source: "todoist"
+      http: { POST: "/projects/$args.id" 
+        body: """
+        name: $args.name
+        description: $args.description
+        """
+      }
+      selection: """
+     id
+      childOrder: child_order
+      color
+      creatorUid: creator_uid
+      createdAt: created_at
+      isArchived: is_archived
+      isDeleted: is_deleted
+      isFavorite: is_favorite
+      isFrozen: is_frozen
+      name
+      updatedAt: updated_at
+      viewStyle: view_style
+      defaultOrder: default_order
+      description
+      access {
+        visibility
+        configuration
+      }
+      role
+      parentId: parent_id
+      inboxProject: inbox_project
+      isCollapsed: is_collapsed
+      isShared: is_shared
+      """
+    )
+  
+  # Task mutations
+  createTask(input: CreateTaskInput!): Task!
+    @connect(
+      source: "todoist"
+      http: { POST: "/tasks" 
+        body: "$args.input"
+      }
+      selection: """
+      userId: user_id
+      id
+      projectId: project_id
+      sectionId: section_id
+      parentId: parent_id
+      addedByUid: added_by_uid
+      assignedByUid: assigned_by_uid
+      responsibleUid: responsible_uid
+      labels
+      checked
+      isDeleted: is_deleted
+      addedAt: added_at
+      completedAt: completed_at
+      updatedAt: updated_at
+      priority
+      childOrder: child_order
+      content
+      description
+      noteCount: note_count
+      dayOrder: day_order
+      """
+    )
+  
+  closeTask(id: String!): Boolean!
+    @connect(
+      source: "todoist"
+      http: { POST: "/tasks/$args.id/close" }
+      selection: """
+      success
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/trimblemaps/README

@@ -0,0 +1,99 @@
+# TrimbleMaps REST Connector
+
+This is an Apollo Connector that works with the TrimbleMaps API.
+https://developer.trimblemaps.com/restful-apis/developer-guide/introduction/
+
+To use this, you'll need to add the Trimble Maps `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": "",
+        "APOLLO_GRAPH_REF": "",
+      }
+    }
+  },
+  "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`.
+
+
+## Query by address
+
+Example usage:
+
+```
+query locationByAddress($address: String!, $city: String!, $state: String!) {
+  locationByAddress(address: $address, city: $city, state: $state) {
+    lat
+    long
+  }
+}
+```
+
+Pass address, city and state as strings.
+Works with North America addresses only
+
+Example:
+`1600 Pennsylvania Avenue NW, Washington, DC`
+
+Returns:
+```
+{
+  "data": {
+    "locationByAddress": {
+      "lat": "38.897675",
+      "long": "-77.036547"
+    }
+  }
+}
+```
+
+## Query By Lat/Long coordinates
+
+Example usage:
+
+```
+query addressByGeo($lat: String!, $long: String!) {
+  addressByGeo(lat: $lat, long: $long) {
+    shortFormatted
+    timezone
+  }
+}
+```
+
+Pass Lat, long as strings
+Works worldwide and returns Address and Timezone
+
+Example:
+`48.8584° N, 2.2945° E is the Eiffel Tower`
+
+Returns:
+{
+  "data": {
+    "addressByGeo": {
+      "shortFormatted": "2 Avenue Gustave Eiffel, 75007 Paris, Île-de-France, FR, Paris",
+      "timezone": "GMT+1:00"
+    }
+  }
+}
+
+
+## Contributing
+
+Currently this connector supports a portion of the single search API
+https://developer.trimblemaps.com/restful-apis/location/single-search/single-search-api/.  There is an opporunity to build out and expose more of the single search parameters.
+
+In addition, there are a few premium/paid access APIs that Trimble Maps has available such as Routing and Distance Matrix.

package/sampleWorkspace/connectors-community/connectors/trimblemaps/connector.graphql

@@ -0,0 +1,66 @@
+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: "trimblemaps"
+    http: {
+      baseURL: "https://singlesearch.alk.com/"
+      headers: [{ name: "Authorization", value: "{$config.api}" }]
+    }
+  )
+
+type Address {
+  shortFormatted: String
+  timezone: String!
+}
+
+type Geo {
+  lat: String!
+  long: String!
+}
+
+type Query {
+  """
+  PC*Miler Web Services - Single Search - https://developer.trimblemaps.com/restful-apis/location/single-search/single-search-api/
+  """
+  addressByGeo(lat: String!, long: String!): Address
+    @connect(
+      source: "trimblemaps"
+      http: {
+        GET: "ww/api/search"
+        queryParams: """
+        query: $([$args.lat, $args.long])->joinNotNull(",") 
+        matchNamedRoadsOnly: $('true')
+        maxCleanupMiles: $('0.2')
+        """
+      }
+      selection: """
+      # https://developer.trimblemaps.com/restful-apis/location/single-search/single-search-api/#kbd-classkbd-get-roundedgetkbd-search
+      shortFormatted:Locations->first.ShortString
+      timezone:Locations->first.TimeZone
+      """
+    )
+  locationByAddress(address: String!, city: String!, state: String!): Geo
+    @connect(
+      source: "trimblemaps"
+      http: {
+        GET: "na/api/search"
+        queryParams: """
+        query: $([$args.address, $args.city])->joinNotNull(",") 
+        states: $args.state
+        countries: $('US')
+        """
+      }
+      selection: """
+      # https://developer.trimblemaps.com/restful-apis/location/single-search/single-search-api/#kbd-classkbd-get-roundedgetkbd-search
+      lat:Locations->first.Coords.Lat
+      long:Locations->first.Coords.Lon
+      """
+    )
+}

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

@@ -0,0 +1,18 @@
+supergraph:
+  listen: 127.0.0.1:4000
+
+headers:
+  all:
+    request:
+      - propagate:
+          matching: .*
+telemetry:
+  instrumentation:
+    spans: 
+      mode: spec_compliant
+
+connectors:
+  subgraphs:
+    connector:
+      $config:
+        api: ${env.API_KEY}

package/sampleWorkspace/connectors-community/connectors/trimblemaps/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/twilio/README.md

@@ -0,0 +1,44 @@
+# Twilio REST API Connector
+
+This connector implements implements Twilio SMS APis and current covers sending and querying messages.
+
+## Prerequisites
+
+To use this connector you must have a Twilio account and verified phone number. See [Twilio documentation](https://www.twilio.com/docs/messaging/api/message-resource) for more information
+
+A Base64 encoded Bearer token is required. Generate this value and store it in your env.
+
+## 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