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)
	// Records a send of list id to Google Chat begun at
	// chat_send_unconfirmed_at, before it is posted, unless the list is frozen
	// into the Supply archive.
	BeginShoppingListChatSend(ctx context.Context, arg BeginShoppingListChatSendParams) (int64, error)
	// Leases the pending notification due longest ago by moving its
	// next_attempt_at to lease_until, and returns it. A claimed row is not due
	// again until the lease ends, so no other claim takes it while it is being
	// delivered. Returns sql.ErrNoRows when none is due.
	ClaimDueNotification(ctx context.Context, arg ClaimDueNotificationParams) (NotificationOutbox, 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)
	// Claims one period of a schedule. The insert is the claim: 1 row means
	// this caller owns the period, 0 rows means it was already claimed.
	ClaimScheduleRun(ctx context.Context, arg ClaimScheduleRunParams) (int64, 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)
	// Clears the send of list id begun, once Google Chat refused it.
	ClearShoppingListChatSend(ctx context.Context, arg ClearShoppingListChatSendParams) (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
	DeletePushSubscription(ctx context.Context, endpoint string) (int64, error)
	// Removes a subscription the push service reports gone (404 or 410).
	DeletePushSubscriptionByID(ctx context.Context, id string) 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)
	// Gives up on a notification. attempts counts the delivery attempt that
	// failed, if one was made. The lease must still be the claim's.
	FailNotification(ctx context.Context, arg FailNotificationParams) (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)
	GetNotificationPref(ctx context.Context, event string) (NotificationPref, 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)
	// Batch id. Returns sql.ErrNoRows when there is none.
	GetSuggestionBatch(ctx context.Context, id string) (SuggestionBatch, 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)
	// Reports whether a notification was stored after since, or at all when
	// since is NULL.
	HasNotificationSince(ctx context.Context, since sql.NullString) (bool, error)
	// Stores a pending notification for one channel, due at once. A row already
	// stored for the event key and channel, in any status, is left unchanged and
	// no row is inserted.
	InsertNotification(ctx context.Context, arg InsertNotificationParams) (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)
	ListNotificationPrefs(ctx context.Context) ([]NotificationPref, 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)
	// Every stored subscription with its keys, for the push sender, oldest
	// first.
	ListPushSubscriptions(ctx context.Context) ([]ListPushSubscriptionsRow, error)
	// Returns the last lim distinct events stored, newest first: one row per
	// event key, the last stored for it whatever its channel, so an event
	// stored for push and Google Chat is one row. The last, because a channel
	// switched on later can store the same event key again, and
	// HasNotificationSince counts that row: an event is as new as its newest
	// row, so marking it seen also covers that row.
	ListRecentNotifications(ctx context.Context, lim int64) ([]ListRecentNotificationsRow, 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 a delivered notification; updated_at is when it was sent. The
	// lease must still be the claim's.
	MarkNotificationSent(ctx context.Context, arg MarkNotificationSentParams) (int64, error)
	// Records list id sent to Google Chat at sent_to_chat_at, its send
	// confirmed, unless it is frozen into the Supply archive.
	MarkShoppingListSentToChat(ctx context.Context, arg MarkShoppingListSentToChatParams) (int64, error)
	// Moves updates_seen_at forward to seen_at; affects no row when it is
	// already at or after seen_at, so it never moves back. It is not a settings
	// edit: updated_by and updated_at are left as they are.
	MarkUpdatesSeen(ctx context.Context, seenAt string) (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)
	// Returns when the next pending notification is due. Returns sql.ErrNoRows
	// when none is pending.
	NextNotificationDue(ctx context.Context) (sql.NullString, 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 the outcome of a test message sent to the webhook sealed in
	// webhook_url_ct; affects no row when the webhook has been replaced or
	// removed since the test began.
	RecordChatTest(ctx context.Context, arg RecordChatTestParams) (int64, error)
	// Counts a delivery to a subscription that the push service did not accept.
	RecordPushFailure(ctx context.Context, id string) error
	// Records that the push service accepted a notification for a subscription.
	RecordPushSuccess(ctx context.Context, arg RecordPushSuccessParams) 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
	// Records a failed delivery and when to try again. The lease must still be
	// the claim's.
	RetryNotification(ctx context.Context, arg RetryNotificationParams) (int64, 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)
	// Sets which channels an event goes to; affects no row when the event has
	// no preference row.
	UpdateNotificationPref(ctx context.Context, arg UpdateNotificationPrefParams) (int64, 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)
	// Stores a browser's push subscription, keyed by its endpoint. Subscribing
	// an endpoint already stored replaces its keys and user agent and clears
	// its failure count, keeping its id, created_at and last_success_at.
	UpsertPushSubscription(ctx context.Context, arg UpsertPushSubscriptionParams) (PushSubscription, 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)