docs: improve docs/reference/types

.ghjk/lock.json

@@ -9,15 +9,15 @@
           "version": "0.13.5",
           "depConfigs": {
             "tar_aa": {
-              "version": "1.34",
+              "version": "1.35",
               "depConfigs": {},
               "portRef": "tar_aa@0.1.0"
             }
           },
           "portRef": "wasmedge_ghrel@0.1.0"
         },
         "9e3fa7742c431c34ae7ba8d1e907e50c937ccfb631fb4dcfb7a1773742abe267": {
-          "version": "1.34",
+          "version": "1.35",
           "depConfigs": {},
           "portRef": "tar_aa@0.1.0"
         },
@@ -30,20 +30,20 @@
           "version": "3.28.0-rc6",
           "depConfigs": {
             "curl_aa": {
-              "version": "8.2.1",
+              "version": "8.5.0",
               "depConfigs": {},
               "portRef": "curl_aa@0.1.0"
             },
             "git_aa": {
-              "version": "2.40.1",
+              "version": "2.43.0",
               "depConfigs": {},
               "portRef": "git_aa@0.1.0"
             },
             "asdf_plugin_git": {
               "version": "d631481e96",
               "depConfigs": {
                 "git_aa": {
-                  "version": "2.40.1",
+                  "version": "2.43.0",
                   "depConfigs": {},
                   "portRef": "git_aa@0.1.0"
                 }
@@ -63,20 +63,20 @@
           "installType": "version"
         },
         "c7d12a562ecc8f3f95df5469ec0272561bc6715ebc41bcd82ba94f17a69a6fcb": {
-          "version": "8.2.1",
+          "version": "8.5.0",
           "depConfigs": {},
           "portRef": "curl_aa@0.1.0"
         },
         "0c719c533251d13d9e84b3113733c9dcd9e48f978c02f3fc4e14816080f7a69e": {
-          "version": "2.40.1",
+          "version": "2.43.0",
           "depConfigs": {},
           "portRef": "git_aa@0.1.0"
         },
         "9ffe0540cc740abe4bae8b926d9f53b78deee279a25c863e64e99263ee0ec7d1": {
           "version": "d631481e96",
           "depConfigs": {
             "git_aa": {
-              "version": "2.40.1",
+              "version": "2.43.0",
               "depConfigs": {},
               "portRef": "git_aa@0.1.0"
             }
@@ -109,7 +109,7 @@
                   "version": "1.27.0",
                   "depConfigs": {
                     "git_aa": {
-                      "version": "2.40.1",
+                      "version": "2.43.0",
                       "depConfigs": {},
                       "portRef": "git_aa@0.1.0"
                     }
@@ -132,7 +132,7 @@
               "version": "1.27.0",
               "depConfigs": {
                 "git_aa": {
-                  "version": "2.40.1",
+                  "version": "2.43.0",
                   "depConfigs": {},
                   "portRef": "git_aa@0.1.0"
                 }
@@ -147,7 +147,7 @@
           "version": "1.27.0",
           "depConfigs": {
             "git_aa": {
-              "version": "2.40.1",
+              "version": "2.43.0",
               "depConfigs": {},
               "portRef": "git_aa@0.1.0"
             }
@@ -169,7 +169,7 @@
                   "version": "1.27.0",
                   "depConfigs": {
                     "git_aa": {
-                      "version": "2.40.1",
+                      "version": "2.43.0",
                       "depConfigs": {},
                       "portRef": "git_aa@0.1.0"
                     }
@@ -200,7 +200,7 @@
                   "version": "1.27.0",
                   "depConfigs": {
                     "git_aa": {
-                      "version": "2.40.1",
+                      "version": "2.43.0",
                       "depConfigs": {},
                       "portRef": "git_aa@0.1.0"
                     }
@@ -220,7 +220,7 @@
           "version": "v20.8.0",
           "depConfigs": {
             "tar_aa": {
-              "version": "1.34",
+              "version": "1.35",
               "depConfigs": {},
               "portRef": "tar_aa@0.1.0"
             }
@@ -239,7 +239,7 @@
               "version": "v20.8.0",
               "depConfigs": {
                 "tar_aa": {
-                  "version": "1.34",
+                  "version": "1.35",
                   "depConfigs": {},
                   "portRef": "tar_aa@0.1.0"
                 }
@@ -257,7 +257,7 @@
               "version": "v20.8.0",
               "depConfigs": {
                 "tar_aa": {
-                  "version": "1.34",
+                  "version": "1.35",
                   "depConfigs": {},
                   "portRef": "tar_aa@0.1.0"
                 }
@@ -272,7 +272,7 @@
           "version": "v2.4.0",
           "depConfigs": {
             "tar_aa": {
-              "version": "1.34",
+              "version": "1.35",
               "depConfigs": {},
               "portRef": "tar_aa@0.1.0"
             }
@@ -284,7 +284,7 @@
           "version": "3.8.18",
           "depConfigs": {
             "tar_aa": {
-              "version": "1.34",
+              "version": "1.35",
               "depConfigs": {},
               "portRef": "tar_aa@0.1.0"
             },
@@ -309,7 +309,7 @@
               "version": "3.12.2",
               "depConfigs": {
                 "tar_aa": {
-                  "version": "1.34",
+                  "version": "1.35",
                   "depConfigs": {},
                   "portRef": "tar_aa@0.1.0"
                 },
@@ -330,7 +330,7 @@
           "version": "3.12.2",
           "depConfigs": {
             "tar_aa": {
-              "version": "1.34",
+              "version": "1.35",
               "depConfigs": {},
               "portRef": "tar_aa@0.1.0"
             },
@@ -350,7 +350,7 @@
               "version": "3.12.2",
               "depConfigs": {
                 "tar_aa": {
-                  "version": "1.34",
+                  "version": "1.35",
                   "depConfigs": {},
                   "portRef": "tar_aa@0.1.0"
                 },
@@ -387,7 +387,7 @@
                   "version": "1.27.0",
                   "depConfigs": {
                     "git_aa": {
-                      "version": "2.40.1",
+                      "version": "2.43.0",
                       "depConfigs": {},
                       "portRef": "git_aa@0.1.0"
                     }

examples/typegraphs/faas-runner.ts

@@ -5,7 +5,7 @@ import { PythonRuntime } from "@typegraph/sdk/runtimes/python.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "faas-runner",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },
@@ -20,7 +20,7 @@ await typegraph({
 
   g.expose({
     pycumsum: python.fromLambda(inp, out, {
-      code: `lambda inp: sum(range(inp["n"])`,
+      code: `lambda inp: sum(range(inp["n"]))`,
     }),
     tscumsum: deno.func(
       inp,

examples/typegraphs/iam-provider.ts

@@ -14,7 +14,7 @@ function getEnvOrDefault(key: string, defaultValue: string) {
 }
 // skip:end
 
-await typegraph({
+typegraph({
   name: "iam-provider",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/index.ts

@@ -7,7 +7,7 @@ import { HttpRuntime } from "@typegraph/sdk/runtimes/http.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "homepage",
   // skip:start
   rate: { windowLimit: 2000, windowSec: 60, queryLimit: 200, localExcess: 0 },

examples/typegraphs/injections.py

@@ -0,0 +1,35 @@
+from typegraph import Policy, typegraph, t, Graph
+from typegraph.runtimes.deno import DenoRuntime
+
+
+@typegraph()
+def injection_example(g: Graph):
+    deno = DenoRuntime()
+    pub = Policy.public()
+
+    g.expose(
+        get_injected=deno.func(
+            t.struct(
+                {
+                    "static_value": t.integer().set(12),
+                    "context_value": t.uuid().from_context("profile.userId"),
+                    "secret_value": t.string().from_secret("secret_name"),
+                    "dynamic_value": t.datetime().inject("now"),
+                }
+            ).rename("Input"),
+            t.struct(
+                {
+                    "static_value": t.integer().rename("Static"),
+                    "context_value": t.uuid(),
+                    "secret_value": t.string(),
+                    "nested": deno.identity(
+                        t.struct({"parent_value": t.integer().from_parent("Static")}),
+                    ),
+                    "dynamic_value": t.datetime(),
+                }
+            ).rename("Output"),
+            code="""
+            ({ static_value, context_value, secret_value, dynamic_value }) => ({ static_value, context_value, secret_value, dynamic_value })
+            """,
+        ).with_policy(pub)
+    )

examples/typegraphs/injections.ts

@@ -0,0 +1,34 @@
+import { Policy, t, typegraph } from "@typegraph/sdk";
+import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
+
+typegraph("injection-example", (g) => {
+  const deno = new DenoRuntime();
+  const pub = Policy.public();
+
+  g.expose({
+    get_injected: deno.func(
+      t.struct({
+        static_value: t.integer().set(12),
+        context_value: t.uuid().fromContext("profile.userId"),
+        secret_value: t.string().fromSecret("secret_name"),
+        dynamic_value: t.datetime().inject("now"),
+      }).rename("Input"),
+      t.struct({
+        static_value: t.integer().rename("Static"),
+        context_value: t.uuid(),
+        secret_value: t.string(),
+        nested: deno.identity(
+          t.struct({
+            parent_value: t.integer().fromParent("Static"),
+          }),
+        ),
+        dynamic_value: t.datetime(),
+      }).rename("Output"),
+      {
+        code: (
+          { static_value, context_value, secret_value, dynamic_value },
+        ) => ({ static_value, context_value, secret_value, dynamic_value }),
+      },
+    ).withPolicy(pub),
+  });
+});

examples/typegraphs/jwt.ts

@@ -5,7 +5,7 @@ import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "jwt-authentication",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/math.ts

@@ -3,7 +3,7 @@ import { Policy, t, typegraph } from "@typegraph/sdk/index.js";
 // skip:end
 import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 
-await typegraph({
+typegraph({
   name: "math",
   // skip:start
   rate: { windowLimit: 2000, windowSec: 60, queryLimit: 200, localExcess: 0 },

examples/typegraphs/microservice-orchestration.ts

@@ -15,7 +15,7 @@ function getEnvOrDefault(key: string, defaultValue: string) {
 }
 // skip:end
 
-await typegraph({
+typegraph({
   name: "team-a",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/oauth2.ts

@@ -5,7 +5,7 @@ import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "oauth2-authentication",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/policies.ts

@@ -4,7 +4,7 @@ import { Auth } from "@typegraph/sdk/params.js";
 import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 import { RandomRuntime } from "@typegraph/sdk/runtimes/random.js";
 
-await typegraph({
+typegraph({
   name: "policies",
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },
 }, (g) => {

examples/typegraphs/prisma-runtime.ts

@@ -5,7 +5,7 @@ import { PrismaRuntime } from "@typegraph/sdk/providers/prisma.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "prisma-runtime",
   cors: {
     // skip:start

examples/typegraphs/prisma.ts

@@ -1,7 +1,7 @@
 import { Policy, t, typegraph } from "@typegraph/sdk/index.js";
 import { PrismaRuntime } from "@typegraph/sdk/providers/prisma.js";
 
-await typegraph({
+typegraph({
   name: "roadmap-prisma",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/programmable-api-gateway.ts

@@ -5,7 +5,7 @@ import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 
 // skip:end
 
-await typegraph({
+typegraph({
   name: "programmable-api-gateway",
   // skip:next-line
   cors: { allowOrigin: ["https://metatype.dev", "http://localhost:3000"] },

examples/typegraphs/quick-start-project.ts

@@ -3,7 +3,7 @@ import { DenoRuntime } from "@typegraph/sdk/runtimes/deno.js";
 import { PythonRuntime } from "@typegraph/sdk/runtimes/python.js";
 import { PrismaRuntime } from "@typegraph/sdk/providers/prisma.js";
 
-await typegraph("example", (g) => {
+typegraph("example", (g) => {
   // access control
   const pub = Policy.public();