active

type Record interface {

	// Insert adds a new record.
	//
	// Implementations *should* set an attribute to the value of the
	// unique ID of the record.
	Insert() error

	// Update modifies an existing record.
	Update() error
	// Save creates a new record if non exists, and modifies an existing record.
	//
	// If a new record is created, implementations should set an attribute to the
	// unique ID of the record.
	Save() error

	// Load should load the data from persistent storage and set the local
	// attributes accordingly.
	//
	// For this to work correctly, it may require that the local unique ID attribute
	// be manually set.
	//
	// Attribute values on the struct may be overwritten when this is executed.
	//
	// Load MUST NOT have side-effects when a load fails to find a record. It MUST
	// NOT alter the existing record if it fails to find a new record.
	//
	// This allows the following desired behavior:
	//
	// 	r := NewRecord()
	//  r.Id = someId
	// 	r.Load()
	// 	r.Save() // Creates record with someId if none was found.
	Load() error
}

type Records interface {
	// Fetch all of the records of this type.
	All() ([]interface{}, error)
	// Fetch paged records for this type.
	Paged(offset, limit int) ([]interface{}, error)
}