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)
	// Clears every day's calendar event id: none is on the chosen calendar.
	ClearCalendarEvents(ctx context.Context, updatedAt string) error
	// Records that Google refuses the stored grant: clears the refresh token and
	// sets last_sync_error, keeping the chosen calendar. Affects no row when
	// nothing is connected.
	ClearIntegrationsGoogleToken(ctx context.Context, arg ClearIntegrationsGoogleTokenParams) (int64, 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
	CreateShoppingGroup(ctx context.Context, arg CreateShoppingGroupParams) error
	// A new item is needed until the household marks it "have it".
	CreateShoppingItem(ctx context.Context, arg CreateShoppingItemParams) error
	// A new, untitled Supply run: the title is written later, by the AI.
	CreateShoppingList(ctx context.Context, arg CreateShoppingListParams) 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)
	DeleteIntegrationsGoogle(ctx context.Context) error
	DeleteRecipeIngredients(ctx context.Context, recipeID string) error
	DeleteRecipeSteps(ctx context.Context, recipeID string) error
	DeleteShoppingGroup(ctx context.Context, id string) error
	DeleteShoppingItem(ctx context.Context, id 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)
	// Freezes list id into the Supply archive at frozen_at, unless it is
	// frozen already.
	FreezeShoppingList(ctx context.Context, arg FreezeShoppingListParams) (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)
	// The reason of each suggestion of dinner_id that can have created it,
	// none for a dinner no suggestion created. A suggestion is only ever
	// created with a new dinner, and declining one archives its dinner, so a
	// live dinner's creating suggestion is pending (the dinner still
	// suggested) or accepted; a declined one did not create it. More than one
	// row means nothing records which did.
	GetDinnerSuggestionReasons(ctx context.Context, dinnerID string) ([]string, 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)
	// The Supply run holding item id. Returns sql.ErrNoRows when there is no
	// such item.
	GetShoppingItemList(ctx context.Context, id string) (GetShoppingItemListRow, error)
	// The Supply run of the week starting week_start. Returns sql.ErrNoRows
	// when there is none.
	GetShoppingList(ctx context.Context, weekStart string) (ShoppingList, 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 groups of list list_id with their dinner's name, in list order.
	ListShoppingGroupDinners(ctx context.Context, listID string) ([]ListShoppingGroupDinnersRow, error)
	// The groups of list list_id, in list order.
	ListShoppingGroups(ctx context.Context, listID string) ([]ShoppingGroup, error)
	// The items of list list_id with their group's dinner, in list order: by
	// group, then by item.
	ListShoppingItems(ctx context.Context, listID string) ([]ListShoppingItemsRow, error)
	// The Supply runs of the weeks starting on or before week_start, newest
	// week first.
	ListShoppingListsThrough(ctx context.Context, weekStart string) ([]ShoppingList, 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)
	// Records that Calendar no longer shows the days with a calendar event id
	// as planned, since another calendar or none is chosen: every plan with
	// such a day is edited as MarkWeekPlanEdited does, so a synced plan becomes
	// changed and a push that read it before is refused.
	MarkCalendarPlansEdited(ctx context.Context, updatedAt string) 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
	// Records a Push to Calendar of plan id as it was at revision: the plan
	// becomes synced. A plan edited since (another revision) is left as it is
	// (0 rows).
	MarkWeekPlanSynced(ctx context.Context, arg MarkWeekPlanSyncedParams) (int64, error)
	MoveShoppingGroup(ctx context.Context, arg MoveShoppingGroupParams) error
	// Places item id in group group_id at position with quantity qty; its
	// name and needed flag are kept.
	MoveShoppingItem(ctx context.Context, arg MoveShoppingItemParams) 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. An existing day keeps its calendar
	// event id while its dinner stays the same; a new dinner clears it, since
	// Calendar no longer shows the day as planned.
	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
	// Records a generation of list id from plan plan_id.
	RegenerateShoppingList(ctx context.Context, arg RegenerateShoppingListParams) error
	// An unknown id returns sql.ErrNoRows.
	SetDinnerFavorite(ctx context.Context, arg SetDinnerFavoriteParams) (Dinner, error)
	// Sets the chosen calendar; affects no row when nothing is connected.
	SetIntegrationsGoogleCalendar(ctx context.Context, arg SetIntegrationsGoogleCalendarParams) (int64, error)
	// Records that the event calendar_event_id on Calendar shows date of
	// plan_id as planned.
	SetPlanDayCalendarEvent(ctx context.Context, arg SetPlanDayCalendarEventParams) (int64, error)
	// Marks item id needed (1) or "have it" (0).
	SetShoppingItemNeeded(ctx context.Context, arg SetShoppingItemNeededParams) error
	// Titles list id, unless it has a title already or is frozen into the
	// Supply archive.
	SetShoppingListTitle(ctx context.Context, arg SetShoppingListTitleParams) (int64, 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, clearing its calendar
	// event id since Calendar no longer shows the day as planned; 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)