MealQuest/internal/db/querier.go

// Code generated by sqlc. DO NOT EDIT.
// versions:
//   sqlc v1.31.1

package db

import (
	"context"
	"database/sql"
)

type Querier interface {
	// An unknown id returns sql.ErrNoRows.
	ArchiveDinner(ctx context.Context, arg ArchiveDinnerParams) (Dinner, error)
	// Marks the oldest queued job running and returns it. Returns sql.ErrNoRows
	// when no job is queued.
	ClaimNextJob(ctx context.Context, now sql.NullString) (Job, error)
	// Drops references to the runs created before the cutoff, so the purge
	// can delete them.
	ClearSuggestionBatchAIRunsBefore(ctx context.Context, cutoff string) (int64, error)
	// Drops references to the runs created before the cutoff, so the purge
	// can delete them.
	ClearWeekPlanAIRunsBefore(ctx context.Context, cutoff string) (int64, error)
	// How many suggestions ListDeck returns.
	CountDeck(ctx context.Context) (int64, error)
	// How many Regulars the household has; archived dinners are not counted.
	CountRegularDinners(ctx context.Context) (int64, error)
	// How many Rotation checks dinner_id has had, pending or decided.
	CountRotationReviews(ctx context.Context, dinnerID string) (int64, error)
	CreateAIRun(ctx context.Context, arg CreateAIRunParams) error
	CreateDinner(ctx context.Context, arg CreateDinnerParams) (Dinner, error)
	CreateJob(ctx context.Context, arg CreateJobParams) error
	// A recipe the household typed in. Its source_url is a mealquest:manual:
	// URN rather than a page, so it never matches a fetched page.
	CreateManualRecipe(ctx context.Context, arg CreateManualRecipeParams) (Recipe, error)
	CreatePhoto(ctx context.Context, arg CreatePhotoParams) (Photo, error)
	CreateRecipeIngredient(ctx context.Context, arg CreateRecipeIngredientParams) error
	CreateRecipeStep(ctx context.Context, arg CreateRecipeStepParams) error
	CreateRotationReview(ctx context.Context, arg CreateRotationReviewParams) error
	// name is the name the dish is suggested under, kept whatever its dinner is
	// later renamed.
	CreateSuggestion(ctx context.Context, arg CreateSuggestionParams) error
	CreateSuggestionBatch(ctx context.Context, arg CreateSuggestionBatchParams) (SuggestionBatch, error)
	CreateWeekPlan(ctx context.Context, arg CreateWeekPlanParams) error
	// Records the household's decision on a pending Rotation check, with the
	// dinner's name for a drop and NULL otherwise; one already decided is left
	// as it is (0 rows).
	DecideRotationReview(ctx context.Context, arg DecideRotationReviewParams) (int64, error)
	// Records the household's decision on a pending suggestion; one already
	// decided is left as it is (0 rows).
	DecideSuggestion(ctx context.Context, arg DecideSuggestionParams) (int64, error)
	DeleteAIRunsBefore(ctx context.Context, cutoff string) (int64, error)
	// Deletes the row only while it still holds refresh_token_ct, so a
	// connection made after the caller read the row is kept. Returns the number
	// of rows deleted.
	DeleteIntegrationsGoogle(ctx context.Context, refreshTokenCt []byte) (int64, error)
	DeleteRecipeIngredients(ctx context.Context, recipeID string) error
	DeleteRecipeSteps(ctx context.Context, recipeID string) error
	FailJob(ctx context.Context, arg FailJobParams) (int64, error)
	// Fails every unarchived dinner still pending whose grounding job for its
	// current grounding_revision is no longer queued or running: the process
	// stopped before the job, or before its handler recorded a result. An
	// archived dinner is left as it is; archiving stopped its grounding. Run at
	// boot, after the job runner fails the jobs a previous process left running.
	FailOrphanedPendingDinnerGroundings(ctx context.Context, arg FailOrphanedPendingDinnerGroundingsParams) (int64, error)
	// Fails every batch still pending or running whose job is no longer queued
	// or running: the process stopped, or recording the batch's end failed,
	// before its handler recorded a result. Run before reading the active batch.
	FailOrphanedSuggestionBatches(ctx context.Context, arg FailOrphanedSuggestionBatchesParams) (int64, error)
	// Records why the background grounding of an unarchived dinner still
	// pending at the grounding_revision it was grounded for failed; a dinner
	// grounded some other way, renamed or archived meanwhile is left as it is
	// (0 rows).
	FailPendingDinnerGrounding(ctx context.Context, arg FailPendingDinnerGroundingParams) (int64, error)
	// Fails every job left running, at boot before any worker starts.
	FailRunningJobs(ctx context.Context, arg FailRunningJobsParams) (int64, error)
	// Records a pending or running batch as done or failed; a batch already
	// finished is left as it is (0 rows).
	FinishSuggestionBatch(ctx context.Context, arg FinishSuggestionBatchParams) (int64, error)
	// Returns sql.ErrNoRows until the row exists.
	GetAISettings(ctx context.Context) (AiSetting, error)
	// The job of kind queued or running for the week starting week_start,
	// with whether its payload has confirm. StartDraft enqueues a draft only
	// when there is none, so there is at most one. Returns sql.ErrNoRows when
	// there is none.
	GetActiveDraftJob(ctx context.Context, arg GetActiveDraftJobParams) (GetActiveDraftJobRow, error)
	// The batch still pending or running, oldest first. Returns sql.ErrNoRows
	// when there is none.
	GetActiveSuggestionBatch(ctx context.Context) (SuggestionBatch, error)
	// Returns sql.ErrNoRows until the row exists.
	GetChatSettings(ctx context.Context) (ChatSetting, error)
	GetDinner(ctx context.Context, id string) (Dinner, error)
	// Returns sql.ErrNoRows until the row exists.
	GetHouseholdSettings(ctx context.Context) (HouseholdSetting, error)
	// Returns sql.ErrNoRows until the row exists.
	GetIntegrationsGoogle(ctx context.Context) (IntegrationsGoogle, error)
	GetJob(ctx context.Context, id string) (Job, error)
	// The newest batch, whatever its status. Returns sql.ErrNoRows when there
	// is none.
	GetLatestSuggestionBatch(ctx context.Context) (SuggestionBatch, error)
	// The pending Rotation check of dinner_id. MarkTried makes one only for a
	// dinner in the Quest log, which it moves to tried, so a dinner has at
	// most one. Returns sql.ErrNoRows when there is none.
	GetPendingRotationReview(ctx context.Context, dinnerID string) (RotationReview, error)
	GetPhoto(ctx context.Context, id string) (Photo, error)
	// Finds stored image bytes by content hash. The schema does not make sha256
	// unique, so the earliest-created (lowest id) match is returned.
	GetPhotoBySHA256(ctx context.Context, sha256 string) (Photo, error)
	GetRecipe(ctx context.Context, id string) (Recipe, error)
	GetRecipeBySourceURL(ctx context.Context, sourceUrl string) (Recipe, error)
	// Returns sql.ErrNoRows until the row exists.
	GetRecipeSearchSettings(ctx context.Context) (RecipeSearchSetting, error)
	// A suggestion with its dinner. Returns sql.ErrNoRows for an unknown id.
	GetSuggestion(ctx context.Context, id string) (GetSuggestionRow, error)
	// The id of the job that runs batch batch_id.
	GetSuggestionBatchJobID(ctx context.Context, arg GetSuggestionBatchJobIDParams) (string, error)
	// The plan of the week starting week_start. Returns sql.ErrNoRows when
	// there is none.
	GetWeekPlan(ctx context.Context, weekStart string) (WeekPlan, error)
	// Records a dinner's grounding by hand (grounded or manual) and clears any
	// grounding_error and pasted recipe_url: the recipe chosen replaces the
	// link. It writes only an unarchived dinner still as it was observed
	// before grounding (same name, normalized_name, grounding_status,
	// grounding_revision and recipe_id), so a dinner renamed, archived or
	// grounded some other way meanwhile is left as it is. That dinner, or an
	// unknown id, returns sql.ErrNoRows. A method, minutes_total or difficulty
	// no longer as observed is kept: a member edited it while it was grounding.
	GroundDinner(ctx context.Context, arg GroundDinnerParams) (Dinner, error)
	// Records the background grounding of an unarchived dinner still pending at
	// the grounding_revision it was grounded for; a dinner grounded some other
	// way, renamed or archived meanwhile is left as it is (0 rows). A method,
	// minutes_total or difficulty already set is kept: a pending dinner has
	// them only when a member edited them while it was grounding. Like
	// GroundDinner it clears the pasted recipe_url: the recipe replaces the link.
	GroundPendingDinner(ctx context.Context, arg GroundPendingDinnerParams) (int64, error)
	// The pending suggestions whose dinner is still suggested, oldest first,
	// with their dinners.
	ListDeck(ctx context.Context) ([]ListDeckRow, error)
	ListDinnersByStatus(ctx context.Context, status string) ([]Dinner, error)
	// The dinners a draft of the week starting week_start may plan: every
	// Regular, and every Quest log dinner no other plan for the week starting
	// from_week_start or later has on any day.
	ListDraftPool(ctx context.Context, arg ListDraftPoolParams) ([]Dinner, error)
	// Every name the household turned down, oldest decision first: the name
	// each declined suggestion was suggested under, which renaming its dinner
	// does not change, and the name each dinner a Rotation check dropped
	// ("Not for us") had when dropped, which renaming it does not change.
	ListPassedNames(ctx context.Context) ([]string, error)
	// The pending Rotation checks whose dinner is still tried, oldest plan
	// date first, with their dinners.
	ListPendingRotationReviews(ctx context.Context) ([]ListPendingRotationReviewsRow, error)
	// The days of plan plan_id with their dinners, Monday first. A day with
	// no dinner is left out.
	ListPlanDays(ctx context.Context, planID string) ([]ListPlanDaysRow, error)
	// The planned dinners dated from from_date up to but not including
	// to_date, oldest first. Days with no dinner are left out.
	ListPlannedDinners(ctx context.Context, arg ListPlannedDinnersParams) ([]ListPlannedDinnersRow, error)
	// Reads for the AI household context block (internal/ai/harness).
	// The most recent names the household turned down, newest first, as
	// ListPassedNames has them.
	ListRecentPassedNames(ctx context.Context, limit int64) ([]string, error)
	ListRecipeIngredients(ctx context.Context, recipeID string) ([]RecipeIngredient, error)
	ListRecipeSteps(ctx context.Context, recipeID string) ([]RecipeStep, error)
	// The ids of the dinners with status quest_log planned on date, on a plan
	// of any status, that have no Rotation check for date yet.
	ListTriedCandidates(ctx context.Context, date string) ([]string, error)
	// Every dinner a new or renamed dinner must not repeat, with the
	// source_url of the recipe it is grounded in (NULL while it has none).
	ListUnarchivedDinners(ctx context.Context) ([]ListUnarchivedDinnersRow, error)
	// The Quest log: dinners with status quest_log that no plan for the week
	// starting from_week_start or later has on any day.
	ListUnplannedQuestLogDinners(ctx context.Context, fromWeekStart string) ([]Dinner, error)
	// The ids of the dinners planned in the week starting week_start, Monday
	// first.
	ListWeekPlanDinnerIDs(ctx context.Context, weekStart string) ([]sql.NullString, error)
	// Moves a dinner still in the Quest log to tried; a dinner with any other
	// status is left as it is (0 rows).
	MarkDinnerTried(ctx context.Context, arg MarkDinnerTriedParams) (int64, error)
	// Records an edit of plan id, raising its revision: a synced plan becomes
	// changed, any other keeps its status.
	MarkWeekPlanEdited(ctx context.Context, arg MarkWeekPlanEditedParams) error
	// Moves a dinner still suggested to status (quest_log or archived),
	// recording updated_by; a dinner no longer suggested is left as it is
	// (0 rows).
	MoveSuggestedDinner(ctx context.Context, arg MoveSuggestedDinnerParams) (int64, error)
	// Moves a dinner still tried to status (regular, archived or quest_log)
	// by a Rotation check decision, recording updated_by; its origin is kept.
	// A dinner no longer tried is left as it is (0 rows).
	MoveTriedDinner(ctx context.Context, arg MoveTriedDinnerParams) (int64, error)
	// Stores a partial result of a running job.
	PublishJobResult(ctx context.Context, arg PublishJobResultParams) (int64, error)
	// Plans dinner_id on date of plan_id, keeping the day's calendar event id
	// when the day exists.
	PutPlanDay(ctx context.Context, arg PutPlanDayParams) error
	// Records a new draft over plan id: its status and note, raising its
	// revision.
	RedraftWeekPlan(ctx context.Context, arg RedraftWeekPlanParams) error
	// An unknown id returns sql.ErrNoRows.
	SetDinnerFavorite(ctx context.Context, arg SetDinnerFavoriteParams) (Dinner, error)
	// Marks a pending batch running; a batch in any other status is left as
	// it is (0 rows).
	StartSuggestionBatch(ctx context.Context, arg StartSuggestionBatchParams) (int64, error)
	SucceedJob(ctx context.Context, arg SucceedJobParams) (int64, error)
	// Plans dinner_id on an existing day of plan_id; a date the plan does not
	// have is left as it is (0 rows).
	SwapPlanDay(ctx context.Context, arg SwapPlanDayParams) (int64, error)
	// An unknown id returns sql.ErrNoRows.
	ToggleDinnerFavorite(ctx context.Context, arg ToggleDinnerFavoriteParams) (Dinner, error)
	// An unknown id returns sql.ErrNoRows.
	UpdateDinner(ctx context.Context, arg UpdateDinnerParams) (Dinner, error)
	// Creates the single row (id 1) or replaces every column except id and
	// created_at.
	UpsertAISettings(ctx context.Context, arg UpsertAISettingsParams) (AiSetting, error)
	// Creates the single row (id 1) or replaces every column except id and
	// created_at.
	UpsertChatSettings(ctx context.Context, arg UpsertChatSettingsParams) (ChatSetting, error)
	// Creates the single row (id 1) or replaces every column except id and
	// created_at.
	UpsertHouseholdSettings(ctx context.Context, arg UpsertHouseholdSettingsParams) (HouseholdSetting, error)
	// Creates the single row (id 1) or replaces every column except id and
	// created_at.
	UpsertIntegrationsGoogle(ctx context.Context, arg UpsertIntegrationsGoogleParams) (IntegrationsGoogle, error)
	// A recipe is keyed by source_url: re-fetching the same URL updates the
	// existing row and keeps its id and created_at, which the returned row
	// carries. Replace its ingredients and steps in the same transaction with
	// DeleteRecipeIngredients/DeleteRecipeSteps then the Create queries.
	UpsertRecipe(ctx context.Context, arg UpsertRecipeParams) (Recipe, error)
	// Creates the single row (id 1) or replaces every column except id and
	// created_at.
	UpsertRecipeSearchSettings(ctx context.Context, arg UpsertRecipeSearchSettingsParams) (RecipeSearchSetting, error)
}

var _ Querier = (*Queries)(nil)