feat(extension-system): transport now extensible

eslint.config.js

@@ -27,6 +27,7 @@ export default tsEslint.config({
     },
   },
   rules: {
+    ['prefer-arrow/prefer-arrow-functions']: 'off',
     ['@typescript-eslint/only-throw-error']: 'off',
     ['@typescript-eslint/no-unsafe-assignment']: 'off',
     ['@typescript-eslint/no-unsafe-call']: 'off',

examples/10_transport-http/transport-http_abort.ts

@@ -8,15 +8,13 @@ import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 const abortController = new AbortController()
 //    ^^^^^^^^^^^^^^^
 
-const graffle = Graffle.create({
-  schema: publicGraphQLSchemaEndpoints.Pokemon,
+const graffle = Graffle.create().transport({
+  url: publicGraphQLSchemaEndpoints.Pokemon,
 })
 
-graffle
-
 const resultPromise = graffle
-  .with({ transport: { raw: { signal: abortController.signal } } })
-  //                                  ^^^^^^^^^^^^^^^
+  .transport({ raw: { signal: abortController.signal } })
+  //                          ^^^^^^^^^^^^^^^
   .gql`
     {
       pokemon {

examples/10_transport-http/transport-http_extension_fetch__custom-fetch.ts

@@ -8,7 +8,8 @@ import { showJson } from '../$/helpers.js'
 import { publicGraphQLSchemaEndpoints } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
   .anyware(({ exchange }) =>
     exchange({
       using: {

examples/10_transport-http/transport-http_extension_headers__dynamicHeaders.ts

@@ -6,11 +6,12 @@
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({
-    schema: publicGraphQLSchemaEndpoints.Pokemon,
+  .create()
+  .transport({
+    url: publicGraphQLSchemaEndpoints.Pokemon,
   })
   .anyware(({ pack }) => {
     if (pack.input.transportType !== `http`) return pack()
     return pack({
       input: {
         ...pack.input,

examples/10_transport-http/transport-http_headers_raw__headers.ts

@@ -7,25 +7,24 @@
 import { publicGraphQLSchemaEndpoints } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({
-    schema: publicGraphQLSchemaEndpoints.Pokemon,
-    transport: {
+  .create()
+  .transport({
+    url: publicGraphQLSchemaEndpoints.Pokemon,
+    headers: {
+      authorization: `Bearer MY_TOKEN`,
+      'x-something-to-unset': `true`,
+    },
+    raw: {
       headers: {
-        authorization: `Bearer MY_TOKEN`,
-        'x-something-to-unset': `true`,
-      },
-      raw: {
-        headers: {
-          'x-from-raw': `true`,
-        },
+        'x-from-raw': `true`,
       },
     },
   })
-  .with({
-    transport: { headers: { 'x-something-to-unset': `` } },
+  .transport({
+    headers: { 'x-something-to-unset': `` },
   })
   .anyware(({ exchange }) => {
     if (exchange.input.transportType !== `http`) return exchange()
     show(exchange.input.request.headers)
     return exchange()
   })

examples/10_transport-http/transport-http_method-get.ts

@@ -7,11 +7,10 @@ import { Graffle } from '../../tests/_/schemas/pokemon/graffle/__.js'
 import { show } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({
-    transport: {
-      methodMode: `getReads`, // [!code highlight]
-      headers: { tenant: `nano` },
-    },
+  .create()
+  .transport({
+    methodMode: `getReads`, // [!code highlight]
+    headers: { tenant: `nano` },
   })
   .anyware(async ({ exchange }) => {
     show(exchange.input.request)

examples/10_transport-http/transport-http_raw.ts

@@ -7,12 +7,11 @@ import { show } from '../$/helpers.js'
 import { publicGraphQLSchemaEndpoints } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({
-    schema: publicGraphQLSchemaEndpoints.Pokemon,
-    transport: {
-      raw: {
-        mode: `cors`,
-      },
+  .create()
+  .transport({
+    url: publicGraphQLSchemaEndpoints.Pokemon,
+    raw: {
+      mode: `cors`,
     },
   })
   .anyware(async ({ exchange }) => {

examples/20_output/output_preset__standard-graphql.ts

@@ -5,10 +5,9 @@
 import { Graffle, Preset } from '../../src/entrypoints/main.js'
 import { show } from '../$/show.js'
 
-const graffle = Graffle.create({
-  schema: `...`,
-  output: Preset.traditionalGraphqlOutput,
-})
+const graffle = Graffle
+  .create({ output: Preset.traditionalGraphqlOutput })
+  .transport({ url: `...` })
 
 const result = await graffle.gql(`{ query { thisWillError } }`).send()
 

examples/30_gql/gql_gql-document-node.ts

@@ -8,9 +8,11 @@ import { Throws } from '../../src/entrypoints/extensions/throws/runtime.js'
 import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
-const graffle = Graffle.create({
-  schema: publicGraphQLSchemaEndpoints.Pokemon,
-})
+const graffle = Graffle
+  .create()
+  .transport({
+    url: publicGraphQLSchemaEndpoints.Pokemon,
+  })
   .use(Throws())
   .use(Opentelemetry())
 

examples/30_gql/gql_gql-document-node_gql-typed_gql-document-node-typed__gql-document-node-typed.ts

@@ -7,8 +7,8 @@ import { parse, type TypedQueryDocumentNode } from 'graphql'
 import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
-const graffle = Graffle.create({
-  schema: publicGraphQLSchemaEndpoints.Pokemon,
+const graffle = Graffle.create().transport({
+  url: publicGraphQLSchemaEndpoints.Pokemon,
 })
 
 type Document = TypedQueryDocumentNode<

examples/30_gql/gql_gql-string.ts

@@ -5,9 +5,7 @@
 import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
-const graffle = Graffle.create({
-  schema: publicGraphQLSchemaEndpoints.Pokemon,
-})
+const graffle = Graffle.create().transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
 
 const data = await graffle.gql`
   {

examples/30_gql/gql_gql-string_gql-typed__gql-string-typed.ts

@@ -7,9 +7,7 @@
 import { Graffle, type TypedDocument } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
-const graffle = Graffle.create({
-  schema: publicGraphQLSchemaEndpoints.Pokemon,
-})
+const graffle = Graffle.create().transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
 
 /**
  * @remarks Typically this type would come from your code generation tool.

examples/40_other/transport-memory.ts

@@ -4,6 +4,7 @@
 
 import { GraphQLObjectType, GraphQLSchema, GraphQLString } from 'graphql'
 import { Graffle } from '../../src/entrypoints/main.js'
+import { TransportMemory } from '../../src/extensions/TransportMemory/TransportMemory.js'
 import { showJson } from '../$/helpers.js'
 
 const schema = new GraphQLSchema({
@@ -18,7 +19,10 @@ const schema = new GraphQLSchema({
   }),
 })
 
-const graffle = Graffle.create({ schema })
+const graffle = Graffle
+  .create()
+  .use(TransportMemory({ schema }))
+  .transport(`memory`)
 
 const data = await graffle.gql`
   {

examples/50_anyware/anyware_jump-start__jump-start.ts

@@ -7,11 +7,12 @@
 import { publicGraphQLSchemaEndpoints } from '../$/helpers.js'
 
 Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
   // Notice how we **start** with the `exchange` hook, skipping the `encode` and `pack` hooks.
   .anyware(async ({ exchange }) => {
     //              ^^^^^^^^
     if (exchange.input.transportType !== `http`) return exchange()
 
     const mergedHeaders = new Headers(exchange.input.request.headers)
     mergedHeaders.set(`X-Custom-Header`, `123`)

examples/50_anyware/anyware_short-circuit__short-circuit.ts

@@ -7,12 +7,13 @@
 import { publicGraphQLSchemaEndpoints } from '../$/helpers.js'
 
 Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
   .anyware(async ({ encode }) => {
     const { pack } = await encode()
     const { exchange } = await pack()
 
     if (exchange.input.transportType !== `http`) return exchange()
 
     const mergedHeaders = new Headers(exchange.input.request.headers)
     mergedHeaders.set(`X-Custom-Header`, `123`)

examples/50_anyware/anyware_slot_slot-body__slot-body.ts

@@ -5,7 +5,8 @@ import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
   .anyware(async ({ pack }) => {
     return await pack({
       using: {

examples/50_anyware/anyware_slot_slot-body__slot-search-params.ts

@@ -5,7 +5,8 @@ import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon, transport: { methodMode: `getReads` } })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon, methodMode: `getReads` })
   .anyware(async ({ pack }) => {
     return await pack({
       using: {

examples/50_anyware/anyware_slot_slot-fetch__slot-fetch.ts

@@ -5,7 +5,8 @@ import { Graffle } from '../../src/entrypoints/main.js'
 import { publicGraphQLSchemaEndpoints, show } from '../$/helpers.js'
 
 const graffle = Graffle
-  .create({ schema: publicGraphQLSchemaEndpoints.Pokemon })
+  .create()
+  .transport({ url: publicGraphQLSchemaEndpoints.Pokemon })
   .anyware(async ({ exchange }) => {
     return await exchange({
       using: {

package.json

@@ -35,6 +35,21 @@
     "./extensions/schema-errors/generator": {
       "default": "./build/entrypoints/extensions/schema-errors/gentime.js"
     },
+    "./extensions/transport-memory": {
+      "default": "./build/entrypoints/extensions/transport-memory/runtime.js"
+    },
+    "./extensions/transport-http": {
+      "default": "./build/entrypoints/extensions/transport-http/runtime.js"
+    },
+    "./presets/bare": {
+      "default": "./build/entrypoints/presets/__GraffleBare.js"
+    },
+    "./presets/basic": {
+      "default": "./build/entrypoints/presets/__GraffleBasic.js"
+    },
+    "./presets/minimal": {
+      "default": "./build/entrypoints/presets/__GraffleMinimal.js"
+    },
     "./client": {
       "default": "./build/entrypoints/client.js"
     },