subject

type Adapter interface {
	Create(ctx context.Context, input CreateInput) (Subject, error)
	Update(ctx context.Context, input UpdateInput) (Subject, error)
	GetByIdOrKey(ctx context.Context, namespace string, idOrKey string) (Subject, error)
	GetByKey(ctx context.Context, key models.NamespacedKey) (Subject, error)
	GetById(ctx context.Context, id models.NamespacedID) (Subject, error)
	List(ctx context.Context, namespace string, params ListParams) (pagination.PagedResponse[Subject], error)
	Delete(ctx context.Context, id models.NamespacedID) error

	entutils.TxCreator
}

type CreateInput struct {
	Namespace        string
	Key              string
	DisplayName      *string
	StripeCustomerId *string
	Metadata         *map[string]interface{}
}

type GetSubjectAdapterInput struct {
	Namespace string
	ID        string
	Key       string
}

type ListParams struct {
	Keys   []string
	Search string
	Page   pagination.Page
	SortBy ListSortBy
}

type ListSortBy string

type OptionalNullable[T any] struct {
	Value *T
	IsSet bool
}

type Service interface {
	models.ServiceHooks[Subject]

	Create(ctx context.Context, input CreateInput) (Subject, error)
	Update(ctx context.Context, input UpdateInput) (Subject, error)

	GetByKey(ctx context.Context, key models.NamespacedKey) (Subject, error)
	GetById(ctx context.Context, id models.NamespacedID) (Subject, error)

	// GetByIdOrKey is a convenience method that gets a subject by ID or key (please use GetById or GetByKey instead if possible)
	GetByIdOrKey(ctx context.Context, orgId string, idOrKey string) (Subject, error)
	List(ctx context.Context, orgId string, params ListParams) (pagination.PagedResponse[Subject], error)
	Delete(ctx context.Context, id models.NamespacedID) error
}

type Subject struct {
	Namespace   string
	Id          string
	Key         string
	DisplayName *string
	Metadata    map[string]interface{}
	// Use customer application entity instead
	StripeCustomerId *string
}

type SubjectKey struct {
	Key string `json:"key"`
}

type UpdateInput struct {
	ID               string
	Namespace        string
	DisplayName      OptionalNullable[string]
	StripeCustomerId OptionalNullable[string]
	Metadata         OptionalNullable[map[string]interface{}]
}