taxcode

type CreateTaxCodeInput struct {
	Namespace   string
	Key         string
	Name        string
	Description *string
	AppMappings TaxCodeAppMappings
	Metadata    models.Metadata
	Annotations models.Annotations
}

type DeleteTaxCodeInput struct {
	models.NamespacedID
	// contains filtered or unexported fields
}

type GetOrCreateByAppMappingInput struct {
	Namespace string
	AppType   app.AppType
	TaxCode   string
}

type GetOrganizationDefaultTaxCodesInput struct {
	Namespace string
	Expand    OrganizationDefaultTaxCodesExpand
}

type GetTaxCodeByAppMappingInput struct {
	Namespace string
	AppType   app.AppType
	TaxCode   string
}

type GetTaxCodeByKeyInput struct {
	Namespace string
	Key       string
}

type GetTaxCodeInput struct {
	models.NamespacedID

	// IncludeDeleted controls whether soft-deleted records are returned.
	// Only for internal service-to-service use; never set from API handlers.
	IncludeDeleted bool
}

type ListTaxCodesInput struct {
	Namespace string
	pagination.Page

	IncludeDeleted bool
}

type NamespaceHandler struct {
	// contains filtered or unexported fields
}

type NamespaceHandlerConfig struct {
	Logger             *slog.Logger
	Service            Service
	Seeds              []SeedEntry
	TransactionManager transaction.Creator
}

type OrganizationDefaultTaxCodes struct {
	models.NamespacedID
	models.ManagedModel

	InvoicingTaxCodeID string   `json:"invoicing_tax_code_id"`
	InvoicingTaxCode   *TaxCode `json:"invoicing_tax_code,omitempty"`

	CreditGrantTaxCodeID string   `json:"credit_grant_tax_code_id"`
	CreditGrantTaxCode   *TaxCode `json:"credit_grant_tax_code,omitempty"`
}

type OrganizationDefaultTaxCodesExpand struct {
	InvoicingTaxCode   bool
	CreditGrantTaxCode bool
}

type OrganizationDefaultTaxCodesService interface {
	GetOrganizationDefaultTaxCodes(ctx context.Context, input GetOrganizationDefaultTaxCodesInput) (OrganizationDefaultTaxCodes, error)
	UpsertOrganizationDefaultTaxCodes(ctx context.Context, input UpsertOrganizationDefaultTaxCodesInput) (OrganizationDefaultTaxCodes, error)
}

type Repository interface {
	entutils.TxCreator

	CreateTaxCode(ctx context.Context, input CreateTaxCodeInput) (TaxCode, error)
	UpdateTaxCode(ctx context.Context, input UpdateTaxCodeInput) (TaxCode, error)
	ListTaxCodes(ctx context.Context, input ListTaxCodesInput) (pagination.Result[TaxCode], error)
	GetTaxCode(ctx context.Context, input GetTaxCodeInput) (TaxCode, error)
	GetTaxCodeByKey(ctx context.Context, input GetTaxCodeByKeyInput) (TaxCode, error)
	GetTaxCodeByAppMapping(ctx context.Context, input GetTaxCodeByAppMappingInput) (TaxCode, error)
	DeleteTaxCode(ctx context.Context, input DeleteTaxCodeInput) error

	GetOrganizationDefaultTaxCodes(ctx context.Context, input GetOrganizationDefaultTaxCodesInput) (OrganizationDefaultTaxCodes, error)
	UpsertOrganizationDefaultTaxCodes(ctx context.Context, input UpsertOrganizationDefaultTaxCodesInput) (OrganizationDefaultTaxCodes, error)
}

type SeedEntry struct {
	Key                string
	Name               string
	Description        *string
	AppMappings        TaxCodeAppMappings
	DefaultInvoicing   bool
	DefaultCreditGrant bool
}

type Service interface {
	TaxCodeService
	OrganizationDefaultTaxCodesService
}

type TaxCode struct {
	models.NamespacedID
	models.ManagedModel

	// Key is the unique key for TaxCode.
	Key string `json:"key"`

	// Name is the display name for TaxCode.
	Name string `json:"name"`

	// Description is the description for TaxCode.
	Description *string `json:"description,omitempty"`

	// AppMappings is the mapping of app types to tax codes.
	AppMappings TaxCodeAppMappings `json:"app_mappings"`

	// Metadata
	Metadata models.Metadata `json:"metadata,omitempty"`

	// Annotations are system-managed key/value pairs stored alongside the tax code.
	Annotations models.Annotations `json:"annotations,omitempty"`
}

type TaxCodeAppMapping struct {
	AppType app.AppType `json:"app_type"`
	TaxCode string      `json:"tax_code"`
}

type TaxCodeAppMappings []TaxCodeAppMapping

type TaxCodeService interface {
	CreateTaxCode(ctx context.Context, input CreateTaxCodeInput) (TaxCode, error)
	UpdateTaxCode(ctx context.Context, input UpdateTaxCodeInput) (TaxCode, error)
	ListTaxCodes(ctx context.Context, input ListTaxCodesInput) (pagination.Result[TaxCode], error)
	GetTaxCode(ctx context.Context, input GetTaxCodeInput) (TaxCode, error)
	GetTaxCodeByKey(ctx context.Context, input GetTaxCodeByKeyInput) (TaxCode, error)
	GetTaxCodeByAppMapping(ctx context.Context, input GetTaxCodeByAppMappingInput) (TaxCode, error)
	GetOrCreateByAppMapping(ctx context.Context, input GetOrCreateByAppMappingInput) (TaxCode, error)
	DeleteTaxCode(ctx context.Context, input DeleteTaxCodeInput) error
}

type UpdateTaxCodeInput struct {
	models.NamespacedID

	Name        string
	Description *string
	AppMappings TaxCodeAppMappings
	Metadata    models.Metadata
	Annotations models.Annotations
	// contains filtered or unexported fields
}

type UpsertOrganizationDefaultTaxCodesInput struct {
	Namespace            string
	InvoicingTaxCodeID   string
	CreditGrantTaxCodeID string
	Expand               OrganizationDefaultTaxCodesExpand
}