mixin

package
v1.33.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 23, 2026 License: MIT Imports: 19 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var DefaultIndex = "everything"
View Source 
var ErrorExpiredToken = errors.New("This token is expired")

Error for expired jti's

View Source 
var TokenNotFound = errors.New("Token not found")
View Source 
var TokenNotFoundByName = errors.New("Token not found by name")

Functions

func SetSearchIndex 

func SetSearchIndex(index SearchIndex)

SetSearchIndex sets the search index implementation to use

Types

type AccessTokens 

type AccessTokens struct {
	// Entity is a struct with a Entity mixin
	Entity Entity `json:"-" datastore:"-"`

	// JWT secret (persisted for token verification)
	SecretKey []byte `json:"secretKey,omitempty"`

	// UseTokenId as JWT "jti" param, randomly generate upon generating a new key to expire all existing keys
	Tokens []accesstoken.AccessToken `json:"tokens,omitempty"`
}

AccessTokens is a mixin for securing objects with an AccessTokens

func (*AccessTokens) AddToken 

func (at *AccessTokens) AddToken(name string, permissions bit.Mask) string

func (*AccessTokens) ClearTokens 

func (at *AccessTokens) ClearTokens()

func (*AccessTokens) CompareToken 

func (at *AccessTokens) CompareToken(tok1, tok2 *accesstoken.AccessToken) error

func (*AccessTokens) GetToken 

func (at *AccessTokens) GetToken(accessToken string) (*accesstoken.AccessToken, error)

func (*AccessTokens) GetTokenByName 

func (at *AccessTokens) GetTokenByName(name string) (*accesstoken.AccessToken, error)

func (*AccessTokens) GetWithAccessToken 

func (at *AccessTokens) GetWithAccessToken(accessToken string) (*accesstoken.AccessToken, error)

func (*AccessTokens) Init 

func (at *AccessTokens) Init(e Entity)

func (*AccessTokens) MustGetTokenByName 

func (at *AccessTokens) MustGetTokenByName(name string) *accesstoken.AccessToken

func (*AccessTokens) RemoveToken 

func (at *AccessTokens) RemoveToken(name string)

type AfterCreate 

type AfterCreate interface {
	AfterCreate() error
}

type AfterDelete 

type AfterDelete interface {
	AfterDelete() error
}

type AfterUpdate 

type AfterUpdate interface {
	AfterUpdate(Entity) error
}

type BeforeCreate 

type BeforeCreate interface {
	BeforeCreate() error
}

type BeforeDelete 

type BeforeDelete interface {
	BeforeDelete() error
}

type BeforeUpdate 

type BeforeUpdate interface {
	BeforeUpdate(Entity) error
}

These last two interfaces are largely ignored -- we use helper below to have nicely typed update hooks in models.

type Defaults 

type Defaults interface {
	Defaults()
}

type Document 

type Document interface {
	Id() string
}

Document represents a searchable document

type DocumentSaveLoad 

type DocumentSaveLoad struct {

	// Dummy field for gob, see: https://github.com/golang/go/issues/5819
	Dummy string `json:"-" datastore:"-"`
	// contains filtered or unexported fields
}

func (*DocumentSaveLoad) GetDocument 

func (s *DocumentSaveLoad) GetDocument() reflect.Value

func (*DocumentSaveLoad) Load 

func (s *DocumentSaveLoad) Load(fields []SearchField, meta *SearchDocumentMetadata) error

func (DocumentSaveLoad) Save 

func (s DocumentSaveLoad) Save() ([]SearchField, *SearchDocumentMetadata, error)

func (*DocumentSaveLoad) SetDocument 

func (s *DocumentSaveLoad) SetDocument(doc interface{})

type Entity 

type Entity interface {
	// TODO: Should not be embedded in Entity I don't think
	Kind

	// By convention where model is wired to entity
	Init(db *datastore.Datastore)

	// Get, Set context/namespace
	Context() context.Context
	SetContext(ctx context.Context)
	SetNamespace(namespace string)
	Namespace() string

	// Get, Set keys
	Key() (key datastore.Key)
	SetKey(key interface{}) error
	NewKey() datastore.Key
	Id() string

	// Various existential helpers
	Exists() (bool, error)
	IdExists(id string) (datastore.Key, bool, error)
	KeyExists(key datastore.Key) (bool, error)

	// Get, Put, Delete + Create, Update
	Get(key datastore.Key) error
	GetById(id string) error
	Put() error
	Create() error
	Update() error
	Delete() error

	// Must variants
	MustSetKey(key interface{})
	MustCreate()
	MustDelete()
	MustGet(key datastore.Key)
	MustGetById(id string)
	MustPut()
	MustUpdate()

	// Document
	PutDocument() error
	DeleteDocument() error

	// Get or Create, Update helpers
	GetOrCreate(filterStr string, value interface{}) error
	GetOrUpdate(filterStr string, value interface{}) error

	// Datastore
	Datastore() *datastore.Datastore
	RunInTransaction(fn func() error, opts *datastore.TransactionOptions) error

	// Query
	Query() *ModelQuery

	// Various helpers
	Zero() Entity
	Clone() Entity
	CloneFromJSON() Entity
	Slice() interface{}
	JSON() []byte
	JSONString() string
}

A specific datastore entity, with methods inherited from this mixin

type ErrFacetMismatch 

type ErrFacetMismatch struct {
	StructType reflect.Type
	FacetName  string
	Reason     string
}

ErrFacetMismatch is returned when a facet is to be loaded into a different type than the one it was stored from, or when a field is missing or unexported in the destination struct. StructType is the type of the struct pointed to by the destination argument passed to Iterator.Next.

func (*ErrFacetMismatch) Error 

func (e *ErrFacetMismatch) Error() string

type ErrFieldMismatch 

type ErrFieldMismatch struct {
	FieldName string
	Reason    string
}

ErrFieldMismatch is returned when a field is to be loaded into a different than the one it was stored from, or when a field is missing or unexported in the destination struct.

func (*ErrFieldMismatch) Error 

func (e *ErrFieldMismatch) Error() string

type ErrorMessage 

type ErrorMessage struct {
	ErrorCode    string
	ErrorMessage string
}

type JsonResponse 

type JsonResponse struct {
	Meta struct {
		RetrievedAt   string
		ExecutionTime int64
		CallsUsed     int64
	}

	Errors []ErrorMessage
}

type Kind 

type Kind interface {
	Kind() string
}

A datastore kind that is compatible with the Model mixin

type Model 

type Model struct {
	Db     *datastore.Datastore `json:"-" datastore:"-"`
	Entity Kind                 `json:"-" datastore:"-"`
	Parent datastore.Key        `json:"-" datastore:"-"`
	Mock   bool                 `json:"-" datastore:"-"`

	// Set by our mixin
	Id_       string    `json:"id,omitempty"`
	Loaded_   bool      `json:"-" datastore:"-"`
	CreatedAt time.Time `json:"createdAt,omitempty"`
	UpdatedAt time.Time `json:"updatedAt,omitempty"`
	Deleted   bool      `json:"deleted,omitempty"`

	// Flag used to specify that we're using a string key for this kind
	UseStringKey bool `json:"-" datastore:"-"`
	// contains filtered or unexported fields
}

Model is a mixin which adds Datastore/Validation/Serialization methods to any Kind that it has been embedded in.

func (*Model) Clone 

func (m *Model) Clone() Entity

Create a clone of current entity

func (*Model) CloneFromJSON 

func (m *Model) CloneFromJSON() Entity

Create a clone of currenty entity using only JSON-serializable data

func (*Model) Context 

func (m *Model) Context() context.Context

Get context.Context

func (*Model) Create 

func (m *Model) Create() error

Create new entity (should not exist yet)

func (*Model) Created 

func (m *Model) Created() bool

Check if we have a previously created entity

func (*Model) Datastore 

func (m *Model) Datastore() *datastore.Datastore

Return datastore

func (*Model) Delete 

func (m *Model) Delete() error

Delete entity from Datastore

func (Model) DeleteDocument 

func (m Model) DeleteDocument() error

func (*Model) Exists 

func (m *Model) Exists() (bool, error)

Check if entity is in datastore.

func (*Model) Get 

func (m *Model) Get(key datastore.Key) error

Get entity from datastore

func (*Model) GetById 

func (m *Model) GetById(id string) error

Helper that will retrieve entity by id (which may be an encoded key/slug/sku)

func (*Model) GetOrCreate 

func (m *Model) GetOrCreate(filterStr string, value interface{}) error

Get entity from datastore or create new one

func (*Model) GetOrUpdate 

func (m *Model) GetOrUpdate(filterStr string, value interface{}) error

Get entity from datastore or create new one

func (*Model) Id 

func (m *Model) Id() string

Returns ID for model

func (*Model) IdExists 

func (m *Model) IdExists(id string) (datastore.Key, bool, error)

Check if entity is in datastore.

func (*Model) Init 

func (m *Model) Init(db *datastore.Datastore, entity Kind)

Wire up model

func (*Model) JSON 

func (m *Model) JSON() []byte

Serialize entity to JSON

func (*Model) JSONString 

func (m *Model) JSONString() string

func (*Model) Key 

func (m *Model) Key() (key datastore.Key)

Returns Key for this entity

func (*Model) KeyExists 

func (m *Model) KeyExists(key datastore.Key) (bool, error)

Check if entity is in datastore.

func (Model) Kind 

func (m Model) Kind() string

Return Kind

func (*Model) Loaded 

func (m *Model) Loaded() bool

Helper to prevent duplicate deserialization

func (*Model) MustCreate 

func (m *Model) MustCreate()

Create or panic

func (*Model) MustDelete 

func (m *Model) MustDelete()

Delete or panic

func (*Model) MustGet 

func (m *Model) MustGet(key datastore.Key)

Get or panic

func (*Model) MustGetById 

func (m *Model) MustGetById(id string)

Get by id or panic

func (*Model) MustPut 

func (m *Model) MustPut()

Put or panic

func (*Model) MustSetKey 

func (m *Model) MustSetKey(key interface{})

Set key or panic

func (*Model) MustUpdate 

func (m *Model) MustUpdate()

Update or panic

func (*Model) Namespace 

func (m *Model) Namespace() string

Returns namespace for this model

func (*Model) NewKey 

func (m *Model) NewKey() datastore.Key

Create a new key for this object

func (*Model) Put 

func (m *Model) Put() error

Put entity in datastore

func (Model) PutDocument 

func (m Model) PutDocument() error

func (*Model) Query 

func (m *Model) Query() *ModelQuery

Return a query for this entity kind

func (*Model) RunInTransaction 

func (m *Model) RunInTransaction(fn func() error, opts *datastore.TransactionOptions) error

Run in transaction using model's current context

func (*Model) SetContext 

func (m *Model) SetContext(ctx context.Context)

Set context.Context

func (*Model) SetEntity 

func (m *Model) SetEntity(entity interface{})

Set entity on mixin so it can be referenced later

func (*Model) SetKey 

func (m *Model) SetKey(key interface{}) (err error)

Set's key for entity.

func (*Model) SetNamespace 

func (m *Model) SetNamespace(namespace string)

Set context.Context namespace

func (*Model) Slice 

func (m *Model) Slice() interface{}

Create a slice of entity type suitable for use with datastore.GetAll, etc.

func (*Model) Update 

func (m *Model) Update() error

Update new entity (should already exist)

func (*Model) Zero 

func (m *Model) Zero() Entity

Create a new zero'd entity of this type

type ModelQuery 

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

This is a simple Query helper for individual models. Allows you to query for a single entity or key only as a convenience on an individual model.

func (*ModelQuery) All 

func (q *ModelQuery) All() datastore.Query

func (*ModelQuery) Ancestor 

func (q *ModelQuery) Ancestor(key datastore.Key) *ModelQuery

func (*ModelQuery) ById 

func (q *ModelQuery) ById(id string) (bool, error)

Filter By Id

func (*ModelQuery) ByKey 

func (q *ModelQuery) ByKey(key interface{}) (bool, error)

Filter by key

func (*ModelQuery) Filter 

func (q *ModelQuery) Filter(filterStr string, value interface{}) *ModelQuery

func (*ModelQuery) Get 

func (q *ModelQuery) Get() (bool, error)

Get entity

func (*ModelQuery) GetKey 

func (q *ModelQuery) GetKey() (bool, error)

Get just key

func (*ModelQuery) IdExists 

func (q *ModelQuery) IdExists(id string) (datastore.Key, bool, error)

Check if id exists

func (*ModelQuery) KeyExists 

func (q *ModelQuery) KeyExists(key datastore.Key) (bool, error)

Check if key exists

func (*ModelQuery) Limit 

func (q *ModelQuery) Limit(limit int) *ModelQuery

func (*ModelQuery) MustGet 

func (q *ModelQuery) MustGet()

func (*ModelQuery) MustGetKey 

func (q *ModelQuery) MustGetKey()

func (*ModelQuery) Offset 

func (q *ModelQuery) Offset(offset int) *ModelQuery

func (*ModelQuery) Order 

func (q *ModelQuery) Order(order string) *ModelQuery

type Salesforce 

type Salesforce struct {
	PrimarySalesforceId_   string    `json:"-"`
	SecondarySalesforceId_ string    `json:"-"`
	ExternalId_            string    `json:"-"`
	LastSync_              time.Time `json:"-"`
}

func (*Salesforce) ExternalId 

func (so *Salesforce) ExternalId() string

func (*Salesforce) LastSync 

func (so *Salesforce) LastSync() time.Time

func (*Salesforce) SalesforceId 

func (so *Salesforce) SalesforceId() string

func (*Salesforce) SalesforceId2 

func (so *Salesforce) SalesforceId2() string

func (*Salesforce) SetExternalId 

func (so *Salesforce) SetExternalId(id string)

func (*Salesforce) SetLastSync 

func (so *Salesforce) SetLastSync()

func (*Salesforce) SetSalesforceId 

func (so *Salesforce) SetSalesforceId(id string)

func (*Salesforce) SetSalesforceId2 

func (so *Salesforce) SetSalesforceId2(id string)

type SearchDocumentMetadata 

type SearchDocumentMetadata struct {
	Facets []SearchFacet
}

SearchDocumentMetadata holds metadata for a search document

type SearchFacet 

type SearchFacet struct {
	Name  string
	Value interface{}
}

SearchFacet represents a facet in a search document

type SearchField 

type SearchField struct {
	Name  string
	Value interface{}
}

SearchField represents a field in a search document

type SearchIndex 

type SearchIndex interface {
	Put(ctx context.Context, id string, doc interface{}) error
	Delete(ctx context.Context, id string) error
}

SearchIndex provides an interface for search operations This allows pluggable search backends (Elasticsearch, Meilisearch, etc.)

func GetSearchIndex 

func GetSearchIndex() SearchIndex

GetSearchIndex returns the current search index, or nil if not set

type Searchable 

type Searchable interface {
	Document() Document
}

Searchable is implemented by models that can be indexed for search

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.