Skip to main content

Module event_discovery

Module event_discovery 

Source
Expand description

Evidence-backed event ingestion for apps declaring an event-discovery contract. Public sources are fetched only by the background worker, through the bounded transport.

ModulesΒ§

calendar_feed πŸ”’
Bounded iCalendar intake for explicit UTC, non-recurring performance events. Unsupported calendar semantics fail visibly rather than inventing a time zone or recurrence.
model πŸ”’
Bounded event identity, location and existing-record comparisons for the discovery consumer.
social_announcements πŸ”’
Extracts bounded date-only performances from attributed public artist announcements without inventing time or venue.
social_evidence πŸ”’
Social candidate screening keeps announcement age separate from the performance window.

StructsΒ§

DiscoveredEvent πŸ”’
Verified event facts or an attributed public day-only announcement; unrelated feed prose is excluded.
ReviewCandidate πŸ”’
Retains inert source facts with a host-authored reason for private owner review.
SocialIntake πŸ”’
Separates validated public-source work from social evidence requiring explicit publication review.

EnumsΒ§

SourceReadError πŸ”’
Distinguishes a source policy refusal from a bounded transport failure in owner feedback.

ConstantsΒ§

PROFILE_FIELDS πŸ”’
SOURCE_CHECK_INTERVAL_SECONDS πŸ”’

FunctionsΒ§

accept_social_links πŸ”’
Commits a retained social link batch under source, artist and connection authority guards.
collect_events πŸ”’
Traverses only bounded JSON-LD graphs; arbitrary nested documents are not crawled.
commit_event_groups πŸ”’
Commits independent event groups below the shared transaction budget, retaining the lease until completion.
declared_site_allows πŸ”’
Treats social hosts as profile scopes even when pasted into a website field.
eligible_source πŸ”’
Limits discovery to explicitly declared artist/social/organizer sites, excluding catalog provenance and link hubs.
event_from_value πŸ”’
Extracts one complete event, requiring an explicit time zone, performer and venue.
extract_events_with_review πŸ”’
Retains bounded incomplete structured evidence privately; only validated facts become public events.
fetch πŸ”’
Fetches one public HTTPS document with bounded response bytes and no redirects.
literals πŸ”’
Builds literal values for parameterized generic database mutations.
normalized_name πŸ”’
Matches performer names without guessing identities from partial substrings.
organizer_sites πŸ”’
Loads bounded active organizer sites; storage/capacity failures never retire sources or widen authority.
password_gate πŸ”’
Recognizes common soft-login documents only when no usable event evidence was extracted.
pending_review_evidence πŸ”’
Deduplicates private evidence using bounded batches matching the shared predicate budget.
performer_matches πŸ”’
Collects performer names from the bounded JSON-LD value.
preview_registry πŸ”’
Keeps bounded accepted preview runtimes available to the shared background worker.
process_one_source πŸ”’
Claims at most one due source per poll and records actual fetch/acceptance outcomes.
process_registered_previews πŸ”’
Processes one registered preview per poll with bounded round-robin scheduling.
process_store_source_with_app πŸ”’
Shares durable source acceptance between public-page tests and authorized native consumers.
prune_social_reviews πŸ”’
Removes stale or unattributed social review material without changing accepted gigs or owner decisions.
public_link πŸ”’
Accepts bounded HTTPS links without credentials, controls or executable schemes.
query πŸ”’
Reads one declared source entity without backend-specific persistence.
queue_social_links πŸ”’
Converts authorized post links into public-page work, never interpreting social prose as event facts.
register_preview πŸ”’
Registers an explicitly enabled discovery contract in its existing isolated preview namespace.
requires_social_authorization πŸ”’
Identifies providers that require an authorized connector instead of a public-page fetch.
robots_allowed πŸ”’
Applies conservative public robots rules before reading an explicitly configured page. Redirects or unavailable policies fail closed; a missing robots document permits access.
robots_body_allows πŸ”’
Evaluates bounded literal robots rules; unsupported encoded or wildcard policies fail closed. This intentionally supports a narrower public-source policy than a general web crawler.
same_site πŸ”’
Compares declared site origins while tolerating only the conventional www alias.
social_connection_available πŸ”’
Requeues authorization-blocked sources after an accepted connection, retaining source and connection race guards.
social_review_candidates πŸ”’
Keeps only bounded event declarations from inert social evidence; graph metadata and unrelated posts are excluded.
start_worker πŸ”’
Starts a managed discovery poller so external sources cannot delay ordinary queued jobs.
synchronize_one_artist πŸ”’
Synchronizes one artist’s profile links using a durable scan cursor and bounded writes. Existing sources retain an owner’s pause state; catalog row identities are resolved from storage.

Type AliasesΒ§

PreviewRegistry πŸ”’