import type { AsyncJsonFileLockOptions } from "../config-utils.mjs";
import type { TrialCredentialRecord } from "./trial-credential-record.mjs";

export type TrialCredentialSecureBackend = Readonly<{
  load(): Promise<string | null>;
  save(serialized: string): Promise<void>;
  delete(): Promise<boolean>;
}>;

export type TrialCredentialStoreOptions = Readonly<{
  memoraxCodeHome?: string;
  env?: Record<string, string | undefined>;
  platform?: NodeJS.Platform;
  backend?: TrialCredentialSecureBackend;
  runtime?: Record<string, unknown>;
  lockOptions?: AsyncJsonFileLockOptions;
  provisionLockOptions?: AsyncJsonFileLockOptions;
}>;

export type TrialCredentialNamespaceOptions = Readonly<{
  platform?: NodeJS.Platform;
  resolveHome?: (value: string) => string;
}>;

export type TrialCredentialStorePort = Readonly<{
  load(): Promise<TrialCredentialRecord | null>;
  createIfAbsent(
    value: unknown,
  ): Promise<Readonly<{ record: TrialCredentialRecord; created: boolean }>>;
  complete(
    value: TrialCredentialRecord,
    metadata: Readonly<{
      accountId: string;
      projectId: string;
      apiKey: string;
    }>,
  ): Promise<TrialCredentialRecord>;
  withProvisionLock<T>(
    operation: () => T | Promise<T>,
    options?: AsyncJsonFileLockOptions,
  ): Promise<T>;
}>;

export function trialCredentialNamespace(
  memoraxCodeHome: string,
  options?: TrialCredentialNamespaceOptions,
): string;

export function trialCredentialLockPath(memoraxCodeHome: string): string;
export function trialCredentialProvisionLockPath(memoraxCodeHome: string): string;

export function withTrialCredentialProvisionLock<T>(
  operation: () => T | Promise<T>,
  options?: TrialCredentialStoreOptions,
): Promise<T>;

export function createTrialCredentialStorePort(
  options?: TrialCredentialStoreOptions,
): TrialCredentialStorePort;

export function loadTrialCredentialRecord(
  options?: TrialCredentialStoreOptions,
): Promise<TrialCredentialRecord | null>;

export function createTrialCredentialRecordIfAbsent(
  value: unknown,
  options?: TrialCredentialStoreOptions,
): Promise<Readonly<{ record: TrialCredentialRecord; created: boolean }>>;

export function completeTrialCredentialRecord(
  value: TrialCredentialRecord,
  metadata: Readonly<{
    accountId: string;
    projectId: string;
    apiKey: string;
  }>,
  options?: TrialCredentialStoreOptions,
): Promise<TrialCredentialRecord>;

export function clearTrialCredentialRecord(
  options?: TrialCredentialStoreOptions,
): Promise<Readonly<{ deleted: boolean }>>;