// Code generated by smithy-go-codegen DO NOT EDIT.

// Package document implements encoding and decoding of open-content that has a JSON-like data model.
// This data-model allows for UTF-8 strings, arbitrary precision numbers, booleans, nulls, a list of these values, and a
// map of UTF-8 strings to these values.
//
// Interface defines the semantics for how a document type is marshalled and unmarshalled for requests and responses
// for the service. To send a document as input to the service you use NewLazyDocument and pass it the Go type to be
// sent to the service. NewLazyDocument returns a document Interface type that encodes the provided Go type during
// the request serialization step after you have invoked an API client operation that uses the document type.
//
// The following examples show how you can create document types using basic Go types.
//
//   NewLazyDocument(map[string]interface{}{
//       "favoriteNumber": 42,
//       "fruits":         []string{"apple", "orange"},
//       "capitals":       map[string]interface{}{
//           "Washington": "Olympia",
//           "Oregon":     "Salem",
//       },
//       "skyIsBlue":      true,
//   })
//
//   NewLazyDocument(3.14159)
//
//   NewLazyDocument([]interface{"One", 2, 3, 3.5, "four"})
//
//   NewLazyDocument(true)
//
// Services can send document types as part of their API responses. To retrieve the content of a response document
// you use the UnmarshalSmithyDocument method on the response document. When calling UnmarshalSmithyDocument you pass
// a reference to the Go type that you want to unmarshal and map the response to.
//
// For example, if you expect to receive key/value map from the service response:
//
//   var kv map[string]interface{}
//   if err := outputDocument.UnmarshalSmithyDocument(&kv); err != nil {
//       // handle error
//   }
//
// If a service can return one or more data-types in the response, you can use an empty interface and type switch to
// dynamically handle the response type.
//
//   var v interface{}
//   if err := outputDocument.UnmarshalSmithyDocument(&v); err != nil {
//      // handle error
//   }
//
//   switch vv := v.(type) {
//   case map[string]interface{}:
//       // handle key/value map
//   case []interface{}:
//       // handle array of values
//   case bool:
//       // handle boolean
//   case document.Number:
//       // handle an arbitrary precision number
//   case string:
//      // handle string
//   default:
//      // handle unknown case
//   }
//
// The mapping of Go types to document types is covered in more depth in https://pkg.go.dev/github.com/aws/smithy-go/document
// including more in depth examples that cover user-defined structure types.
//
package document
