var Component=(()=>{var p=Object.create;var l=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var g=(a,e)=>()=>(e||a((e={exports:{}}).exports,e),e.exports),f=(a,e)=>{for(var s in e)l(a,s,{get:e[s],enumerable:!0})},t=(a,e,s,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of u(e))!k.call(a,c)&&c!==s&&l(a,c,{get:()=>e[c],enumerable:!(i=m(e,c))||i.enumerable});return a};var w=(a,e,s)=>(s=a!=null?p(N(a)):{},t(e||!a||!a.__esModule?l(s,"default",{value:a,enumerable:!0}):s,a)),y=a=>t(l({},"__esModule",{value:!0}),a);var r=g((T,o)=>{o.exports=_jsx_runtime});var v={};f(v,{default:()=>h,frontmatter:()=>b});var n=w(r()),b={title:"Hooks"};function d(a){let e={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",span:"span",ul:"ul",...a.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(e.h1,{children:"Customizing the Grafbase Gateway with hooks"}),` `,(0,n.jsxs)(e.p,{children:["You can customize the Grafbase Gateway with dynamically loaded WebAssembly system interface (WASI) components. ",(0,n.jsx)(e.a,{href:"https://component-model.bytecodealliance.org/language-support.html",children:"A selection of languages"})," are available for implementing the guest components. Rust together with the ",(0,n.jsx)(e.a,{href:"https://github.com/bytecodealliance/cargo-component",children:"Cargo component"})," subcommand is the recommended tool set, with it being the most robust and easy to use solution for building WASI components."]}),` `,(0,n.jsx)(e.p,{children:"WASI Preview 2 introduces features unavailable in previous versions, such as network requests and file system access. Note that not every library currently supports network access from WASI. Check the final chapter for tested libraries."}),` `,(0,n.jsx)(e.h2,{children:"Gateway configuration"}),` `,(0,n.jsx)(e.p,{children:"You must deploy the Grafbase Gateway together with the WASM file containing the code for the custom hooks. The first Grafbase Gateway version with support for custom hooks is 0.4.0."}),` `,(0,n.jsx)(e.p,{children:"The minimum configuration to enable hooks must define a valid path to the WASM component:"}),` `,(0,n.jsx)(e.pre,{className:"language-toml",children:(0,n.jsxs)(e.code,{className:"language-toml code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"hooks"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"location"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"path/to/custom.component.wasm"'}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"When starting the Gateway, it will display a log if the component loaded successfully. By default, the WASM component has no IO access enabled. You can enable access gradually with the following boolean options:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"networking"})," enables network access with TCP and UDP sockets, name resolution and provides WASI HTTP bindings to the guest. Keep in mind the TCP and UDP sockets only work if the guest language provides support to the WASI preview 2 standard."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"stdout"})," enables the guest to write to the standard output stream."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"stderr"})," enables the guest to write to the standard error stream."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"environment_variables"})," copies the all the host environment variables to the guest."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"You can enable guest access to the filesystem by defining one or more pre-opened directories:"}),` `,(0,n.jsx)(e.pre,{className:"language-toml",children:(0,n.jsxs)(e.code,{className:"language-toml code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"hooks.preopened_directories"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"host_path"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"/path/in/host/filesystem"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"guest_path"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"/path/in/guest/filesystem"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"read_permission"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"true"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"write_permission"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"true"}),` `]})]})}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"host_path"})," should point to an existing directory in the host filesystem. The user executing the Grafbase Gateway binary must have access to the given directory."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"guest_path"})," sets the path which is visible in the guest. This path is virtual and can be any value. The guest must use this path when accessing the filesystem."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"read_permission"})," enables reading all files and directories from the given ",(0,n.jsx)(e.code,{children:"host_path"}),"."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"write_permission"})," enables creating and modifying files and directories in the given ",(0,n.jsx)(e.code,{children:"host_path"}),"."]}),` `]}),` `,(0,n.jsx)(e.h2,{children:"WebAssembly Interface Type"}),` `,(0,n.jsxs)(e.p,{children:["Grafbase ",(0,n.jsx)(e.a,{href:"https://github.com/grafbase/grafbase/blob/main/engine/crates/wasi-component-loader/gateway-hooks.wit",children:"provides a WebAssembly Interface Type (WIT) file"})," which defines all the interfaces for communication between the host and the guest. The file defines all the types available in the guest, together with the hook function interfaces. You can define the hook functions you want to implement in the world section by exporting the corresponding function interfaces."]}),` `,(0,n.jsx)(e.p,{children:"There will be more hooks in the future Gateway versions. If you use hooks in your deployment, it's a good idea to read the changelog and adapt to any changes in the WIT definition and guest implementation."}),` `,(0,n.jsx)(e.h3,{children:"Context resource"}),` `,(0,n.jsx)(e.p,{children:"The context object is a key-value store available in all hooks during the request lifetime. You can store information into the context object in the beginning of the request, and read it in every subsequent hook. The values are strings, and if needing more structured data, consider storing it as JSON string."}),` `,(0,n.jsx)(e.p,{children:"In the gateway request hook, the storage is mutable and provides the following methods:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"get"})," fetches a value from the context with the given name, returning none if the value doesn't exist."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"set"})," stores a value to the context with the given name."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"delete"})," deletes a value from the context with the given name, returning it if existing."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Hooks called after the gateway request get a shared version of the context, which provides read-only access to key-value storage. Additionally the shared context object provides the following methods:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"trace-id"})," returns the OpenTelemetry trace id value for the current request on systems enabling OpenTelemetry metrics."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"log-access"})," stores the given vector of bytes to the system access log file, if enabled."]}),` `]}),` `,(0,n.jsx)(e.h3,{children:"Headers resource"}),` `,(0,n.jsx)(e.p,{children:"In the gateway request hook, the request headers are available to read and modify. The interface works similarly to the context methods, but they will return an error if the given header names or values contain characters not allowed in headers."}),` `,(0,n.jsx)(e.p,{children:"The following methods are available:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"get"})," fetches a header value with the given name."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"set"})," sets a header value with the given name."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"delete"})," removes a header value with the given name. The method returns the value on successful deletion."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"entries"})," lists all header key value pairs"]}),` `]}),` `,(0,n.jsx)(e.h3,{children:"Header error"}),` `,(0,n.jsx)(e.p,{children:"You must provide valid strings for header names and values with only ASCII characters. Otherwise the host responds with an error."}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"invalid-header-name"}),": you provided an invalid header name."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"invalid-header-value"}),": you provided an invalid header value."]}),` `]}),` `,(0,n.jsx)(e.h3,{children:"Error"}),` `,(0,n.jsx)(e.p,{children:"The hook can return a GraphQL error. Depending on the hook, the engine either stops processing the request or it adds the error to the request errors and continues processing other parts of the request. The error struct has the following fields:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"message"}),": custom string message."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"extensions"})," is a list of tuples. The first part of the tuple is the name of the extension, and the second part the contents of the extension. The content can be a string, and if needing more structured data the value can be JSON encoded as string. If the value is JSON, the engine returns it in the structured form."]}),` `]}),` `,(0,n.jsxs)(e.p,{children:["If ",(0,n.jsx)(e.code,{children:"code"})," is provided in the ",(0,n.jsx)(e.code,{children:"extensions"}),", it will override the default error code set by the gateway."]}),` `,(0,n.jsx)(e.h3,{children:"Edge definition"}),` `,(0,n.jsx)(e.p,{children:"The engine calls the edge authorization functions with an edge definition, which holds the following data:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"parent-type-name"}),": is the name of the type the edge is part of."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"field-name"}),": is the name of the field."]}),` `]}),` `,(0,n.jsx)(e.h3,{children:"Node definition"}),` `,(0,n.jsx)(e.p,{children:"The engine calls the node authorization functions with a node definition, which holds the following data:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"type-name"}),": is the name of the node's type."]}),` `]}),` `,(0,n.jsx)(e.h2,{children:"Hooks"}),` `,(0,n.jsx)(e.p,{children:"The following hooks are available in the Grafbase Gateway. The engine will call the hook if exporting it in the world section of the WIT file and the guest implements it."}),` `,(0,n.jsx)(e.h3,{children:"Gateway request"}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.4.0."}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"gateway-request"})," interface defines a hook function which the engine calls just before authentication in the federated gateway. It gives a mutable access to the context object, and a mutable access to the request headers. By returning an ",(0,n.jsx)(e.code,{children:"Ok"})," the request execution will continue and by returning an error, the engine ends the execution and the given error returned to the client."]}),` `,(0,n.jsx)(e.p,{children:"The hook has the following WIT definition:"}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`interface gateway-request { `}),(0,n.jsx)(e.span,{className:"code-line",children:` use types.{headers, error, context}; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called in the federated gateway just before authentication. It can be used `}),(0,n.jsx)(e.span,{className:"code-line",children:` // to read and modify the request headers. The context object is provided in a mutable form, `}),(0,n.jsx)(e.span,{className:"code-line",children:` // allowing storage for the subsequent hooks to read. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // If returning an error from the hook, the request processing is stopped and the given error `}),(0,n.jsx)(e.span,{className:"code-line",children:` // returned to the client. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-gateway-request: func(context: context, headers: headers) -> result<_, error>; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsx)(e.h3,{children:"Subgraph request"}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"subgraph-request"})," interface defines a hook function which the engine calls just before sending the HTTP request to the subgraph allowing header modifications. If an error is returned, the subgraph request won't be executed and will be considered as failed with the provided error. The hook has the following WIT definition:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`interface subgraph-request { `}),(0,n.jsx)(e.span,{className:"code-line",children:` use types.{shared-context, headers, error}; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called just before sending the HTTP request to the subgraph. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-subgraph-request: func(context: shared-context, subgraph-name: string, method: string, url: string, headers: headers) -> result<_, error>; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsx)(e.h3,{children:"Authorization"}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"authorization"})," interface defines hook functions which are called when fetching data for a node or an edge defining an ",(0,n.jsxs)(e.a,{href:"/docs/federation/federation-directives#authorized",children:[(0,n.jsx)(e.code,{children:"@authorized"})," directive"]}),"."]}),` `,(0,n.jsx)(e.p,{children:"The interface must implement the following hooks has the following WIT definition:"}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`interface authorization { `}),(0,n.jsx)(e.span,{className:"code-line",children:` use types.{error, shared-context, edge-definition, node-definition}; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called in the request cycle if the schema defines an authorization directive on `}),(0,n.jsx)(e.span,{className:"code-line",children:` // an edge, providing the arguments of the edge selected in the directive, the definition of the esge `}),(0,n.jsx)(e.span,{className:"code-line",children:` // and the metadata of the directive to the hook. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is run before fetching any data. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The result, if an error, will stop the request execution and return an error back to the user. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Result of the edge will be null for an error response. `}),(0,n.jsx)(e.span,{className:"code-line",children:` authorize-edge-pre-execution: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` definition: edge-definition, `}),(0,n.jsx)(e.span,{className:"code-line",children:` arguments: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` metadata: string `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> result<_, error>; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called in the request cycle if the schema defines an authorization directive to `}),(0,n.jsx)(e.span,{className:"code-line",children:` // a node, providing the definition of the node and the metadata of the directive to the hook. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is run before fetching any data. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The result, if an error, will stop the request execution and return an error back to the user. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Result of the edge will be null for an error response. `}),(0,n.jsx)(e.span,{className:"code-line",children:` authorize-node-pre-execution: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` definition: node-definition, `}),(0,n.jsx)(e.span,{className:"code-line",children:` metadata: string `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> result<_, error>; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:" // Called when `@authorized` is used on a field with `fields` argument:\n"}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // type User { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // id: ID! `}),(0,n.jsx)(e.span,{className:"code-line",children:` // address: Address @authorized(fields: "id") `}),(0,n.jsx)(e.span,{className:"code-line",children:` // } `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The engine calls the hook after the subgraph response has arrived with the list of parent fields for `}),(0,n.jsx)(e.span,{className:"code-line",children:` // every node containing the address field. `}),(0,n.jsx)(e.span,{className:"code-line",children:` authorize-parent-edge-post-execution: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` definition: edge-definition, `}),(0,n.jsx)(e.span,{className:"code-line",children:` parents: list, `}),(0,n.jsx)(e.span,{className:"code-line",children:` metadata: string `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> list>; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:" // Called when `@authorized` is used on a field with `node` argument:\n"}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // type User { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // id: ID! `}),(0,n.jsx)(e.span,{className:"code-line",children:` // } `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // type Query { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // users: [User]! @authorized(node: "id") `}),(0,n.jsx)(e.span,{className:"code-line",children:` // } `}),(0,n.jsx)(e.span,{className:"code-line",children:` // `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The engine calls the hook after the subgraph response has arrived with the list of nodes (User here) for the `}),(0,n.jsx)(e.span,{className:"code-line",children:` // field. `}),(0,n.jsx)(e.span,{className:"code-line",children:` authorize-edge-node-post-execution: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` definition: edge-definition, `}),(0,n.jsx)(e.span,{className:"code-line",children:` nodes: list, `}),(0,n.jsx)(e.span,{className:"code-line",children:` metadata: string `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> list>; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.h4,{children:["The ",(0,n.jsx)(e.code,{children:"authorize-edge-pre-execution"})," hook"]}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.4.0."}),` `,(0,n.jsxs)(e.p,{children:["Called when ",(0,n.jsx)(e.code,{children:"@authorized"})," is applied on a field with ",(0,n.jsx)(e.code,{children:"arguments"}),":"]}),` `,(0,n.jsx)(e.pre,{className:"language-graphql",children:(0,n.jsxs)(e.code,{className:"language-graphql code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Query"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"user"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token attr-name",children:"id"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"ID"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"User"})," ",(0,n.jsx)(e.span,{className:"token directive function",children:"@authorized"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token attr-name",children:"arguments"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"id"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["The engine calls the hook when a query accesses a field with an ",(0,n.jsx)(e.code,{children:"@authorize"})," directive on the ",(0,n.jsx)(e.a,{href:"/docs/federation/federation-directives#edge-level-pre-request-hook",children:"edge level"})," before executing the query."]}),` `,(0,n.jsx)(e.p,{children:"Engine calls the hook before executing the query with the following:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"context"})," is the request context object, which can be populated in the ",(0,n.jsx)(e.code,{children:"on-gateway-request"})," hook."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"definition"})," defines the edge with its parent type name and the name of the field."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"arguments"})," is JSON data in string form, with data taken from the query arguments."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"metadata"})," is static JSON data in string form taken from the directive's metadata argument."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Result of the hook can be one of the following:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"An empty response allows the request to fetch the data."}),` `,(0,n.jsxs)(e.li,{children:["An ",(0,n.jsx)(e.code,{children:"error"})," which stops the execution of the request and returns an error back to the user. The requested data will be ",(0,n.jsx)(e.code,{children:"null"}),"."]}),` `]}),` `,(0,n.jsxs)(e.p,{children:["If the queried edge is returning an optional value, this value will be set ",(0,n.jsx)(e.code,{children:"null"})," and an error added to the response errors. If the edge is returning a required value, the ",(0,n.jsx)(e.code,{children:"null"})," gets propagated up to the first nullable edge."]}),` `,(0,n.jsxs)(e.h4,{children:["The ",(0,n.jsx)(e.code,{children:"authorize-parent-edge-post-execution"})," hook"]}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.7.0."}),` `,(0,n.jsxs)(e.p,{children:["Called when ",(0,n.jsx)(e.code,{children:"@authorized"})," is applied on a field with ",(0,n.jsx)(e.code,{children:"fields"}),":"]}),` `,(0,n.jsx)(e.pre,{className:"language-graphql",children:(0,n.jsxs)(e.code,{className:"language-graphql code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"User"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"id"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"ID"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"address"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Address"})," ",(0,n.jsx)(e.span,{className:"token directive function",children:"@authorized"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token attr-name",children:"fields"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"id"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"The engine will call the hook after the subgraph response has arrived with:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"context"})," is the request context object, which can be populated in the ",(0,n.jsx)(e.code,{children:"on-gateway-request"})," hook."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"definition"})," defines the edge with its parent type name and the name of the field."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"parents"})," is a list of parent fields, defined by the ",(0,n.jsx)(e.code,{children:"fields"})," directive argument, serialized in JSON."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"metadata"})," is static JSON data in string form taken from the directive's metadata argument."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Result is a list of results for each parent. If empty the field is authorized for this particular parent otherwise it's denied and an error is raised and propagated following GraphQL spec instead."}),` `,(0,n.jsxs)(e.h4,{children:["The ",(0,n.jsx)(e.code,{children:"authorize-edge-node-post-execution"})," hook"]}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.7.0."}),` `,(0,n.jsxs)(e.p,{children:["Called when ",(0,n.jsx)(e.code,{children:"@authorized"})," is applied on a field with ",(0,n.jsx)(e.code,{children:"node"}),":"]}),` `,(0,n.jsx)(e.pre,{className:"language-graphql",children:(0,n.jsxs)(e.code,{className:"language-graphql code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"User"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"id"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"ID"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Query"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"users"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token class-name",children:"User"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"})," ",(0,n.jsx)(e.span,{className:"token directive function",children:"@authorized"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token attr-name",children:"node"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"id"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"The engine will call the hook after the subgraph response has arrived with:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"context"})," is the request context object, which can be populated in the ",(0,n.jsx)(e.code,{children:"on-gateway-request"})," hook."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"definition"})," defines the edge with its parent type name and the name of the field."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"nodes"})," is a list of field output nodes with the selected fields defined by the ",(0,n.jsx)(e.code,{children:"node"})," directive argument, serialized in JSON."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"metadata"})," is static JSON data in string form taken from the directive's metadata argument."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Result is a list of results for each node. If empty the node is authorized, otherwise it's denied and an error is raised and propagated following GraphQL spec instead."}),` `,(0,n.jsxs)(e.h4,{children:["The ",(0,n.jsx)(e.code,{children:"authorize-node-pre-execution"})," hook"]}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.4.0."}),` `,(0,n.jsxs)(e.p,{children:["The engine calls the hook when a query accesses a type with an ",(0,n.jsx)(e.code,{children:"@authorize"})," directive on the ",(0,n.jsx)(e.a,{href:"/docs/federation/federation-directives#node-level-pre-request-hook",children:"node level"})," before executing the query."]}),` `,(0,n.jsx)(e.p,{children:"Engine sends the following data to the hook:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"context"})," is the request context object, which can be populated in the ",(0,n.jsx)(e.code,{children:"on-gateway-request"})," hook."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"definition"})," defines the node with the name of the type."]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:"metadata"})," is static JSON data in string form taken from the directive's metadata argument."]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Result of the hook can be one of the following:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"An empty response allows the request to fetch the data."}),` `,(0,n.jsxs)(e.li,{children:["An ",(0,n.jsx)(e.code,{children:"error"})," which stops the execution of the request and returns an error back to the user. The requested data will be ",(0,n.jsx)(e.code,{children:"null"}),"."]}),` `]}),` `,(0,n.jsxs)(e.p,{children:["If the hook returns an error, the part of the query which tries to access the given node will return ",(0,n.jsx)(e.code,{children:"null"})," together with the error defined in the hook. If the field is required, the ",(0,n.jsx)(e.code,{children:"null"})," value is propagated up to the first optional field in the query."]}),` `,(0,n.jsx)(e.p,{children:"For the following types:"}),` `,(0,n.jsx)(e.pre,{className:"language-graphql",children:(0,n.jsxs)(e.code,{className:"language-graphql code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"User"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"address"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Address"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"secret"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Secret"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Address"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"street"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"String"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Secret"})," ",(0,n.jsx)(e.span,{className:"token directive function",children:"@authorized"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"socialSecurityNumber"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"String"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["A failing authorization for the ",(0,n.jsx)(e.code,{children:"Secret"})," node will return the following data:"]}),` `,(0,n.jsx)(e.pre,{className:"language-json",children:(0,n.jsxs)(e.code,{className:"language-json code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"data"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token string",children:'"user"'})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"address"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"})," ",(0,n.jsx)(e.span,{className:"token property",children:'"street"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"123 Folsom Street"'})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[' "secret',(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token null keyword",children:"null"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"errors"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"message"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"the message from the hook error response"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"path"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["})," ",(0,n.jsx)(e.span,{className:"token string",children:'"user"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token string",children:'"secret"'})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"extensions"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"})," ... ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["If the ",(0,n.jsx)(e.code,{children:"secret"})," field in the ",(0,n.jsx)(e.code,{children:"User"})," type is required:"]}),` `,(0,n.jsx)(e.pre,{className:"language-graphql",children:(0,n.jsxs)(e.code,{className:"language-graphql code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"User"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"address"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Address"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"secret"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Secret"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Address"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"street"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"String"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Secret"})," ",(0,n.jsx)(e.span,{className:"token directive function",children:"@authorized"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token attr-name",children:"socialSecurityNumber"}),(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token scalar",children:"String"}),(0,n.jsx)(e.span,{className:"token operator",children:"!"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["A failing authorization for the ",(0,n.jsx)(e.code,{children:"Secret"})," node will propagate the null value to the first optional parent node:"]}),` `,(0,n.jsx)(e.pre,{className:"language-json",children:(0,n.jsxs)(e.code,{className:"language-json code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"data"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token null keyword",children:"null"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"errors"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"message"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token string",children:'"the message from the hook error response"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"path"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["})," ",(0,n.jsx)(e.span,{className:"token string",children:'"user"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token string",children:'"secret"'})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token property",children:'"extensions"'}),(0,n.jsx)(e.span,{className:"token operator",children:":"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"})," ... ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsx)(e.h3,{children:"Access logs with response hooks"}),` `,(0,n.jsx)(e.p,{children:"Available in Gateway version 0.12.0."}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"responses"})," interface defines three hook functions that the engine calls after executing certain steps of its pipeline. These hooks do not get called for subscriptions, only queries and mutations. They provide access to various metrics and shared methods for logging access information. Unlike system logs, access logs allow you to customize what gets logged, when it occurs, and how it formats."]}),` `,(0,n.jsx)(e.p,{children:"Enable access logs in the Gateway configuration:"}),` `,(0,n.jsx)(e.pre,{className:"language-toml",children:(0,n.jsxs)(e.code,{className:"language-toml code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"gateway.access_logs"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"enabled"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"true"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"path"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"/path/to/logs"'}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.a,{href:"/docs/self-hosted-gateway#gateway-configuration",children:"Read more"})," on configuration options."]}),` `,(0,n.jsxs)(e.p,{children:["With access logs enabled, invoking the ",(0,n.jsx)(e.code,{children:"log-access"})," method from the shared context will append the specified bytes to a file called ",(0,n.jsx)(e.code,{children:"access.log"})," in the configured path."]}),` `,(0,n.jsx)(e.p,{children:"The response hooks provide access to various points during the request's lifecycle:"}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`interface responses { `}),(0,n.jsx)(e.span,{className:"code-line",children:` use types.{shared-context, executed-operation, executed-subgraph-request, executed-http-request, operation}; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called after a subgraph entity has been either requested or fetched from cache. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The output is a list of bytes, which will be available in the on-operation-response hook. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-subgraph-response: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` request: executed-subgraph-request, `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> list; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called after an operation is handled in the gateway. The output is a list of bytes, `}),(0,n.jsx)(e.span,{className:"code-line",children:` // which will be available in the on-http-response hook. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-operation-response: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` request: executed-operation, `}),(0,n.jsx)(e.span,{className:"code-line",children:` ) -> list; `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The hook is called right before a response is sent to the user. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-http-response: func( `}),(0,n.jsx)(e.span,{className:"code-line",children:` context: shared-context, `}),(0,n.jsx)(e.span,{className:"code-line",children:` request: executed-http-request, `}),(0,n.jsx)(e.span,{className:"code-line",children:` ); `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["In all hooks, the ",(0,n.jsx)(e.code,{children:"shared-context"})," resource gives access to context data stored in the ",(0,n.jsx)(e.code,{children:"on-gateway-request"})," hook, the log file using the ",(0,n.jsx)(e.code,{children:"log-access"})," method, and the current trace ID with the ",(0,n.jsx)(e.code,{children:"trace-id"})," method on systems that enable OpenTelemetry metrics."]}),` `,(0,n.jsxs)(e.p,{children:["The first two hooks can return a set of bytes. The return values of ",(0,n.jsx)(e.code,{children:"on-subgraph-response"})," hooks appear in the ",(0,n.jsx)(e.code,{children:"executed-operation"})," record of the ",(0,n.jsx)(e.code,{children:"on-operation-response"})," hook, and the outputs of ",(0,n.jsx)(e.code,{children:"on-operation-response"})," hooks are in the ",(0,n.jsx)(e.code,{children:"executed-http-request"})," record of the ",(0,n.jsx)(e.code,{children:"on-http-response"})," hook."]}),` `,(0,n.jsx)(e.h4,{children:"Executed subgraph request"}),` `,(0,n.jsx)(e.p,{children:"This record holds information about an executed subgraph call:"}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`record executed-subgraph-request { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The name of the subgraph. `}),(0,n.jsx)(e.span,{className:"code-line",children:` subgraph-name: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The request method. `}),(0,n.jsx)(e.span,{className:"code-line",children:` method: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The subgraph URL. `}),(0,n.jsx)(e.span,{className:"code-line",children:` url: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The subgraph executions `}),(0,n.jsx)(e.span,{className:"code-line",children:` executions: list, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The cache status of the subgraph call. `}),(0,n.jsx)(e.span,{className:"code-line",children:` cache-status: cache-status, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The time in milliseconds taken for the whole operation. `}),(0,n.jsx)(e.span,{className:"code-line",children:` total-duration-ms: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // True, if the subgraph returned any errors. `}),(0,n.jsx)(e.span,{className:"code-line",children:` has-errors: bool, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["If retries are enabled, ",(0,n.jsx)(e.code,{children:"executions"})," may contain multiple responses. If data is fetched from the cache, ",(0,n.jsx)(e.code,{children:"executions"})," will be empty."]}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"subgraph-request-execution-kind"})," variant holds information about the subgraph request:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`variant subgraph-request-execution-kind { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Internal server error in the gateway. `}),(0,n.jsx)(e.span,{className:"code-line",children:` internal-server-error, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Response prevented by subgraph request hook. `}),(0,n.jsx)(e.span,{className:"code-line",children:` hook-error, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // HTTP request failed. `}),(0,n.jsx)(e.span,{className:"code-line",children:` request-error, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Request was rate-limited. `}),(0,n.jsx)(e.span,{className:"code-line",children:` rate-limited, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // A response was received. `}),(0,n.jsx)(e.span,{className:"code-line",children:` response(subgraph-response), `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["If a request executed successfully, ",(0,n.jsx)(e.code,{children:"subgraph-response"})," provides metrics on the request:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`record subgraph-response { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The milliseconds it took to connect to the host. `}),(0,n.jsx)(e.span,{className:"code-line",children:` connection-time-ms: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The milliseconds it took for the host to respond with data. `}),(0,n.jsx)(e.span,{className:"code-line",children:` response-time-ms: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The response status code `}),(0,n.jsx)(e.span,{className:"code-line",children:` status-code: u16 `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["The status code will be ",(0,n.jsx)(e.code,{children:"0"})," for requests that fail before fetching any data."]}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"cache-status"})," variant indicates caching information:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`enum cache-status { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Cache hit `}),(0,n.jsx)(e.span,{className:"code-line",children:` hit, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Some data fetched from cache. `}),(0,n.jsx)(e.span,{className:"code-line",children:` partial-hit, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Cache miss `}),(0,n.jsx)(e.span,{className:"code-line",children:` miss, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsx)(e.h4,{children:"Executed operation"}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"executed-operation"})," record holds metrics and previous responses from subgraphs:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`record executed-operation { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The name of the operation, if present. `}),(0,n.jsx)(e.span,{className:"code-line",children:` name: option, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The operation document in sanitized form. `}),(0,n.jsx)(e.span,{className:"code-line",children:` document: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The time taken in preparing. `}),(0,n.jsx)(e.span,{className:"code-line",children:` prepare-duration-ms: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // True, if the plan was taken from cache. `}),(0,n.jsx)(e.span,{className:"code-line",children:` cached-plan: bool, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Time in milliseconds spent executing the operation. `}),(0,n.jsx)(e.span,{className:"code-line",children:` duration: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The status of the operation. `}),(0,n.jsx)(e.span,{className:"code-line",children:` status: graphql-response-status, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // If queried any subgraphs, the outputs of on-subgraph-response hooks. `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Will be empty if no subgraphs were called. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-subgraph-response-outputs: list>, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"on-subgraph-response-outputs"})," aggregates the return values from all invoked ",(0,n.jsx)(e.code,{children:"on-subgraph-response"})," hooks."]}),` `,(0,n.jsx)(e.p,{children:"The GraphQL request status record contains data on success or failure:"}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`variant graphql-response-status { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // Request was successful. `}),(0,n.jsx)(e.span,{className:"code-line",children:` success, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // A field returned an error. `}),(0,n.jsx)(e.span,{className:"code-line",children:` field-error(field-error), `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // A request error. `}),(0,n.jsx)(e.span,{className:"code-line",children:` request-error(request-error), `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The request was refused. `}),(0,n.jsx)(e.span,{className:"code-line",children:` refused-request, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:`record field-error { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The number of errors. `}),(0,n.jsx)(e.span,{className:"code-line",children:` count: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The returned data is null. `}),(0,n.jsx)(e.span,{className:"code-line",children:` data-is-null: bool, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:`record request-error { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The number of errors. `}),(0,n.jsx)(e.span,{className:"code-line",children:` count: u64, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsx)(e.h4,{children:"Executed HTTP request"}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"on-http-response"})," input parameter ",(0,n.jsx)(e.code,{children:"executed-http-request"})," contains details about the HTTP response:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`record executed-http-request { `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The request method. `}),(0,n.jsx)(e.span,{className:"code-line",children:` method: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The request URL. `}),(0,n.jsx)(e.span,{className:"code-line",children:` url: string, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The response status code. `}),(0,n.jsx)(e.span,{className:"code-line",children:` status-code: u16, `}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsx)(e.span,{className:"code-line",children:` // The outputs of executed on-operation-response hooks for every operation of the request. `}),(0,n.jsx)(e.span,{className:"code-line",children:` on-operation-response-outputs: list>, `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"on-operation-response-outputs"})," aggregates outputs from all invoked ",(0,n.jsx)(e.code,{children:"on-operation-response"})," hooks."]}),` `,(0,n.jsx)(e.h3,{children:"Log channel monitoring"}),` `,(0,n.jsxs)(e.p,{children:["The metrics counter ",(0,n.jsx)(e.code,{children:"grafbase.gateway.access_log.pending"})," increments with each ",(0,n.jsx)(e.code,{children:"log-access"})," call and decrements once the bytes are written to the ",(0,n.jsx)(e.code,{children:"access.log"}),". Monitoring this value is crucial. Each ",(0,n.jsx)(e.code,{children:"log-access"})," call consumes memory until data gets written, and the channel can hold a maximum of 128,000 messages. For the ",(0,n.jsx)(e.code,{children:"blocking"})," access log method, a full channel will block all ",(0,n.jsx)(e.code,{children:"log-access"})," calls, while the ",(0,n.jsx)(e.code,{children:"non-blocking"})," method returns errors, sending data back to the caller."]}),` `,(0,n.jsx)(e.h2,{children:"Implementing the hooks in Rust"}),` `,(0,n.jsx)(e.p,{children:"Rust implementation is so far the easiest due to Rust having the best tools to compile WASI components. This chapter goes through how a guest component implementation works."}),` `,(0,n.jsxs)(e.p,{children:["You can compile a Wasm component with a ",(0,n.jsx)(e.a,{href:"https://www.rust-lang.org/tools/install",children:"recent Rust compiler"})," together with the ",(0,n.jsx)(e.a,{href:"https://github.com/bytecodealliance/cargo-component",children:"Cargo component subcommand"}),". The ",(0,n.jsx)(e.code,{children:"cargo component"})," subcommand provides all the needed tooling for creating and compiling a WASI component. The minimum required version of cargo-component is 0.14.0."]}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsx)(e.code,{className:"language-bash code-highlight",children:(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token function",children:"cargo"})," component new ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"--lib"}),` my-hooks `]})})}),` `,(0,n.jsxs)(e.p,{children:["This will create a project structure for a WASI component library called ",(0,n.jsx)(e.code,{children:"my-hooks"})," with the following project structure:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`my-hooks/ `}),(0,n.jsx)(e.span,{className:"code-line",children:`\u251C\u2500\u2500 Cargo.toml `}),(0,n.jsx)(e.span,{className:"code-line",children:`\u251C\u2500\u2500 src `}),(0,n.jsx)(e.span,{className:"code-line",children:`\u2502\xA0\xA0 \u2514\u2500\u2500 lib.rs `}),(0,n.jsx)(e.span,{className:"code-line",children:`\u2514\u2500\u2500 wit `}),(0,n.jsx)(e.span,{className:"code-line",children:` \u2514\u2500\u2500 world.wit `})]})}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"Cargo.toml"})," file provides the dependencies and build instructions to compile the project:"]}),` `,(0,n.jsx)(e.pre,{className:"language-toml",children:(0,n.jsxs)(e.code,{className:"language-toml code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"package"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"name"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"my-hooks"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"version"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"0.1.0"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"edition"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"2021"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"license"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"MIT"'}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"dependencies"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"wit-bindgen-rt"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"})," ",(0,n.jsx)(e.span,{className:"token key property",children:"version"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"0.26.0"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token key property",children:"features"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token string",children:'"bitflags"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"lib"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"crate-type"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token string",children:'"cdylib"'}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"profile.release"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"codegen-units"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token number",children:"1"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"opt-level"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"s"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"debug"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"false"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"strip"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"true"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"lto"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token boolean",children:"true"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"package.metadata.component"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token key property",children:"package"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"="})," ",(0,n.jsx)(e.span,{className:"token string",children:'"component:my-hooks"'}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token table class-name",children:"package.metadata.component.dependencies"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["First, add the WIT definition from this documentation to the ",(0,n.jsx)(e.code,{children:"wit/world.wit"})," file."]}),` `,(0,n.jsx)(e.p,{children:"By building the component, the framework will generate the needed bindings:"}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsx)(e.code,{className:"language-bash code-highlight",children:(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token function",children:"cargo"}),` component build `]})})}),` `,(0,n.jsx)(e.p,{children:"This will return a bunch of errors, which you will fix in the next chapters."}),` `,(0,n.jsx)(e.h3,{children:"Implementing the gateway request hook"}),` `,(0,n.jsxs)(e.p,{children:["First make sure the to export the ",(0,n.jsx)(e.code,{children:"gateway-request"})," interface in the ",(0,n.jsx)(e.code,{children:"wit/world.wit"})," file, in the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export gateway-request; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["Compile the component to generate bindings. You must edit ",(0,n.jsx)(e.code,{children:"src/lib.rs"})," to implement the interface:"]}),` `,(0,n.jsx)(e.pre,{className:"language-rust",children:(0,n.jsxs)(e.code,{className:"language-rust code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token attribute attr-name",children:"#[allow(warnings)]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"mod"})," ",(0,n.jsx)(e.span,{className:"token module-declaration namespace",children:"bindings"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Import the types generated from the WIT file."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"use"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"types",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token class-name",children:"Context"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Headers"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["exports",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),"gateway_request",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// An empty struct which can implement an interface."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"struct"})," ",(0,n.jsx)(e.span,{className:"token type-definition class-name",children:"Component"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Implementing the gateway-request interface for the component"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"impl"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["gateway_request",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token class-name",children:"Guest"})," ",(0,n.jsx)(e.span,{className:"token keyword",children:"for"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"on_gateway_request"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Context"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," headers",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Headers"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Result"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"Ok"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Export the component to WASI with the given bindings."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token macro property",children:"export!"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," with_types_in bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"The implementation is the simplest possible, returning an empty response and allowing the request to continue."}),` `,(0,n.jsx)(e.h3,{children:"Implementing the on subgraph request hook"}),` `,(0,n.jsxs)(e.p,{children:["First make sure the to export the ",(0,n.jsx)(e.code,{children:"subgraph-request"})," interface in the ",(0,n.jsx)(e.code,{children:"wit/world.wit"})," file, in the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export subgraph-request; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["Compile the component to generate bindings. You must edit ",(0,n.jsx)(e.code,{children:"src/lib.rs"})," to implement the interface:"]}),` `,(0,n.jsx)(e.pre,{className:"language-rust",children:(0,n.jsxs)(e.code,{className:"language-rust code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token attribute attr-name",children:"#[allow(warnings)]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"mod"})," ",(0,n.jsx)(e.span,{className:"token module-declaration namespace",children:"bindings"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Import the types generated from the WIT file."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"use"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"types",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token class-name",children:"Context"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Headers"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["exports",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),"subgraph_request",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// An empty struct which can implement an interface."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"struct"})," ",(0,n.jsx)(e.span,{className:"token type-definition class-name",children:"Component"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Implementing the gateway-request interface for the component"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"impl"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["subgraph_request",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token class-name",children:"Guest"})," ",(0,n.jsx)(e.span,{className:"token keyword",children:"for"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"on_subgraph_request"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Context"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," subgraph_name",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," method",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," url",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," headers",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Headers"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Result"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"Ok"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token comment",children:"// Export the component to WASI with the given bindings."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token macro property",children:"export!"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," with_types_in bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"The implementation is the simplest possible, returning an empty response and allowing the request to continue."}),` `,(0,n.jsx)(e.h3,{children:"Implementing the authorization hooks"}),` `,(0,n.jsxs)(e.p,{children:["First make sure the to export the ",(0,n.jsx)(e.code,{children:"authorization"})," interface in the ",(0,n.jsx)(e.code,{children:"wit/world.wit"})," file, in the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export authorization; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["Compile the component to generate bindings. You must edit ",(0,n.jsx)(e.code,{children:"src/lib.rs"})," to implement the interface:"]}),` `,(0,n.jsx)(e.pre,{className:"language-rust",children:(0,n.jsxs)(e.code,{className:"language-rust code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token attribute attr-name",children:"#[allow(warnings)]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"mod"})," ",(0,n.jsx)(e.span,{className:"token module-declaration namespace",children:"bindings"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"use"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"types",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"Context"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"EdgeDefinition"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Headers"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"NodeDefinition"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsxs)(e.span,{className:"token namespace",children:["exports",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),"authorization",(0,n.jsx)(e.span,{className:"token punctuation",children:","})," gateway_request",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"struct"})," ",(0,n.jsx)(e.span,{className:"token type-definition class-name",children:"Component"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"impl"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["authorization",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token class-name",children:"Guest"})," ",(0,n.jsx)(e.span,{className:"token keyword",children:"for"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"authorize_edge_pre_execution"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" definition",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"EdgeDefinition"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" arguments",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" metadata",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Result"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"Ok"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"authorize_node_pre_execution"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" definition",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"NodeDefinition"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" metadata",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"String"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Result"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Error"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"Ok"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token macro property",children:"export!"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," with_types_in bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["The implementation is the simplest possible. Both hooks return an empty ",(0,n.jsx)(e.code,{children:"Ok"})," value to the engine, and the engine will return the requested data in all cases."]}),` `,(0,n.jsx)(e.h3,{children:"Implementing response hooks"}),` `,(0,n.jsxs)(e.p,{children:["First, export the ",(0,n.jsx)(e.code,{children:"responses"})," interface in the ",(0,n.jsx)(e.code,{children:"wit/world.wit"})," file, within the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export responses; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["Compile the component to generate bindings. Then, modify ",(0,n.jsx)(e.code,{children:"src/lib.rs"})," to implement the interface:"]}),` `,(0,n.jsx)(e.pre,{className:"language-rust",children:(0,n.jsxs)(e.code,{className:"language-rust code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"use"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"types",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"CacheStatus"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedHttpRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedOperation"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedSubgraphRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Operation"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ResponseKind"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"use"})," ",(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"exports",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"component",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"grafbase",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),"responses",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token class-name",children:"Guest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token attribute attr-name",children:"#[allow(warnings)]"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"mod"})," ",(0,n.jsx)(e.span,{className:"token module-declaration namespace",children:"bindings"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"struct"})," ",(0,n.jsx)(e.span,{className:"token type-definition class-name",children:"Component"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"impl"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Guest"})," ",(0,n.jsx)(e.span,{className:"token keyword",children:"for"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"on_subgraph_response"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," request",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedSubgraphRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Vec"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token keyword",children:"u8"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token comment",children:"// Combine a set of bytes from context and subgraph request."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"on_operation_response"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" operation",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Operation"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" request",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedOperation"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"->"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Vec"}),(0,n.jsx)(e.span,{className:"token operator",children:"<"}),(0,n.jsx)(e.span,{className:"token keyword",children:"u8"}),(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token comment",children:"// Combine a set of bytes from context and operation data."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"fn"})," ",(0,n.jsx)(e.span,{className:"token function-definition function",children:"on_http_response"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"context",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"SharedContext"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," request",(0,n.jsx)(e.span,{className:"token punctuation",children:":"})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"ExecutedHttpRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"let"})," data ",(0,n.jsx)(e.span,{className:"token operator",children:"="})," ",(0,n.jsx)(e.span,{className:"token class-name",children:"Vec"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"::"}),(0,n.jsx)(e.span,{className:"token function",children:"new"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token comment",children:"// Combine a set of bytes from context and HTTP request data."}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token comment",children:"// Calling the log_access will write the bytes to the access.log."}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context",(0,n.jsx)(e.span,{className:"token punctuation",children:"."}),(0,n.jsx)(e.span,{className:"token function",children:"log_access"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token operator",children:"&"}),"data",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"."}),(0,n.jsx)(e.span,{className:"token function",children:"unwrap"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsxs)(e.span,{className:"token namespace",children:["bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:"::"})]}),(0,n.jsx)(e.span,{className:"token macro property",children:"export!"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token class-name",children:"Component"})," with_types_in bindings",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),(0,n.jsx)(e.span,{className:"token punctuation",children:";"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["The serialization of data can vary as long as it returns bytes. As an example, if your access.log contains JSON data, define structured data as ",(0,n.jsx)(e.a,{href:"https://serde.rs/",children:"Serde"})," structures in the hooks and serialize them into bytes using ",(0,n.jsx)(e.a,{href:"https://crates.io/crates/serde_json",children:"serde_json"}),"."]}),` `,(0,n.jsxs)(e.p,{children:["The ",(0,n.jsx)(e.code,{children:"log_access"})," method is available in all hooks via shared context. This implementation captures one row of data per request, which the method writes to the log in the ",(0,n.jsx)(e.code,{children:"on-http-response"})," hook."]}),` `,(0,n.jsxs)(e.p,{children:["See a ",(0,n.jsx)(e.a,{href:"https://github.com/grafbase/grafbase/tree/main/examples/access-logs",children:"full example project"})," implementing access logs with Grafbase Gateway."]}),` `,(0,n.jsx)(e.h3,{children:"Deploying the hooks with the Gateway"}),` `,(0,n.jsxs)(e.p,{children:["When done implementing the hooks, we must compile them in ",(0,n.jsx)(e.em,{children:"release"})," mode. The component can define multiple hooks, and they're all deployment as a single WASI component."]}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsx)(e.code,{className:"language-bash code-highlight",children:(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token function",children:"cargo"})," component build ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"--release"}),` `]})})}),` `,(0,n.jsxs)(e.p,{children:["The component is available in ",(0,n.jsx)(e.code,{children:"target/wasm32-wasip1/release/my_hook.wasm"}),". You must deploy this file with the gateway binary, and you must configure the gateway binary to look for the file in its configuration."]}),` `,(0,n.jsx)(e.h2,{children:"Implementing the hooks in Go"}),` `,(0,n.jsx)(e.p,{children:"The Go implementation requires more steps and tooling. The tooling isn't yet as robust as the Rust counterparts. You need the following tools for development:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:"https://github.com/bytecodealliance/wit-bindgen/releases",children:"wit-bindgen"})," version 0.26.0 or later"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:"https://github.com/bytecodealliance/wasm-tools/releases",children:"wasm-tools"})," version 1.211.1 or later"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:"https://github.com/tinygo-org/tinygo/releases",children:"TinyGo"})," version 0.32.0 or later"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:"https://go.dev/dl/",children:"Go"})," version 1.21 or later"]}),` `,(0,n.jsx)(e.li,{children:"clang compiler and the needed system libraries"}),` `]}),` `,(0,n.jsx)(e.p,{children:"Create a new Go project"}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsxs)(e.code,{className:"language-bash code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," ",(0,n.jsx)(e.span,{className:"token function",children:"mkdir"})," my-hook ",(0,n.jsx)(e.span,{className:"token operator",children:"&&"})," ",(0,n.jsx)(e.span,{className:"token builtin class-name",children:"cd"}),` my-hook `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"}),` go mod init hooks.com `]})]})}),` `,(0,n.jsxs)(e.p,{children:["Copy the WIT definition from this documentation to the project root, name it as ",(0,n.jsx)(e.code,{children:"grafbase.wit"})," and generate the needed bindings:"]}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsx)(e.code,{className:"language-bash code-highlight",children:(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," wit-bindgen tiny-go ./grafbase.wit ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"--world"})," hooks --out-dir",(0,n.jsx)(e.span,{className:"token operator",children:"="}),`gen `]})})}),` `,(0,n.jsxs)(e.p,{children:["Download the ",(0,n.jsx)(e.code,{children:"wasi_snapshot_preview1.reactor.wasm"})," file from the ",(0,n.jsx)(e.a,{href:"https://github.com/bytecodealliance/wasmtime/releases/tag/v22.0.0",children:"latest wasmtime release"})," and put it to the root of the project."]}),` `,(0,n.jsx)(e.p,{children:"You now have the project framework to implement the WASI component."}),` `,(0,n.jsx)(e.h3,{children:"Implementing the gateway request hook"}),` `,(0,n.jsxs)(e.p,{children:["First make sure to export the ",(0,n.jsx)(e.code,{children:"gateway-request"})," interface in the ",(0,n.jsx)(e.code,{children:"grafbase.wit"})," file, in the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export gateway-request; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["If needed, run the ",(0,n.jsx)(e.code,{children:"wit-bindgen"})," command as defined in the previous chapter. Create a new file ",(0,n.jsx)(e.code,{children:"hooks.go"})," with the implementation:"]}),` `,(0,n.jsx)(e.pre,{className:"language-go",children:(0,n.jsxs)(e.code,{className:"language-go code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"package"}),` main `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"import"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"."})," ",(0,n.jsx)(e.span,{className:"token string",children:'"hooks.com/gen"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," HooksImpl ",(0,n.jsx)(e.span,{className:"token keyword",children:"struct"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"i HooksImpl",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token function",children:"OnGatewayRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context ComponentGrafbaseTypesContext",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" headers ComponentGrafbaseTypesHeaders",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," Result",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"return"})," Ok",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token function",children:"init"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" hooks ",(0,n.jsx)(e.span,{className:"token operator",children:":="})," HooksImpl",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token function",children:"SetExportsComponentGrafbaseGatewayRequest"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"hooks",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token function",children:"main"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsx)(e.p,{children:"The hook is the minimum possible, doing nothing and letting a request to go through."}),` `,(0,n.jsx)(e.h3,{children:"Implementing the authorization hooks"}),` `,(0,n.jsxs)(e.p,{children:["First make sure to export the ",(0,n.jsx)(e.code,{children:"authorization"})," in the ",(0,n.jsx)(e.code,{children:"grafbase.wit"})," file, in the ",(0,n.jsx)(e.code,{children:"hooks"})," world:"]}),` `,(0,n.jsx)(e.pre,{children:(0,n.jsxs)(e.code,{className:"language-wit code-highlight",children:[(0,n.jsx)(e.span,{className:"code-line",children:`world hooks { `}),(0,n.jsx)(e.span,{className:"code-line",children:` export authorization; `}),(0,n.jsx)(e.span,{className:"code-line",children:`} `})]})}),` `,(0,n.jsxs)(e.p,{children:["If needed, run the ",(0,n.jsx)(e.code,{children:"wit-bindgen"})," command as defined in the previous chapter. Create a new file ",(0,n.jsx)(e.code,{children:"hooks.go"})," with the implementation:"]}),` `,(0,n.jsx)(e.pre,{className:"language-go",children:(0,n.jsxs)(e.code,{className:"language-go code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"package"}),` main `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"import"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token punctuation",children:"."})," ",(0,n.jsx)(e.span,{className:"token string",children:'"gateway.com/gen"'}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"type"})," AuthorizationImpl ",(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"i AuthorizationImpl",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token function",children:"AuthorizeEdgePreExecution"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context ComponentGrafbaseTypesSharedContext",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" definition ComponentGrafbaseTypesEdgeDefinition",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" arguments ",(0,n.jsx)(e.span,{className:"token builtin",children:"string"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" metadata ",(0,n.jsx)(e.span,{className:"token builtin",children:"string"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," Result",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"return"})," Ok",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"i AuthorizationImpl",(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token function",children:"AuthorizeNodePreExecution"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" context ComponentGrafbaseTypesSharedContext",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" definition ComponentGrafbaseTypesNodeDefinition",(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" metadata ",(0,n.jsx)(e.span,{className:"token builtin",children:"string"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," Result",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token keyword",children:"return"})," Ok",(0,n.jsx)(e.span,{className:"token punctuation",children:"["}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:","})," ComponentGrafbaseTypesError",(0,n.jsx)(e.span,{className:"token punctuation",children:"]"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token keyword",children:"struct"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token function",children:"init"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" hooks ",(0,n.jsx)(e.span,{className:"token operator",children:":="})," AuthorizationImpl",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[" ",(0,n.jsx)(e.span,{className:"token function",children:"SetExportsComponentGrafbaseAuthorization"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),"hooks",(0,n.jsx)(e.span,{className:"token punctuation",children:")"}),` `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]}),(0,n.jsx)(e.span,{className:"code-line",children:` `}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token keyword",children:"func"})," ",(0,n.jsx)(e.span,{className:"token function",children:"main"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"("}),(0,n.jsx)(e.span,{className:"token punctuation",children:")"})," ",(0,n.jsx)(e.span,{className:"token punctuation",children:"{"}),(0,n.jsx)(e.span,{className:"token punctuation",children:"}"}),` `]})]})}),` `,(0,n.jsxs)(e.p,{children:["The implementation is the simplest possible. Both hooks return an empty ",(0,n.jsx)(e.code,{children:"Ok"})," value to the engine, and the engine will return the requested data in all cases."]}),` `,(0,n.jsx)(e.h3,{children:"Deploying the hooks with the Gateway"}),` `,(0,n.jsx)(e.p,{children:"Next we build the module using TinyGo, componentize it, and adapt it for WASI 0.2:"}),` `,(0,n.jsx)(e.pre,{className:"language-bash",children:(0,n.jsxs)(e.code,{className:"language-bash code-highlight",children:[(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," tinygo build ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"-o"})," hooks.wasm ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"-target"}),(0,n.jsx)(e.span,{className:"token operator",children:"="}),`wasi hooks.go `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," wasm-tools component embed ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"--world"})," hooks ./grafbase.wit hooks.wasm ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"-o"}),` hooks.embed.wasm `]}),(0,n.jsxs)(e.span,{className:"code-line",children:[(0,n.jsx)(e.span,{className:"token operator",children:">"})," wasm-tools component new ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"-o"})," hooks.component.wasm ",(0,n.jsx)(e.span,{className:"token parameter variable",children:"--adapt"})," ",(0,n.jsx)(e.span,{className:"token assign-left variable",children:"wasi_snapshot_preview1"}),(0,n.jsx)(e.span,{className:"token operator",children:"="}),(0,n.jsx)(e.span,{className:"token string",children:'"wasi_snapshot_preview1.reactor.wasm"'}),` hooks.embed.wasm `]})]})}),` `,(0,n.jsxs)(e.p,{children:["The component is available in ",(0,n.jsx)(e.code,{children:"hooks.component.wasm"}),". You must deploy the file with the gateway binary, and you must configure the gateway binary to look for the file in its configuration."]}),` `,(0,n.jsx)(e.h2,{children:"Triggering HTTP requests from the hooks"}),` `,(0,n.jsxs)(e.p,{children:["So far the support for networking and HTTP from WASI components is work in progress. WASI support in common libraries might not be available. If needing to trigger HTTP requests from the hooks, please consider writing them in Rust and using a crate which works in the WASI context, such as ",(0,n.jsx)(e.a,{href:"https://crates.io/crates/waki",children:"waki"}),"."]}),` `,(0,n.jsxs)(e.p,{children:["WASI support in more popular HTTP libraries such as ",(0,n.jsx)(e.a,{href:"https://crates.io/crates/reqwest",children:"reqwest"})," or Go's ",(0,n.jsx)(e.a,{href:"https://pkg.go.dev/net/http",children:"net/http"})," is still work in progress. This documentation will get updated when the situation changes."]})]})}function h(a={}){let{wrapper:e}=a.components||{};return e?(0,n.jsx)(e,{...a,children:(0,n.jsx)(d,{...a})}):d(a)}return y(v);})(); ;return Component;

Project Usage