@stackonward/cli 0.0.1 → 1.0.0

package/dist/resources/templates/go-backend/internal/common/serviceidentity/resource_identifier_test.go

@@ -0,0 +1,32 @@
+package serviceidentity
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestValidateResourceIdentifier(t *testing.T) {
+	for _, value := range []string{
+		"https://api.example.com",
+		"https://api.example.com/internal/v1",
+		"http://localhost:3002",
+		"http://127.0.0.1:3002",
+		"http://[::1]:3002",
+	} {
+		require.NoError(t, ValidateResourceIdentifier(value), value)
+	}
+
+	for _, value := range []string{
+		"",
+		" https://api.example.com",
+		"HTTPS://api.example.com",
+		"http://api.example.com",
+		"urn:onex:resource:platform-internal-api",
+		"https://user@api.example.com",
+		"https://api.example.com?tenant=one",
+		"https://api.example.com#fragment",
+	} {
+		require.Error(t, ValidateResourceIdentifier(value), value)
+	}
+}

package/dist/resources/templates/go-backend/internal/common/tradeno/generator.go

@@ -0,0 +1,99 @@
+package tradeno
+
+import (
+	"crypto/rand"
+	"fmt"
+	"strings"
+)
+
+// base62Chars 编码字符集（0-9 a-z A-Z）
+const base62Chars = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
+
+// lowerAlnumChars 编码字符集（0-9 a-z）
+const lowerAlnumChars = "0123456789abcdefghijklmnopqrstuvwxyz"
+
+// randomLen 随机部分长度
+const randomLen = 24
+
+var lowerAlnumPrefixes = map[Prefix]struct{}{
+	PrefixBillingAccount:                {},
+	PrefixInventoryStockItem:            {},
+	PrefixInventoryStockLevel:           {},
+	PrefixInventoryReservation:          {},
+	PrefixInventoryLedger:               {},
+	PrefixInventoryAdjustment:           {},
+	PrefixInventoryStocktake:            {},
+	PrefixInventoryTransfer:             {},
+	PrefixInventoryAlertHit:             {},
+	PrefixDeliveryCapacitySlot:          {},
+	PrefixDeliveryCapacityRule:          {},
+	PrefixDeliveryCapacityLedger:        {},
+	PrefixDeliveryReservation:           {},
+	PrefixDiscoveryPublicationChannel:   {},
+	PrefixDiscoveryPublicationSchedule:  {},
+	PrefixStorageAsset:                  {},
+	PrefixStorageUploadSession:          {},
+	PrefixStorageAssetReference:         {},
+	PrefixExportTask:                    {},
+	PrefixIAMAuthorizationDecision:      {},
+	PrefixOrganization:                  {},
+	PrefixOrganizationProductEnrollment: {},
+	PrefixOrganizationMembership:        {},
+	PrefixOrganizationInvitation:        {},
+	PrefixOrganizationTeam:              {},
+	PrefixOrganizationVerifiedDomain:    {},
+	PrefixOrganizationDomainChallenge:   {},
+	PrefixIdentitySSOConnection:         {},
+	PrefixIdentitySCIMUser:              {},
+	PrefixIdentitySCIMGroup:             {},
+	PrefixIAMPrincipal:                  {},
+	PrefixIAMRoleBinding:                {},
+	PrefixIAMPolicyBinding:              {},
+	PrefixProductClientApplication:      {},
+	PrefixClientApplicationIdentifier:   {},
+	PrefixAppVersionRelease:             {},
+	PrefixAppVersionDistributionChannel: {},
+	PrefixAppVersionReleaseAvailability: {},
+	PrefixAppVersionSupportPolicy:       {},
+	PrefixFeatureFlag:                   {},
+	PrefixFeatureFlagPublication:        {},
+}
+
+// Generate 生成业务编号
+func Generate(prefix Prefix) (string, error) {
+	alphabet := base62Chars
+	if _, ok := lowerAlnumPrefixes[prefix]; ok {
+		alphabet = lowerAlnumChars
+	}
+	randomPart, err := randomFromAlphabet(randomLen, alphabet)
+	if err != nil {
+		return "", fmt.Errorf("failed to generate trade number: %w", err)
+	}
+	return string(prefix) + "_" + randomPart, nil
+}
+
+// ExtractPrefix 从编号中提取前缀
+func ExtractPrefix(no string) Prefix {
+	idx := strings.IndexByte(no, '_')
+	if idx < 0 {
+		return ""
+	}
+	return Prefix(no[:idx])
+}
+
+// randomBase62 生成指定长度的 base62 随机字符串
+func randomBase62(length int) (string, error) {
+	return randomFromAlphabet(length, base62Chars)
+}
+
+func randomFromAlphabet(length int, alphabet string) (string, error) {
+	buf := make([]byte, length)
+	if _, err := rand.Read(buf); err != nil {
+		return "", err
+	}
+	result := make([]byte, length)
+	for i, b := range buf {
+		result[i] = alphabet[int(b)%len(alphabet)]
+	}
+	return string(result), nil
+}

package/dist/resources/templates/go-backend/internal/common/tradeno/generator_test.go

@@ -0,0 +1,396 @@
+package tradeno
+
+import (
+	"regexp"
+	"strings"
+	"sync"
+	"testing"
+)
+
+func TestGenerate(t *testing.T) {
+	tests := []struct {
+		prefix  Prefix
+		wantPfx string
+		wantLen int
+	}{
+		{PrefixOrder, "ord_", 28},
+		{PrefixPayment, "pay_", 28},
+		{PrefixBillingAccount, "bac_", 28},
+		{PrefixCheckoutSession, "chs_", 28},
+		{PrefixCheckoutExecution, "chex_", 29},
+		{PrefixCheckoutFulfillment, "chf_", 28},
+		{PrefixCheckoutCompensation, "chc_", 28},
+		{PrefixPaymentProviderCommand, "pcmd_", 29},
+		{PrefixPaymentProviderResource, "pres_", 29},
+		{PrefixPaymentCredential, "pcred_", 30},
+		{PrefixPaymentAuthorizationGrant, "pag_", 28},
+		{PrefixPaymentRiskProfile, "prp_", 28},
+		{PrefixPaymentProviderHealth, "pph_", 28},
+		{PrefixRefund, "ref_", 28},
+		{PrefixTransaction, "txn_", 28},
+		{PrefixSubscription, "sub_", 28},
+		{PrefixSubscriptionContractOwnership, "pcown_", 30},
+		{PrefixCart, "crt_", 28},
+		{PrefixCartMutationEvent, "cme_", 28},
+		{PrefixCheckoutQuote, "cqt_", 28},
+		{PrefixCheckoutQuoteDeliveryLine, "cdl_", 28},
+		{PrefixCheckoutQuoteTaxLine, "ctx_", 28},
+		{PrefixCatalogPurchaseOption, "pto_", 28},
+		{PrefixMarketingPromotion, "prm_", 28},
+		{PrefixMarketingCoupon, "cpn_", 28},
+		{PrefixInventoryStockItem, "isi_", 28},
+		{PrefixInventoryStockLevel, "isl_", 28},
+		{PrefixInventoryReservation, "irs_", 28},
+		{PrefixInventoryLedger, "ilg_", 28},
+		{PrefixInventoryAdjustment, "iadj_", 29},
+		{PrefixInventoryStocktake, "ist_", 28},
+		{PrefixInventoryTransfer, "itf_", 28},
+		{PrefixInventoryAlertHit, "iah_", 28},
+		{PrefixFulfillmentOrder, "ful_", 28},
+		{PrefixPickupCode, "pkc_", 28},
+		{PrefixDeliveryCapacityRule, "dcr_", 28},
+		{PrefixDeliveryCapacityLedger, "dcl_", 28},
+		{PrefixDeliveryCapacityTemplate, "dct_", 28},
+		{PrefixDeliveryCapacityTemplateRevision, "dcv_", 28},
+		{PrefixDeliveryCalendarAnnotation, "dca_", 28},
+		{PrefixDeliveryBusinessStatusOverride, "dbs_", 28},
+		{PrefixDeliveryBusinessStatusEvent, "dbe_", 28},
+		{PrefixDeliveryFeePolicy, "dfp_", 28},
+		{PrefixShipment, "shp_", 28},
+		{PrefixTrackingEvent, "tre_", 28},
+		{PrefixOrderNote, "ont_", 28},
+		{PrefixDiscoveryPublicationChannel, "dpc_", 28},
+		{PrefixDiscoveryPublicationSchedule, "dps_", 28},
+		{PrefixDocumentationRelease, "drl_", 28},
+		{PrefixDocumentationApprovalPolicy, "dap_", 28},
+		{PrefixDocumentationApprovalDecision, "dad_", 28},
+		{PrefixDocumentationProjectionGeneration, "dpg_", 28},
+		{PrefixDocumentationSiteRevision, "dsr_", 28},
+		{PrefixDocumentationDeployment, "ddp_", 28},
+		{PrefixDocumentationPromotion, "dpm_", 28},
+		{PrefixDocumentationAnswerRun, "dar_", 28},
+		{PrefixDocumentationRuntimeEvent, "dre_", 28},
+		{PrefixAPIContractCommitment, "acm_", 28},
+		{PrefixAPIContractEvent, "ace_", 28},
+		{PrefixAPIContractPublication, "acp_", 28},
+		{PrefixProductClientApplication, "pca_", 28},
+		{PrefixClientApplicationIdentifier, "cai_", 28},
+		{PrefixAppVersionRelease, "avr_", 28},
+		{PrefixAppVersionDistributionChannel, "avc_", 28},
+		{PrefixAppVersionReleaseAvailability, "ava_", 28},
+		{PrefixAppVersionSupportPolicy, "asp_", 28},
+		{PrefixFeatureFlag, "ffl_", 28},
+		{PrefixFeatureFlagPublication, "ffp_", 28},
+		{PrefixStorageAsset, "ast_", 28},
+		{PrefixStorageUploadSession, "upl_", 28},
+		{PrefixStorageAssetReference, "aref_", 29},
+		{PrefixOrganization, "org_", 28},
+		{PrefixOrganizationProductEnrollment, "ope_", 28},
+		{PrefixOrganizationMembership, "omb_", 28},
+		{PrefixOrganizationInvitation, "oinv_", 29},
+		{PrefixOrganizationTeam, "otm_", 28},
+		{PrefixOrganizationVerifiedDomain, "odm_", 28},
+		{PrefixOrganizationDomainChallenge, "odc_", 28},
+		{PrefixIdentitySSOConnection, "isc_", 28},
+		{PrefixIdentitySCIMUser, "isu_", 28},
+		{PrefixIdentitySCIMGroup, "isg_", 28},
+		{PrefixIAMPrincipal, "ipr_", 28},
+		{PrefixIAMRoleBinding, "irb_", 28},
+		{PrefixIAMPolicyBinding, "ipb_", 28},
+		{PrefixKOLAsset, "kat_", 28},
+	}
+
+	for _, tt := range tests {
+		no, err := Generate(tt.prefix)
+		if err != nil {
+			t.Fatalf("Generate(%s) failed: %v", tt.prefix, err)
+		}
+		if !strings.HasPrefix(no, tt.wantPfx) {
+			t.Errorf("expected prefix %s, got %s", tt.wantPfx, no)
+		}
+		if len(no) != tt.wantLen {
+			t.Errorf("expected length %d, got %d for %s", tt.wantLen, len(no), no)
+		}
+
+		// 随机部分只包含 base62 字符
+		random := no[len(tt.wantPfx):]
+		for _, ch := range random {
+			if !isBase62(byte(ch)) {
+				t.Errorf("invalid char %c in random part of %s", ch, no)
+			}
+		}
+	}
+}
+
+func TestLowercaseConstrainedPrefixesGenerateDatabaseSafeNumbers(t *testing.T) {
+	pattern := regexp.MustCompile(`^[a-z][a-z0-9]{2,3}_[a-z0-9]{24}$`)
+	prefixes := []Prefix{
+		PrefixBillingAccount,
+		PrefixInventoryStockItem,
+		PrefixInventoryStockLevel,
+		PrefixInventoryReservation,
+		PrefixInventoryLedger,
+		PrefixInventoryAdjustment,
+		PrefixInventoryStocktake,
+		PrefixInventoryTransfer,
+		PrefixInventoryAlertHit,
+		PrefixDeliveryCapacitySlot,
+		PrefixDeliveryCapacityRule,
+		PrefixDeliveryCapacityLedger,
+		PrefixDeliveryReservation,
+		PrefixDiscoveryPublicationChannel,
+		PrefixDiscoveryPublicationSchedule,
+		PrefixStorageAsset,
+		PrefixStorageUploadSession,
+		PrefixStorageAssetReference,
+		PrefixOrganization,
+		PrefixOrganizationProductEnrollment,
+		PrefixOrganizationMembership,
+		PrefixOrganizationInvitation,
+		PrefixOrganizationTeam,
+		PrefixOrganizationVerifiedDomain,
+		PrefixOrganizationDomainChallenge,
+		PrefixIdentitySSOConnection,
+		PrefixIdentitySCIMUser,
+		PrefixIdentitySCIMGroup,
+		PrefixIAMPrincipal,
+		PrefixIAMRoleBinding,
+		PrefixIAMPolicyBinding,
+		PrefixProductClientApplication,
+		PrefixClientApplicationIdentifier,
+		PrefixAppVersionRelease,
+		PrefixAppVersionDistributionChannel,
+		PrefixAppVersionReleaseAvailability,
+		PrefixAppVersionSupportPolicy,
+		PrefixFeatureFlag,
+		PrefixFeatureFlagPublication,
+	}
+
+	for _, prefix := range prefixes {
+		no, err := Generate(prefix)
+		if err != nil {
+			t.Fatalf("Generate(%s) failed: %v", prefix, err)
+		}
+		if !pattern.MatchString(no) {
+			t.Fatalf("Generate(%s) = %q, want lowercase database-safe number", prefix, no)
+		}
+	}
+}
+
+func TestExtractPrefix(t *testing.T) {
+	tests := []struct {
+		input    string
+		expected Prefix
+	}{
+		{"ord_7sK3mXp9RtY2vW4q", PrefixOrder},
+		{"pay_2bN8qWr4FhJ6nT1s", PrefixPayment},
+		{"ref_5cR1tYv6KpM3gU8e", PrefixRefund},
+		{"txn_9dS4wZx7LqN5hV2f", PrefixTransaction},
+		{"sub_1eT6yAz8MrO7iW3g", PrefixSubscription},
+		{"crt_3qL8pNz5YkD2mS7a", PrefixCart},
+		{"cme_2pK8nVz5YqD4mT7a", PrefixCartMutationEvent},
+		{"cqt_4rM9qPa6ZlE3nT8b", PrefixCheckoutQuote},
+		{"cdl_4rM9qPa6ZlE3nT8b", PrefixCheckoutQuoteDeliveryLine},
+		{"ctx_4rM9qPa6ZlE3nT8b", PrefixCheckoutQuoteTaxLine},
+		{"prm_4rM9qPa6ZlE3nT8b", PrefixMarketingPromotion},
+		{"cpn_4rM9qPa6ZlE3nT8b", PrefixMarketingCoupon},
+		{"irs_5sN1rQb7AmF4oU9c", PrefixInventoryReservation},
+		{"iadj_5sN1rQb7AmF4oU9c", PrefixInventoryAdjustment},
+		{"ist_5sN1rQb7AmF4oU9c", PrefixInventoryStocktake},
+		{"itf_5sN1rQb7AmF4oU9c", PrefixInventoryTransfer},
+		{"iah_5sN1rQb7AmF4oU9c", PrefixInventoryAlertHit},
+		{"ful_6tO2sRc8BnG5pV1d", PrefixFulfillmentOrder},
+		{"dcr_7uP3tSd9CoH6qW2e", PrefixDeliveryCapacityRule},
+		{"dcl_7uP3tSd9CoH6qW2e", PrefixDeliveryCapacityLedger},
+		{"dct_7uP3tSd9CoH6qW2e", PrefixDeliveryCapacityTemplate},
+		{"dcv_7uP3tSd9CoH6qW2e", PrefixDeliveryCapacityTemplateRevision},
+		{"dca_7uP3tSd9CoH6qW2e", PrefixDeliveryCalendarAnnotation},
+		{"dbs_7uP3tSd9CoH6qW2e", PrefixDeliveryBusinessStatusOverride},
+		{"dbe_7uP3tSd9CoH6qW2e", PrefixDeliveryBusinessStatusEvent},
+		{"dfp_7uP3tSd9CoH6qW2e", PrefixDeliveryFeePolicy},
+		{"INVALID", Prefix("")},
+		{"", Prefix("")},
+	}
+
+	for _, tt := range tests {
+		got := ExtractPrefix(tt.input)
+		if got != tt.expected {
+			t.Errorf("ExtractPrefix(%q) = %q, want %q", tt.input, got, tt.expected)
+		}
+	}
+}
+
+func TestPrefixValuesAreUnique(t *testing.T) {
+	prefixes := []struct {
+		name   string
+		prefix Prefix
+	}{
+		{"order", PrefixOrder},
+		{"cart", PrefixCart},
+		{"cart item", PrefixCartItem},
+		{"cart item attribute", PrefixCartItemAttribute},
+		{"cart mutation event", PrefixCartMutationEvent},
+		{"checkout quote", PrefixCheckoutQuote},
+		{"checkout quote item", PrefixCheckoutQuoteItem},
+		{"checkout quote adjustment", PrefixCheckoutQuoteAdjustment},
+		{"checkout quote reservation", PrefixCheckoutQuoteReservation},
+		{"checkout quote event", PrefixCheckoutQuoteEvent},
+		{"checkout quote delivery line", PrefixCheckoutQuoteDeliveryLine},
+		{"checkout quote tax line", PrefixCheckoutQuoteTaxLine},
+		{"catalog purchase option", PrefixCatalogPurchaseOption},
+		{"marketing promotion", PrefixMarketingPromotion},
+		{"marketing coupon", PrefixMarketingCoupon},
+		{"payment", PrefixPayment},
+		{"payment dispute", PrefixPaymentDispute},
+		{"payment dispute evidence", PrefixPaymentDisputeEvidence},
+		{"payment dispute action", PrefixPaymentDisputeAction},
+		{"payment risk block", PrefixPaymentRiskBlock},
+		{"payment risk signal", PrefixPaymentRiskSignal},
+		{"payment risk profile", PrefixPaymentRiskProfile},
+		{"payment provider health", PrefixPaymentProviderHealth},
+		{"payment routing decision", PrefixPaymentRoutingDecision},
+		{"refund", PrefixRefund},
+		{"transaction", PrefixTransaction},
+		{"subscription", PrefixSubscription},
+		{"inventory stock item", PrefixInventoryStockItem},
+		{"inventory stock level", PrefixInventoryStockLevel},
+		{"inventory reservation", PrefixInventoryReservation},
+		{"inventory ledger", PrefixInventoryLedger},
+		{"inventory adjustment", PrefixInventoryAdjustment},
+		{"inventory stocktake", PrefixInventoryStocktake},
+		{"inventory transfer", PrefixInventoryTransfer},
+		{"inventory alert hit", PrefixInventoryAlertHit},
+		{"fulfillment order", PrefixFulfillmentOrder},
+		{"fulfillment order item", PrefixFulfillmentOrderItem},
+		{"fulfillment event", PrefixFulfillmentEvent},
+		{"fulfillment exception", PrefixFulfillmentException},
+		{"pickup code", PrefixPickupCode},
+		{"delivery capacity slot", PrefixDeliveryCapacitySlot},
+		{"delivery capacity rule", PrefixDeliveryCapacityRule},
+		{"delivery capacity ledger", PrefixDeliveryCapacityLedger},
+		{"delivery capacity template", PrefixDeliveryCapacityTemplate},
+		{"delivery capacity template revision", PrefixDeliveryCapacityTemplateRevision},
+		{"delivery calendar annotation", PrefixDeliveryCalendarAnnotation},
+		{"delivery business status override", PrefixDeliveryBusinessStatusOverride},
+		{"delivery business status event", PrefixDeliveryBusinessStatusEvent},
+		{"delivery reservation", PrefixDeliveryReservation},
+		{"delivery task", PrefixDeliveryTask},
+		{"delivery task event", PrefixDeliveryTaskEvent},
+		{"delivery fee policy", PrefixDeliveryFeePolicy},
+		{"shipment", PrefixShipment},
+		{"tracking event", PrefixTrackingEvent},
+		{"order note", PrefixOrderNote},
+		{"discovery publication channel", PrefixDiscoveryPublicationChannel},
+		{"discovery publication schedule", PrefixDiscoveryPublicationSchedule},
+		{"documentation release", PrefixDocumentationRelease},
+		{"documentation approval policy", PrefixDocumentationApprovalPolicy},
+		{"documentation approval decision", PrefixDocumentationApprovalDecision},
+		{"documentation projection generation", PrefixDocumentationProjectionGeneration},
+		{"documentation site revision", PrefixDocumentationSiteRevision},
+		{"documentation deployment", PrefixDocumentationDeployment},
+		{"documentation promotion", PrefixDocumentationPromotion},
+		{"documentation answer run", PrefixDocumentationAnswerRun},
+		{"documentation runtime event", PrefixDocumentationRuntimeEvent},
+		{"API contract commitment", PrefixAPIContractCommitment},
+		{"API contract event", PrefixAPIContractEvent},
+		{"API contract publication", PrefixAPIContractPublication},
+		{"product client application", PrefixProductClientApplication},
+		{"client application identifier", PrefixClientApplicationIdentifier},
+		{"app version release", PrefixAppVersionRelease},
+		{"app version distribution channel", PrefixAppVersionDistributionChannel},
+		{"app version release availability", PrefixAppVersionReleaseAvailability},
+		{"app version support policy", PrefixAppVersionSupportPolicy},
+		{"feature flag", PrefixFeatureFlag},
+		{"feature flag publication", PrefixFeatureFlagPublication},
+		{"user", PrefixUser},
+		{"organization", PrefixOrganization},
+		{"organization product enrollment", PrefixOrganizationProductEnrollment},
+		{"organization membership", PrefixOrganizationMembership},
+		{"organization invitation", PrefixOrganizationInvitation},
+		{"organization team", PrefixOrganizationTeam},
+		{"organization verified domain", PrefixOrganizationVerifiedDomain},
+		{"organization domain challenge", PrefixOrganizationDomainChallenge},
+		{"identity SSO connection", PrefixIdentitySSOConnection},
+		{"identity SCIM user", PrefixIdentitySCIMUser},
+		{"identity SCIM group", PrefixIdentitySCIMGroup},
+		{"IAM principal", PrefixIAMPrincipal},
+		{"IAM role binding", PrefixIAMRoleBinding},
+		{"IAM policy binding", PrefixIAMPolicyBinding},
+		{"access policy decision", PrefixAccessPolicyDecision},
+		{"identity consent receipt", PrefixIdentityConsentReceipt},
+		{"kol contract", PrefixKOLContract},
+		{"kol asset", PrefixKOLAsset},
+		{"kol deliverable", PrefixKOLDeliverable},
+		{"kol content item", PrefixKOLContentItem},
+		{"kol alert", PrefixKOLAlert},
+	}
+	seen := make(map[Prefix]string, len(prefixes))
+	for _, item := range prefixes {
+		if item.prefix == "" {
+			t.Fatalf("prefix %s is empty", item.name)
+		}
+		if l := len(item.prefix); l < 3 || l > 4 {
+			t.Fatalf("prefix %s = %q, want 3-4 characters", item.name, item.prefix)
+		}
+		if owner, ok := seen[item.prefix]; ok {
+			t.Fatalf("prefix %q reused by %s and %s", item.prefix, owner, item.name)
+		}
+		seen[item.prefix] = item.name
+	}
+}
+
+func TestUniqueness(t *testing.T) {
+	count := 10000
+	seen := make(map[string]struct{}, count)
+
+	for i := 0; i < count; i++ {
+		no, err := Generate(PrefixOrder)
+		if err != nil {
+			t.Fatal(err)
+		}
+		if _, exists := seen[no]; exists {
+			t.Fatalf("duplicate at iteration %d: %s", i, no)
+		}
+		seen[no] = struct{}{}
+	}
+}
+
+func TestConcurrency(t *testing.T) {
+	const goroutines = 50
+	const perGoroutine = 200
+
+	var mu sync.Mutex
+	seen := make(map[string]struct{}, goroutines*perGoroutine)
+	var wg sync.WaitGroup
+
+	for g := 0; g < goroutines; g++ {
+		wg.Add(1)
+		go func() {
+			defer wg.Done()
+			for i := 0; i < perGoroutine; i++ {
+				no, err := Generate(PrefixOrder)
+				if err != nil {
+					t.Errorf("Generate failed: %v", err)
+					return
+				}
+				mu.Lock()
+				if _, exists := seen[no]; exists {
+					t.Errorf("duplicate: %s", no)
+				}
+				seen[no] = struct{}{}
+				mu.Unlock()
+			}
+		}()
+	}
+	wg.Wait()
+}
+
+func BenchmarkGenerate(b *testing.B) {
+	for i := 0; i < b.N; i++ {
+		_, _ = Generate(PrefixOrder)
+	}
+}
+
+func isBase62(ch byte) bool {
+	return (ch >= '0' && ch <= '9') || (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z')
+}