github.com/aws/smithy-go v1.28.1

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:golang/github.com/aws/smithy-go@v1.28.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/aws/smithy-go@v1.28.1

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:644bfd19590c3e6e5689774b2c54d7a281207baf0656b621c206f1c13f2432de","contract":["smithy.NewSchema constructs structure and scalar schemas with ShapeID formatted as namespace#name","Schema.AddMember registers a named member targeting another schema and preserves MemberName and TargetID","smithy.TypeRegistry and smithy.RegistryEntry register and instantiate structure types by ShapeID string","smithy.Properties zero-value instance stores and retrieves comparable key-value metadata via Set, Get, and Has","smithy.GenericAPIError implements smithy.APIError and exposes ErrorCode, ErrorMessage, and ErrorFault","smithy.InvalidParamsError aggregates smithy.NewErrParamRequired validation errors and reports count via Len"],"goal":"verify pkg:golang/github.com/aws/smithy-go@v1.28.1","kind":"HOW","packages":["pkg:golang/github.com/aws/smithy-go@v1.28.1"],"schemaVersion":1},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","language":"go","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","packageManagerVersion":"1.26.6","runtime":"go","runtimeVersion":"1.26.6","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/aws/smithy-go@v1.28.1"],"schemaVersion":1,"subject":"pkg:golang/github.com/aws/smithy-go@v1.28.1","verifierAdapter":"golang@1"}

module example.com/sample

go 1.24

require github.com/aws/smithy-go v1.28.1

github.com/aws/smithy-go v1.28.1 h1:R/nXH00c8qcfCzQVELtRw+eLQWtzv+VAIEFJ1/xxXlQ=
github.com/aws/smithy-go v1.28.1/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc=

{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/aws/smithy-go@v1.28.1",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/aws/smithy-go@v1.28.1"
  ]
}

package main

import (
	"errors"
	"fmt"
	"os"

	smithy "github.com/aws/smithy-go"
)

type SampleInput struct {
	Name string
}

func main() {
	// 1. Verify Schema construction and member lookup
	strSchema := smithy.NewSchema(
		smithy.ShapeID{Namespace: "example.service", Name: "String"},
		smithy.ShapeTypeString,
		0,
	)
	structSchema := smithy.NewSchema(
		smithy.ShapeID{Namespace: "example.service", Name: "SampleInput"},
		smithy.ShapeTypeStructure,
		1,
	)
	memberSchema := structSchema.AddMember("Name", strSchema)

	if got := structSchema.ID().String(); got != "example.service#SampleInput" {
		fmt.Fprintf(os.Stderr, "unexpected struct schema ID: %s\n", got)
		os.Exit(1)
	}
	if got := memberSchema.MemberName(); got != "Name" {
		fmt.Fprintf(os.Stderr, "unexpected member name: %s\n", got)
		os.Exit(1)
	}
	if structSchema.Member("Name") != memberSchema {
		fmt.Fprintln(os.Stderr, "expected Member(\"Name\") to return added member schema")
		os.Exit(1)
	}
	if memberSchema.TargetID().String() != "example.service#String" {
		fmt.Fprintf(os.Stderr, "unexpected target ID: %s\n", memberSchema.TargetID().String())
		os.Exit(1)
	}

	// 2. Verify TypeRegistry and RegistryEntry
	reg := &smithy.TypeRegistry{
		Entries: map[string]*smithy.TypeRegistryEntry{
			structSchema.ID().String(): smithy.RegistryEntry[SampleInput](structSchema),
		},
	}
	entry, ok := reg.LookupEntry("example.service#SampleInput")
	if !ok || entry.Schema != structSchema {
		fmt.Fprintln(os.Stderr, "failed to lookup registry entry")
		os.Exit(1)
	}
	if _, ok := entry.New().(*SampleInput); !ok {
		fmt.Fprintln(os.Stderr, "expected New() to return *SampleInput")
		os.Exit(1)
	}

	// 3. Verify Properties metadata store
	var props smithy.Properties
	props.Set("request-id", "req-001")
	if !props.Has("request-id") || props.Get("request-id") != "req-001" {
		fmt.Fprintln(os.Stderr, "unexpected properties behavior")
		os.Exit(1)
	}

	// 4. Verify APIError and InvalidParamsError
	var apiErr error = &smithy.GenericAPIError{
		Code:    "ValidationException",
		Message: "invalid input",
		Fault:   smithy.FaultClient,
	}
	var targetAPIErr smithy.APIError
	if !errors.As(apiErr, &targetAPIErr) || targetAPIErr.ErrorCode() != "ValidationException" || targetAPIErr.ErrorFault() != smithy.FaultClient {
		fmt.Fprintln(os.Stderr, "unexpected GenericAPIError behavior")
		os.Exit(1)
	}

	invalidParams := smithy.InvalidParamsError{Context: "SampleOperation"}
	invalidParams.Add(smithy.NewErrParamRequired("Name"))
	if invalidParams.Len() != 1 {
		fmt.Fprintf(os.Stderr, "expected 1 invalid param error, got %d\n", invalidParams.Len())
		os.Exit(1)
	}
}