refactor: document data type flow (#1130)

Author: jasonkuhrt

examples/$/show.ts

@@ -9,7 +9,7 @@ export const show = <$Logger extends Logger = typeof console.log>(
   subTitle?: string,
 ): ReturnType<$Logger> => {
   const write = console.log
-  const inspected = inspect(value, { depth: null, colors: true })
+  const inspected = typeof value === 'string' ? value : inspect(value, { depth: null, colors: true })
   const message = renderShow(inspected, subTitle)
   return write(message) as ReturnType<$Logger>
 }

examples/55_generated/generated_arguments__arguments.ts

@@ -7,8 +7,9 @@ import { showJson } from '../$/helpers.js'
 
 const atlas = Pokemon.create()
 
+// dprint-ignore
 const pokemons = await atlas.query.pokemons({
-  $: { filter: { name: { in: [`Pikachu`, `Charizard`] } } },
+  $: { filter: { name: { in: [`Pikachu`, `Charizard`] } } },  // [!code highlight]
   name: true,
   trainer: { name: true },
 })

examples/__outputs__/10_transport-http/transport-http_abort.output.txt

@@ -1,2 +1,2 @@
 ---------------------------------------- SHOW ----------------------------------------
-'This operation was aborted'
+This operation was aborted

examples/__outputs__/10_transport-http/transport-http_extension_headers__dynamicHeaders.output.txt

@@ -4,7 +4,7 @@
   headers: Headers {
     accept: 'application/graphql-response+json; charset=utf-8, application/json; charset=utf-8',
     'content-type': 'application/json',
-    'x-sent-at-time': '1727319638284'
+    'x-sent-at-time': '1727365576054'
   },
   signal: undefined,
   method: 'post',

examples/__outputs__/20_output/output_envelope.output.txt

@@ -16,7 +16,7 @@
     headers: Headers {
       'content-type': 'application/graphql-response+json; charset=utf-8',
       'content-length': '104',
-      date: 'Thu, 26 Sep 2024 03:00:38 GMT',
+      date: 'Thu, 26 Sep 2024 15:46:16 GMT',
       connection: 'keep-alive',
       'keep-alive': 'timeout=5'
     },

examples/__outputs__/20_output/output_envelope_envelope-error__envelope-error.output.txt

@@ -5,7 +5,7 @@
         at runPipeline (/some/path/to/runPipeline.ts:XX:XX:18)
         at async Object.run (/some/path/to/main.ts:XX:XX:22)
         at async run (/some/path/to/client.ts:XX:XX:20)
-        at async executeRootType (/some/path/to/client.ts:XX:XX:12)
+        at async executeDocument (/some/path/to/client.ts:XX:XX:12)
         at async executeRootTypeField (/some/path/to/client.ts:XX:XX:20)
         at async <anonymous> (/some/path/to/output_envelope_envelope-error__envelope-error.ts:XX:XX:16) {
       context: {

examples/__outputs__/20_output/output_envelope_envelope_error-throw__envelope-error-throw.output.txt

@@ -7,7 +7,7 @@ ContextualError: There was an error in the extension "anonymous" (use named func
     at runPipeline (/some/path/to/runPipeline.ts:XX:XX:18)
     at async Object.run (/some/path/to/main.ts:XX:XX:22)
     at async run (/some/path/to/client.ts:XX:XX:20)
-    at async executeRootType (/some/path/to/client.ts:XX:XX:12)
+    at async executeDocument (/some/path/to/client.ts:XX:XX:12)
     at async executeRootTypeField (/some/path/to/client.ts:XX:XX:20)
     at async <anonymous> (/some/path/to/output_envelope_envelope_error-throw__envelope-error-throw.ts:XX:XX:1) {
   context: {

examples/__outputs__/20_output/output_return-error.output.txt

@@ -3,7 +3,7 @@ ContextualError: There was an error in the extension "anonymous" (use named func
     at runPipeline (/some/path/to/runPipeline.ts:XX:XX:18)
     at async Object.run (/some/path/to/main.ts:XX:XX:22)
     at async run (/some/path/to/client.ts:XX:XX:20)
-    at async executeRootType (/some/path/to/client.ts:XX:XX:12)
+    at async executeDocument (/some/path/to/client.ts:XX:XX:12)
     at async executeRootTypeField (/some/path/to/client.ts:XX:XX:20)
     at async <anonymous> (/some/path/to/output_return-error.ts:XX:XX:18) {
   context: {

examples/__outputs__/20_output/output_return-error_return-error-execution__return-error-execution.output.txt

@@ -3,7 +3,7 @@ ContextualAggregateError: One or more errors in the execution result.
     at handleOutput (/some/path/to/handleOutput.ts:XX:XX:19)
     at run (/some/path/to/client.ts:XX:XX:12)
     at process.processTicksAndRejections (node:internal/process/task_queues:XX:XX)
-    at async executeRootType (/some/path/to/client.ts:XX:XX:12)
+    at async executeDocument (/some/path/to/client.ts:XX:XX:12)
     at async executeRootTypeField (/some/path/to/client.ts:XX:XX:20)
     at async <anonymous> (/some/path/to/output_return-error_return-error-execution__return-error-execution.ts:XX:XX:16) {
   context: {},
@@ -40,7 +40,7 @@ ContextualError: There was an error in the extension "anonymous" (use named func
     at process.processTicksAndRejections (node:internal/process/task_queues:XX:XX)
     at async Object.run (/some/path/to/main.ts:XX:XX:22)
     at async run (/some/path/to/client.ts:XX:XX:20)
-    at async executeRootType (/some/path/to/client.ts:XX:XX:12)
+    at async executeDocument (/some/path/to/client.ts:XX:XX:12)
     at async executeRootTypeField (/some/path/to/client.ts:XX:XX:20)
     at async <anonymous> (/some/path/to/output_return-error_return-error-execution__return-error-execution.ts:XX:XX:3) {
   context: {

examples/__outputs__/60_extension/extension_opentelemetry__opentelemetry.output.txt

@@ -9,14 +9,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
-  parentId: 'ebd5237ad56b820c',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
+  parentId: 'fb04e4436519eebf',
   traceState: undefined,
   name: 'encode',
-  id: 'ff492c55cf5462ff',
+  id: 'b9cc31cb6dcef7bb',
   kind: 0,
-  timestamp: 1727319638868000,
-  duration: 1170.584,
+  timestamp: 1727365576823000,
+  duration: 586.292,
   attributes: {},
   status: { code: 0 },
   events: [],
@@ -33,14 +33,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
-  parentId: 'ebd5237ad56b820c',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
+  parentId: 'fb04e4436519eebf',
   traceState: undefined,
   name: 'pack',
-  id: '9174a3424a228e28',
+  id: 'fb77c65e19244b1f',
   kind: 0,
-  timestamp: 1727319638871000,
-  duration: 36417.291,
+  timestamp: 1727365576831000,
+  duration: 19896.75,
   attributes: {},
   status: { code: 0 },
   events: [],
@@ -57,14 +57,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
-  parentId: 'ebd5237ad56b820c',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
+  parentId: 'fb04e4436519eebf',
   traceState: undefined,
   name: 'exchange',
-  id: '85de30bd471a1d11',
+  id: '7e3a75386432d606',
   kind: 0,
-  timestamp: 1727319638909000,
-  duration: 24460.084,
+  timestamp: 1727365576852000,
+  duration: 29439.625,
   attributes: {},
   status: { code: 0 },
   events: [],
@@ -81,14 +81,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
-  parentId: 'ebd5237ad56b820c',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
+  parentId: 'fb04e4436519eebf',
   traceState: undefined,
   name: 'unpack',
-  id: '81208c873ce84df5',
+  id: '6263aef06e4164d0',
   kind: 0,
-  timestamp: 1727319638933000,
-  duration: 1301.541,
+  timestamp: 1727365576881000,
+  duration: 1157,
   attributes: {},
   status: { code: 0 },
   events: [],
@@ -105,14 +105,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
-  parentId: 'ebd5237ad56b820c',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
+  parentId: 'fb04e4436519eebf',
   traceState: undefined,
   name: 'decode',
-  id: '0e084f67d12e45c7',
+  id: 'f6e875f59111e613',
   kind: 0,
-  timestamp: 1727319638935000,
-  duration: 199.208,
+  timestamp: 1727365576883000,
+  duration: 193.042,
   attributes: {},
   status: { code: 0 },
   events: [],
@@ -129,14 +129,14 @@
     }
   },
   instrumentationScope: { name: 'graffle', version: undefined, schemaUrl: undefined },
-  traceId: '851f3f771b76e4969a2f8c084f85759d',
+  traceId: '99a1b00f220469bd559f6fdc09b75cfc',
   parentId: undefined,
   traceState: undefined,
   name: 'request',
-  id: 'ebd5237ad56b820c',
+  id: 'fb04e4436519eebf',
   kind: 0,
-  timestamp: 1727319638867000,
-  duration: 68430.791,
+  timestamp: 1727365576822000,
+  duration: 61277.208,
   attributes: {},
   status: { code: 0 },
   events: [],