Proposal for v2 of typeid (#502)

## Summary
Implements a proposed version 2 of TypeID:
+ Removes all the generic stuff and simplifies the API considerably. 
+ Improves the base32 encoder to allow for zero allocations and buffer
reuse.
+ Improved error handling via CorruptInputError and ErrValidation.
+ Adds extensive benchmarks. Rewrote existing ones as well. All
benchmarks now use the newer loop notation and use sinks (to prevent
compiler optimizations from invalidating the benchmarks)
+ Rethinks the SQL integration to have a nullable version and a
non-nullable version.
+ Changes the internal encoding of the TypeID struct to be more
efficient by using a single string and an integer. Note that I tested a
byte slice version as well, and it didn't perform as well as this one in
the benchmarks.
+ Improved unit tests so that every single constructor is tested against
the spec.
+ Rewrote constructors to minimize allocations as much as possible (some
constructors are zero allocations, others are 1 or 2 at most)
+ Changed meaning of IsZero() (so that it makes sense to use with
`omitzero`). Introduced HasSuffix() that addresses the same use case as
the previous version of IsZero().

Rollout proposal:
+ Merge this PR
+ Update axiom to use it, see if we like it better. Maybe we tweak it a
bit more.
+ Once happy with it, we release a new version under `v2`

## How was it tested?
Ran all the tests

## Community Contribution License

All community contributions in this pull request are licensed to the
project maintainers under the terms of the [Apache 2
License](https://www.apache.org/licenses/LICENSE-2.0).

By creating this pull request I represent that I have the right to
license the contributions to the project maintainers under the Apache 2
License as stated in the [Community Contribution
License](https://github.com/jetify-com/opensource/blob/main/CONTRIBUTING.md#community-contribution-license).

Author: loreto

go.mod

@@ -22,7 +22,6 @@ require (
 	github.com/samber/lo v1.49.1
 	github.com/spf13/cobra v1.9.1
 	go.jetify.com/pkg v0.0.0-20250529161140-389e29497c0d
-	go.jetify.com/typeid v1.3.1-0.20250402201646-5c084b871320
 	golang.org/x/text v0.23.0
 )
 
@@ -63,6 +62,7 @@ require (
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 	github.com/spf13/pflag v1.0.6 // indirect
 	github.com/tailscale/hujson v0.0.0-20250226034555-ec1d1c113d33 // indirect
+	go.jetify.com/typeid v1.3.1-0.20250402201646-5c084b871320 // indirect
 	golang.org/x/crypto v0.36.0 // indirect
 	golang.org/x/oauth2 v0.28.0 // indirect
 	golang.org/x/sys v0.31.0 // indirect

internal/flow/init.go

@@ -16,8 +16,7 @@ import (
 	membersv1alpha1 "go.jetify.com/pkg/api/gen/priv/members/v1alpha1"
 	projectsv1alpha1 "go.jetify.com/pkg/api/gen/priv/projects/v1alpha1"
 	"go.jetify.com/pkg/auth/session"
-	"go.jetify.com/pkg/id"
-	"go.jetify.com/typeid"
+	"go.jetify.com/pkg/ids"
 )
 
 // flow:
@@ -33,35 +32,35 @@ type Init struct {
 	WorkingDir            string
 }
 
-func (i *Init) Run(ctx context.Context) (id.ProjectID, error) {
+func (i *Init) Run(ctx context.Context) (ids.ProjectID, error) {
 	createProject, err := i.confirmSetupProjectPrompt()
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 	if !createProject {
-		return id.ProjectID{}, errors.New("aborted")
+		return ids.ProjectID{}, errors.New("aborted")
 	}
 
 	member, err := i.Client.GetMember(ctx, i.Token.IDClaims().Subject)
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
 	// TODO: printOrgNotice will be a team picker once that is implemented.
 	i.printOrgNotice(member)
-	orgID, err := typeid.Parse[id.OrgID](i.Token.IDClaims().OrgID)
+	orgID, err := ids.ParseOrgID(i.Token.IDClaims().OrgID)
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
 	projects, err := i.Client.ListProjects(ctx, orgID)
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 	if len(projects) > 0 {
 		linkToExisting, err := i.linkToExistingPrompt()
 		if err != nil {
-			return id.ProjectID{}, err
+			return ids.ProjectID{}, err
 		}
 		if linkToExisting {
 			return i.showExistingListPrompt(projects)
@@ -97,7 +96,7 @@ func (i *Init) linkToExistingPrompt() (bool, error) {
 
 func (i *Init) showExistingListPrompt(
 	projects []*projectsv1alpha1.Project,
-) (id.ProjectID, error) {
+) (ids.ProjectID, error) {
 	// Ignore errors, it's fine if not in repo or git not installed.
 	repo, _ := git.GitRepoURL(i.WorkingDir)
 	directory, _ := git.GitSubdirectory(i.WorkingDir)
@@ -117,12 +116,12 @@ func (i *Init) showExistingListPrompt(
 
 	idx := 0
 	if err := survey.AskOne(prompt, &idx); err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
-	projectID, err := typeid.Parse[id.ProjectID](projects[idx].GetId())
+	projectID, err := ids.ParseProjectID(projects[idx].GetId())
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 	name := projects[idx].GetName()
 	if name == "" {
@@ -135,20 +134,20 @@ func (i *Init) showExistingListPrompt(
 func (i *Init) createNewPrompt(
 	ctx context.Context,
 	member *membersv1alpha1.Member,
-) (id.ProjectID, error) {
+) (ids.ProjectID, error) {
 	prompt := &survey.Input{
 		Message: "What’s the name of your new project?",
 		Default: filepath.Base(i.WorkingDir),
 	}
 
 	name := ""
 	if err := survey.AskOne(prompt, &name); err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
-	orgID, err := typeid.Parse[id.OrgID](i.Token.IDClaims().OrgID)
+	orgID, err := ids.ParseOrgID(i.Token.IDClaims().OrgID)
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
 	// Ignore errors, it's fine if not in repo or git not installed.
@@ -163,12 +162,12 @@ func (i *Init) createNewPrompt(
 		strings.TrimSpace(name),
 	)
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
-	projectID, err := typeid.Parse[id.ProjectID](project.GetId())
+	projectID, err := ids.ParseProjectID(project.GetId())
 	if err != nil {
-		return id.ProjectID{}, err
+		return ids.ProjectID{}, err
 	}
 
 	fmt.Fprintf(

pkg/envcli/flags.go

@@ -14,8 +14,7 @@ import (
 	"go.jetify.com/envsec/pkg/stores/jetstore"
 	"go.jetify.com/envsec/pkg/stores/ssmstore"
 	"go.jetify.com/pkg/envvar"
-	"go.jetify.com/pkg/id"
-	"go.jetify.com/typeid"
+	"go.jetify.com/pkg/ids"
 )
 
 // to be composed into xyzCmdFlags structs
@@ -48,7 +47,7 @@ func (f *configFlags) register(cmd *cobra.Command) {
 	)
 }
 
-func (f *configFlags) validateProjectID(orgID id.OrgID) (string, error) {
+func (f *configFlags) validateProjectID(orgID ids.OrgID) (string, error) {
 	if f.projectID != "" {
 		return f.projectID, nil
 	}
@@ -111,7 +110,7 @@ func (f *configFlags) genConfig(cmd *cobra.Command) (*CmdConfig, error) {
 		f.orgID = tok.IDClaims().OrgID
 	}
 
-	orgID, err := typeid.Parse[id.OrgID](f.orgID)
+	orgID, err := ids.ParseOrgID(f.orgID)
 	if err != nil {
 		return nil, errors.WithStack(err)
 	}

pkg/envsec/init.go

@@ -10,8 +10,7 @@ import (
 	"go.jetify.com/envsec/internal/flow"
 	"go.jetify.com/envsec/internal/git"
 	"go.jetify.com/pkg/api"
-	"go.jetify.com/pkg/id"
-	"go.jetify.com/typeid"
+	"go.jetify.com/pkg/ids"
 )
 
 var (
@@ -26,8 +25,8 @@ const (
 )
 
 type projectConfig struct {
-	ProjectID id.ProjectID `json:"project_id"`
-	OrgID     id.OrgID     `json:"org_id"`
+	ProjectID ids.ProjectID `json:"project_id"`
+	OrgID     ids.OrgID     `json:"org_id"`
 }
 
 func (e *Envsec) NewProject(ctx context.Context, force bool) error {
@@ -62,7 +61,7 @@ func (e *Envsec) NewProject(ctx context.Context, force bool) error {
 		return err
 	}
 
-	orgID, err := typeid.Parse[id.OrgID](tok.IDClaims().OrgID)
+	orgID, err := ids.ParseOrgID(tok.IDClaims().OrgID)
 	if err != nil {
 		return err
 	}
@@ -94,7 +93,7 @@ func (e *Envsec) configName() string {
 	return configName
 }
 
-func (e *Envsec) saveConfig(projectID id.ProjectID, orgID id.OrgID) error {
+func (e *Envsec) saveConfig(projectID ids.ProjectID, orgID ids.OrgID) error {
 	cfg := projectConfig{ProjectID: projectID, OrgID: orgID}
 	data, err := json.MarshalIndent(cfg, "", "  ")
 	if err != nil {