fix: api descript

2026-02-28 05:33:16 +08:00
parent 5930fb0dde
commit d2f33b4b96
243 changed files with 37065 additions and 780 deletions
@@ -0,0 +1,484 @@
+// Code generated by ent, DO NOT EDIT.
+
+package models
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"log"
+	"reflect"
+
+	"juwan-backend/app/player/rpc/internal/models/migrate"
+
+	"juwan-backend/app/player/rpc/internal/models/players"
+	"juwan-backend/app/player/rpc/internal/models/playerservices"
+
+	"entgo.io/ent"
+	"entgo.io/ent/dialect"
+	"entgo.io/ent/dialect/sql"
+)
+
+// Client is the client that holds all ent builders.
+type Client struct {
+	config
+	// Schema is the client for creating, migrating and dropping schema.
+	Schema *migrate.Schema
+	// PlayerServices is the client for interacting with the PlayerServices builders.
+	PlayerServices *PlayerServicesClient
+	// Players is the client for interacting with the Players builders.
+	Players *PlayersClient
+}
+
+// NewClient creates a new client configured with the given options.
+func NewClient(opts ...Option) *Client {
+	client := &Client{config: newConfig(opts...)}
+	client.init()
+	return client
+}
+
+func (c *Client) init() {
+	c.Schema = migrate.NewSchema(c.driver)
+	c.PlayerServices = NewPlayerServicesClient(c.config)
+	c.Players = NewPlayersClient(c.config)
+}
+
+type (
+	// config is the configuration for the client and its builder.
+	config struct {
+		// driver used for executing database requests.
+		driver dialect.Driver
+		// debug enable a debug logging.
+		debug bool
+		// log used for logging on debug mode.
+		log func(...any)
+		// hooks to execute on mutations.
+		hooks *hooks
+		// interceptors to execute on queries.
+		inters *inters
+	}
+	// Option function to configure the client.
+	Option func(*config)
+)
+
+// newConfig creates a new config for the client.
+func newConfig(opts ...Option) config {
+	cfg := config{log: log.Println, hooks: &hooks{}, inters: &inters{}}
+	cfg.options(opts...)
+	return cfg
+}
+
+// options applies the options on the config object.
+func (c *config) options(opts ...Option) {
+	for _, opt := range opts {
+		opt(c)
+	}
+	if c.debug {
+		c.driver = dialect.Debug(c.driver, c.log)
+	}
+}
+
+// Debug enables debug logging on the ent.Driver.
+func Debug() Option {
+	return func(c *config) {
+		c.debug = true
+	}
+}
+
+// Log sets the logging function for debug mode.
+func Log(fn func(...any)) Option {
+	return func(c *config) {
+		c.log = fn
+	}
+}
+
+// Driver configures the client driver.
+func Driver(driver dialect.Driver) Option {
+	return func(c *config) {
+		c.driver = driver
+	}
+}
+
+// Open opens a database/sql.DB specified by the driver name and
+// the data source name, and returns a new client attached to it.
+// Optional parameters can be added for configuring the client.
+func Open(driverName, dataSourceName string, options ...Option) (*Client, error) {
+	switch driverName {
+	case dialect.MySQL, dialect.Postgres, dialect.SQLite:
+		drv, err := sql.Open(driverName, dataSourceName)
+		if err != nil {
+			return nil, err
+		}
+		return NewClient(append(options, Driver(drv))...), nil
+	default:
+		return nil, fmt.Errorf("unsupported driver: %q", driverName)
+	}
+}
+
+// ErrTxStarted is returned when trying to start a new transaction from a transactional client.
+var ErrTxStarted = errors.New("models: cannot start a transaction within a transaction")
+
+// Tx returns a new transactional client. The provided context
+// is used until the transaction is committed or rolled back.
+func (c *Client) Tx(ctx context.Context) (*Tx, error) {
+	if _, ok := c.driver.(*txDriver); ok {
+		return nil, ErrTxStarted
+	}
+	tx, err := newTx(ctx, c.driver)
+	if err != nil {
+		return nil, fmt.Errorf("models: starting a transaction: %w", err)
+	}
+	cfg := c.config
+	cfg.driver = tx
+	return &Tx{
+		ctx:            ctx,
+		config:         cfg,
+		PlayerServices: NewPlayerServicesClient(cfg),
+		Players:        NewPlayersClient(cfg),
+	}, nil
+}
+
+// BeginTx returns a transactional client with specified options.
+func (c *Client) BeginTx(ctx context.Context, opts *sql.TxOptions) (*Tx, error) {
+	if _, ok := c.driver.(*txDriver); ok {
+		return nil, errors.New("ent: cannot start a transaction within a transaction")
+	}
+	tx, err := c.driver.(interface {
+		BeginTx(context.Context, *sql.TxOptions) (dialect.Tx, error)
+	}).BeginTx(ctx, opts)
+	if err != nil {
+		return nil, fmt.Errorf("ent: starting a transaction: %w", err)
+	}
+	cfg := c.config
+	cfg.driver = &txDriver{tx: tx, drv: c.driver}
+	return &Tx{
+		ctx:            ctx,
+		config:         cfg,
+		PlayerServices: NewPlayerServicesClient(cfg),
+		Players:        NewPlayersClient(cfg),
+	}, nil
+}
+
+// Debug returns a new debug-client. It's used to get verbose logging on specific operations.
+//
+//	client.Debug().
+//		PlayerServices.
+//		Query().
+//		Count(ctx)
+func (c *Client) Debug() *Client {
+	if c.debug {
+		return c
+	}
+	cfg := c.config
+	cfg.driver = dialect.Debug(c.driver, c.log)
+	client := &Client{config: cfg}
+	client.init()
+	return client
+}
+
+// Close closes the database connection and prevents new queries from starting.
+func (c *Client) Close() error {
+	return c.driver.Close()
+}
+
+// Use adds the mutation hooks to all the entity clients.
+// In order to add hooks to a specific client, call: `client.Node.Use(...)`.
+func (c *Client) Use(hooks ...Hook) {
+	c.PlayerServices.Use(hooks...)
+	c.Players.Use(hooks...)
+}
+
+// Intercept adds the query interceptors to all the entity clients.
+// In order to add interceptors to a specific client, call: `client.Node.Intercept(...)`.
+func (c *Client) Intercept(interceptors ...Interceptor) {
+	c.PlayerServices.Intercept(interceptors...)
+	c.Players.Intercept(interceptors...)
+}
+
+// Mutate implements the ent.Mutator interface.
+func (c *Client) Mutate(ctx context.Context, m Mutation) (Value, error) {
+	switch m := m.(type) {
+	case *PlayerServicesMutation:
+		return c.PlayerServices.mutate(ctx, m)
+	case *PlayersMutation:
+		return c.Players.mutate(ctx, m)
+	default:
+		return nil, fmt.Errorf("models: unknown mutation type %T", m)
+	}
+}
+
+// PlayerServicesClient is a client for the PlayerServices schema.
+type PlayerServicesClient struct {
+	config
+}
+
+// NewPlayerServicesClient returns a client for the PlayerServices from the given config.
+func NewPlayerServicesClient(c config) *PlayerServicesClient {
+	return &PlayerServicesClient{config: c}
+}
+
+// Use adds a list of mutation hooks to the hooks stack.
+// A call to `Use(f, g, h)` equals to `playerservices.Hooks(f(g(h())))`.
+func (c *PlayerServicesClient) Use(hooks ...Hook) {
+	c.hooks.PlayerServices = append(c.hooks.PlayerServices, hooks...)
+}
+
+// Intercept adds a list of query interceptors to the interceptors stack.
+// A call to `Intercept(f, g, h)` equals to `playerservices.Intercept(f(g(h())))`.
+func (c *PlayerServicesClient) Intercept(interceptors ...Interceptor) {
+	c.inters.PlayerServices = append(c.inters.PlayerServices, interceptors...)
+}
+
+// Create returns a builder for creating a PlayerServices entity.
+func (c *PlayerServicesClient) Create() *PlayerServicesCreate {
+	mutation := newPlayerServicesMutation(c.config, OpCreate)
+	return &PlayerServicesCreate{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// CreateBulk returns a builder for creating a bulk of PlayerServices entities.
+func (c *PlayerServicesClient) CreateBulk(builders ...*PlayerServicesCreate) *PlayerServicesCreateBulk {
+	return &PlayerServicesCreateBulk{config: c.config, builders: builders}
+}
+
+// MapCreateBulk creates a bulk creation builder from the given slice. For each item in the slice, the function creates
+// a builder and applies setFunc on it.
+func (c *PlayerServicesClient) MapCreateBulk(slice any, setFunc func(*PlayerServicesCreate, int)) *PlayerServicesCreateBulk {
+	rv := reflect.ValueOf(slice)
+	if rv.Kind() != reflect.Slice {
+		return &PlayerServicesCreateBulk{err: fmt.Errorf("calling to PlayerServicesClient.MapCreateBulk with wrong type %T, need slice", slice)}
+	}
+	builders := make([]*PlayerServicesCreate, rv.Len())
+	for i := 0; i < rv.Len(); i++ {
+		builders[i] = c.Create()
+		setFunc(builders[i], i)
+	}
+	return &PlayerServicesCreateBulk{config: c.config, builders: builders}
+}
+
+// Update returns an update builder for PlayerServices.
+func (c *PlayerServicesClient) Update() *PlayerServicesUpdate {
+	mutation := newPlayerServicesMutation(c.config, OpUpdate)
+	return &PlayerServicesUpdate{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// UpdateOne returns an update builder for the given entity.
+func (c *PlayerServicesClient) UpdateOne(_m *PlayerServices) *PlayerServicesUpdateOne {
+	mutation := newPlayerServicesMutation(c.config, OpUpdateOne, withPlayerServices(_m))
+	return &PlayerServicesUpdateOne{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// UpdateOneID returns an update builder for the given id.
+func (c *PlayerServicesClient) UpdateOneID(id int64) *PlayerServicesUpdateOne {
+	mutation := newPlayerServicesMutation(c.config, OpUpdateOne, withPlayerServicesID(id))
+	return &PlayerServicesUpdateOne{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// Delete returns a delete builder for PlayerServices.
+func (c *PlayerServicesClient) Delete() *PlayerServicesDelete {
+	mutation := newPlayerServicesMutation(c.config, OpDelete)
+	return &PlayerServicesDelete{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// DeleteOne returns a builder for deleting the given entity.
+func (c *PlayerServicesClient) DeleteOne(_m *PlayerServices) *PlayerServicesDeleteOne {
+	return c.DeleteOneID(_m.ID)
+}
+
+// DeleteOneID returns a builder for deleting the given entity by its id.
+func (c *PlayerServicesClient) DeleteOneID(id int64) *PlayerServicesDeleteOne {
+	builder := c.Delete().Where(playerservices.ID(id))
+	builder.mutation.id = &id
+	builder.mutation.op = OpDeleteOne
+	return &PlayerServicesDeleteOne{builder}
+}
+
+// Query returns a query builder for PlayerServices.
+func (c *PlayerServicesClient) Query() *PlayerServicesQuery {
+	return &PlayerServicesQuery{
+		config: c.config,
+		ctx:    &QueryContext{Type: TypePlayerServices},
+		inters: c.Interceptors(),
+	}
+}
+
+// Get returns a PlayerServices entity by its id.
+func (c *PlayerServicesClient) Get(ctx context.Context, id int64) (*PlayerServices, error) {
+	return c.Query().Where(playerservices.ID(id)).Only(ctx)
+}
+
+// GetX is like Get, but panics if an error occurs.
+func (c *PlayerServicesClient) GetX(ctx context.Context, id int64) *PlayerServices {
+	obj, err := c.Get(ctx, id)
+	if err != nil {
+		panic(err)
+	}
+	return obj
+}
+
+// Hooks returns the client hooks.
+func (c *PlayerServicesClient) Hooks() []Hook {
+	return c.hooks.PlayerServices
+}
+
+// Interceptors returns the client interceptors.
+func (c *PlayerServicesClient) Interceptors() []Interceptor {
+	return c.inters.PlayerServices
+}
+
+func (c *PlayerServicesClient) mutate(ctx context.Context, m *PlayerServicesMutation) (Value, error) {
+	switch m.Op() {
+	case OpCreate:
+		return (&PlayerServicesCreate{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpUpdate:
+		return (&PlayerServicesUpdate{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpUpdateOne:
+		return (&PlayerServicesUpdateOne{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpDelete, OpDeleteOne:
+		return (&PlayerServicesDelete{config: c.config, hooks: c.Hooks(), mutation: m}).Exec(ctx)
+	default:
+		return nil, fmt.Errorf("models: unknown PlayerServices mutation op: %q", m.Op())
+	}
+}
+
+// PlayersClient is a client for the Players schema.
+type PlayersClient struct {
+	config
+}
+
+// NewPlayersClient returns a client for the Players from the given config.
+func NewPlayersClient(c config) *PlayersClient {
+	return &PlayersClient{config: c}
+}
+
+// Use adds a list of mutation hooks to the hooks stack.
+// A call to `Use(f, g, h)` equals to `players.Hooks(f(g(h())))`.
+func (c *PlayersClient) Use(hooks ...Hook) {
+	c.hooks.Players = append(c.hooks.Players, hooks...)
+}
+
+// Intercept adds a list of query interceptors to the interceptors stack.
+// A call to `Intercept(f, g, h)` equals to `players.Intercept(f(g(h())))`.
+func (c *PlayersClient) Intercept(interceptors ...Interceptor) {
+	c.inters.Players = append(c.inters.Players, interceptors...)
+}
+
+// Create returns a builder for creating a Players entity.
+func (c *PlayersClient) Create() *PlayersCreate {
+	mutation := newPlayersMutation(c.config, OpCreate)
+	return &PlayersCreate{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// CreateBulk returns a builder for creating a bulk of Players entities.
+func (c *PlayersClient) CreateBulk(builders ...*PlayersCreate) *PlayersCreateBulk {
+	return &PlayersCreateBulk{config: c.config, builders: builders}
+}
+
+// MapCreateBulk creates a bulk creation builder from the given slice. For each item in the slice, the function creates
+// a builder and applies setFunc on it.
+func (c *PlayersClient) MapCreateBulk(slice any, setFunc func(*PlayersCreate, int)) *PlayersCreateBulk {
+	rv := reflect.ValueOf(slice)
+	if rv.Kind() != reflect.Slice {
+		return &PlayersCreateBulk{err: fmt.Errorf("calling to PlayersClient.MapCreateBulk with wrong type %T, need slice", slice)}
+	}
+	builders := make([]*PlayersCreate, rv.Len())
+	for i := 0; i < rv.Len(); i++ {
+		builders[i] = c.Create()
+		setFunc(builders[i], i)
+	}
+	return &PlayersCreateBulk{config: c.config, builders: builders}
+}
+
+// Update returns an update builder for Players.
+func (c *PlayersClient) Update() *PlayersUpdate {
+	mutation := newPlayersMutation(c.config, OpUpdate)
+	return &PlayersUpdate{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// UpdateOne returns an update builder for the given entity.
+func (c *PlayersClient) UpdateOne(_m *Players) *PlayersUpdateOne {
+	mutation := newPlayersMutation(c.config, OpUpdateOne, withPlayers(_m))
+	return &PlayersUpdateOne{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// UpdateOneID returns an update builder for the given id.
+func (c *PlayersClient) UpdateOneID(id int64) *PlayersUpdateOne {
+	mutation := newPlayersMutation(c.config, OpUpdateOne, withPlayersID(id))
+	return &PlayersUpdateOne{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// Delete returns a delete builder for Players.
+func (c *PlayersClient) Delete() *PlayersDelete {
+	mutation := newPlayersMutation(c.config, OpDelete)
+	return &PlayersDelete{config: c.config, hooks: c.Hooks(), mutation: mutation}
+}
+
+// DeleteOne returns a builder for deleting the given entity.
+func (c *PlayersClient) DeleteOne(_m *Players) *PlayersDeleteOne {
+	return c.DeleteOneID(_m.ID)
+}
+
+// DeleteOneID returns a builder for deleting the given entity by its id.
+func (c *PlayersClient) DeleteOneID(id int64) *PlayersDeleteOne {
+	builder := c.Delete().Where(players.ID(id))
+	builder.mutation.id = &id
+	builder.mutation.op = OpDeleteOne
+	return &PlayersDeleteOne{builder}
+}
+
+// Query returns a query builder for Players.
+func (c *PlayersClient) Query() *PlayersQuery {
+	return &PlayersQuery{
+		config: c.config,
+		ctx:    &QueryContext{Type: TypePlayers},
+		inters: c.Interceptors(),
+	}
+}
+
+// Get returns a Players entity by its id.
+func (c *PlayersClient) Get(ctx context.Context, id int64) (*Players, error) {
+	return c.Query().Where(players.ID(id)).Only(ctx)
+}
+
+// GetX is like Get, but panics if an error occurs.
+func (c *PlayersClient) GetX(ctx context.Context, id int64) *Players {
+	obj, err := c.Get(ctx, id)
+	if err != nil {
+		panic(err)
+	}
+	return obj
+}
+
+// Hooks returns the client hooks.
+func (c *PlayersClient) Hooks() []Hook {
+	return c.hooks.Players
+}
+
+// Interceptors returns the client interceptors.
+func (c *PlayersClient) Interceptors() []Interceptor {
+	return c.inters.Players
+}
+
+func (c *PlayersClient) mutate(ctx context.Context, m *PlayersMutation) (Value, error) {
+	switch m.Op() {
+	case OpCreate:
+		return (&PlayersCreate{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpUpdate:
+		return (&PlayersUpdate{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpUpdateOne:
+		return (&PlayersUpdateOne{config: c.config, hooks: c.Hooks(), mutation: m}).Save(ctx)
+	case OpDelete, OpDeleteOne:
+		return (&PlayersDelete{config: c.config, hooks: c.Hooks(), mutation: m}).Exec(ctx)
+	default:
+		return nil, fmt.Errorf("models: unknown Players mutation op: %q", m.Op())
+	}
+}
+
+// hooks and interceptors per client, for fast access.
+type (
+	hooks struct {
+		PlayerServices, Players []ent.Hook
+	}
+	inters struct {
+		PlayerServices, Players []ent.Interceptor
+	}
+)