/* eslint-disable @typescript-eslint/no-unused-vars */
import type {
  DatafileContent,
  EnvironmentKey,
  ExistingState,
  HistoryEntry,
  Commit,
  CommitHash,
  EntityType,
} from "@featurevisor/types";

import type { Scope } from "../config";

export interface DatafileOptions {
  environment: EnvironmentKey | false;
  tag?: string;
  scope?: Scope;
  datafilesDir?: string;
}

export type FeatureEnvironmentProperty = "rules" | "force" | "expose";

export interface FeatureSourcePaths {
  baseFilePath: string;
  environmentFilePaths: Record<string, string>;
}

export abstract class Adapter {
  // entities
  abstract listEntities(entityType: EntityType): Promise<string[]>;
  abstract entityExists(entityType: EntityType, entityKey: string): Promise<boolean>;
  abstract readEntity<T>(entityType: EntityType, entityKey: string): Promise<T>;
  abstract writeEntity<T>(entityType: EntityType, entityKey: string, entity: T): Promise<T>;
  abstract deleteEntity(entityType: EntityType, entityKey: string): Promise<void>;

  // state
  abstract readState(environment: EnvironmentKey | false): Promise<ExistingState>;
  abstract writeState(
    environment: EnvironmentKey | false,
    existingState: ExistingState,
  ): Promise<void>;

  // datafile
  abstract readDatafile(options: DatafileOptions): Promise<DatafileContent>;
  abstract writeDatafile(datafileContent: DatafileContent, options: DatafileOptions): Promise<void>;

  // revision
  abstract readRevision(): Promise<string>;
  abstract writeRevision(revision: string): Promise<void>;

  // history
  abstract listHistoryEntries(entityType?: EntityType, entityKey?: string): Promise<HistoryEntry[]>;
  abstract readCommit(
    commit: CommitHash,
    entityType?: EntityType,
    entityKey?: string,
  ): Promise<Commit>;

  // feature source helpers (used by lint/history attribution)
  async getFeatureSourcePaths(_featureKey: string): Promise<FeatureSourcePaths | undefined> {
    return undefined;
  }

  async getFeaturePropertySourcePath(
    _featureKey: string,
    _property: FeatureEnvironmentProperty,
    _environment?: string,
  ): Promise<string | undefined> {
    return undefined;
  }
}