import type {
	Artifact,
	ArtifactEdge,
	ArtifactGraphOptions,
	ArtifactLink,
	ArtifactQuery,
	CreateArtifactInput,
	RelationshipQuery,
	UpdateArtifactInput,
} from "./artifact.ts";
import type { ArtifactEventContext } from "./artifact-event.ts";

/** Core CRUD/graph operations every domain-service module needs. Trash lifecycle and event-log
 * reading are separate ports (ArtifactTrashStore, ArtifactEventReader) -- only the composition
 * root (daemon.ts, service.ts) needs those, not every consumer of this store. */
export interface ArtifactStore {
	create(input: CreateArtifactInput, context?: ArtifactEventContext): Artifact;
	get(id: string, options?: ArtifactGraphOptions): Artifact | null;
	/** Exact, globally-unique lookup by alias (domain/artifact-alias.ts) -- unlike title, never ambiguous, never scoped. */
	getByAlias(alias: string): Artifact | null;
	query(filter: ArtifactQuery): Artifact[];
	link(link: ArtifactLink, context?: ArtifactEventContext): void;
	/** Idempotent: removing an already-absent relationship is a no-op that returns false, not an error. */
	unlink(link: ArtifactLink, context?: ArtifactEventContext): boolean;
	setStatus(id: string, status: string, context?: ArtifactEventContext): Artifact | null;
	setExtra(id: string, extra: Record<string, unknown>, context?: ArtifactEventContext): Artifact | null;
	updateContent(id: string, input: UpdateArtifactInput, context?: ArtifactEventContext): Artifact | null;
	relationships(filter?: RelationshipQuery): ArtifactEdge[];
}