commerce/util/hashid/kind.go

package hashid

import "fmt"

// DO NOT ALPHABETIZE THESE OR ALTER IN ANYWAY
var kinds = map[string]int{
	"bundle":              0,
	"campaign":            1,
	"collection":          2,
	"coupon":              3,
	"namespace":           4,
	"order":               5,
	"organization":        6,
	"payment":             7,
	"plan":                8,
	"analyticsevent":      9,
	"product":             10,
	"store":               11,
	"token":               12,
	"user":                13,
	"variant":             14,
	"form":                15,
	"subscriber":          16,
	"referral":            17,
	"referrer":            18,
	"transaction":         19,
	"funnel":              20,
	"aggregate":           21,
	"site":                22,
	"deploy":              23,
	"submission":          24,
	"subscription":        25,
	"cart":                31,
	"affiliate":           32,
	"fee":                 33,
	"transfer":            34,
	"reversal":            35,
	"partner":             36,
	"discount":            37,
	"webhook":             38,
	"referralprogram":     39,
	"review":              40,
	"return":              41,
	"note":                42,
	"analyticsidentifier": 43,
	"taxrates":            44,
	"shippingrates":       45,
	"oauthtoken":          46,
	"app":                 47,
	"wallet":              48,
	"tokensale":           49,
	"adcampaign":          50,
	"adconfig":            51,
	"adset":               52,
	"ad":                  53,
	"copy":                54,
	"media":               55,
	"block":               56,
	"blockaddress":        57,
	"blocktransaction":    58,
	"paymentmethod":       60,

	// virtual kind used for making ancestor keys to force data synchronization
	"synckey":          59,
	"tokentransaction": 100,
	"disclosure":       101,
	"movie":            200,
	"watchlist":        201,
	"meter":            202,
	// A per-unit price. Distinct from "meter" (202), which is an event
	// aggregation rule — what to count — where this is what one unit costs.
	"rate":         291,
	"credit-grant": 203,

	// Billing & commerce entities added for ORM compatibility
	"meter-event":               204,
	"billing-pricing-rule":      205,
	"billing-event":             206,
	"billing-invoice":           207,
	"billing-payout":            208,
	"balance-transaction":       209,
	"bank-transfer-instruction": 210,
	"credit-note":               211,
	"customer-balance":          212,
	"dispute":                   213,
	"payment-intent":            214,
	"refund":                    215,
	"spend-alert":               216,
	"webhook-endpoint":          217,
	"network-token":             218,
	"crypto-balance":            219,
	"crypto-payment-intent":     220,
	"usage-watermark":           221,
	"setup-intent":              222,
	"notification":              223,
	"apipermission":             224,
	"applicationmethod":         225,
	"campaignbudget":            226,
	"contributor":               227,
	"customergroup":             228,
	"customergroupmembership":   229,
	"fulfillment":               230,
	"fulfillmentprovider":       231,
	"fulfillmentset":            232,
	"geozone":                   233,
	"inventoryitem":             234,
	"inventorylevel":            235,
	"price":                     236,
	"pricelist":                 237,
	"pricepreference":           238,
	"pricerule":                 239,
	"priceset":                  240,
	"promotion":                 241,
	"promotionrule":             242,
	"publishableapikey":         243,
	"redemption":                244,
	"region":                    245,
	"reservation":               246,
	"role":                      247,
	"saleschannel":              248,
	"sbom-entry":                249,
	"servicezone":               250,
	"shippingoption":            251,
	"shippingoptionrule":        252,
	"shippingprofile":           253,
	"stocklocation":             254,
	"taxprovider":               255,
	"taxrate":                   256,
	"taxraterule":               257,
	"taxregion":                 258,
	"variantinventorylink":      259,
	"subscription-item":         260,
	"subscription-schedule":     261,
	"sbom-record":               262,
	"oss-accrual":               263,

	// B2B commerce (Hanzo-native; not in Medusa v2 core — that lives in the
	// medusa-starter-b2b recipe). company → employees (spending limits) →
	// quotes (RFQ) → approvals (spend gating).
	"company":       264,
	"employee":      265,
	"quote":         266,
	"quote-message": 267,
	"approval":      268,

	// Gift cards (Hanzo-native; removed from Medusa v2 core, present in v1).
	// Redemptions are an append-only ledger; balance is a projection.
	"gift-card":            269,
	"gift-card-redemption": 270,

	// Order exchange (Medusa v2 core parity: api/admin/exchanges) — a return
	// of inbound items paired with outbound replacement items.
	"exchange": 271,

	// Reusable idempotency guard for money-moving requests (refund/capture).
	"idempotency-key": 272,

	// Platform product catalog (CMS SOT for Hanzo's own products — the catalog
	// docs.hanzo.ai + console + pricing derive from). Brand/category-scoped.
	"catalog-entry": 273,

	// Product builder taxonomy (Medusa v2 parity: product-options/values as
	// first-class admin entities; categories/tags/types for organization).
	"product-option":       274,
	"product-option-value": 275,
	"product-category":     276,
	"product-tag":          277,
	"product-type":         278,

	// Order reason lookups (Medusa: return-reasons / refund-reasons).
	"return-reason": 279,
	"refund-reason": 280,

	// Chain-backed credit ledger (HUSD on the Hanzo EVM). husd-issuance is the
	// off-chain idempotent record of ONE treasury mint (deterministic-id keyed
	// on the idempotency key); its TxHash is the on-chain audit anchor.
	"husd-issuance": 281,
	// husd-cursor: the indexer's last fully-scanned block (per chain), so a
	// restart resumes rather than rescans. husd-settlement: the idempotent record
	// of ONE org→treasury settlement window (metered usage swept back on chain).
	"husd-cursor":     282,
	"husd-settlement": 283,

	// commerce-invite: a platform-minted invite code that grants ONE org
	// subscription-free access to the commerce admin (the paywall's third allow
	// path, alongside an active/trialing subscription and live trial credit). A
	// global (system-namespace) directory keyed by code; first-touch redeem binds
	// the code to the redeeming org, idempotently.
	"commerce-invite": 284,

	// Medusa-parity domains (admin order builder, order claims, currency entity).
	// Monotonic — never reorder. draft-order → admin builds an order for a customer
	// with line items, then converts it to a real order; claim → damaged/wrong-item
	// resolution (refund|replace); currency → the currency entity (was a bare string).
	"draft-order":      285,
	"draft-order-item": 286,
	"claim":            287,
	"claim-item":       288,
	"currency":         289,

	// auto-recharge — the per-org off-session top-up config. The model has
	// registered this kind with the ORM since it was written
	// (models/autorecharge: orm.Register[AutoRecharge]("auto-recharge")) but was
	// never added here, so Create() hit encodeKind's panic: enabling
	// auto-recharge for the first time (PUT /v1/billing/recharge, which
	// Creates when no row exists) was a hard 500. Updating an existing row never
	// touched this path, which is why it survived — there was no way to get a
	// first row in.
	"auto-recharge": 290,
}

var kindsReversed = make(map[int]string)

func init() {
	for k, v := range kinds {
		kindsReversed[v] = k
	}
}

func encodeKind(kind string) int {
	if encoded, ok := kinds[kind]; ok {
		return encoded
	} else {
		panic(fmt.Sprintf("Unknown kind '%s', register in util/hashid/kind.go", kind))
	}
}

func decodeKind(encoded int) (string, error) {
	if kind, ok := kindsReversed[encoded]; ok {
		return kind, nil
	} else {
		return "", fmt.Errorf("Unknown encoded kind '%d', register in util/hashid/kind.go", encoded)
	}
}