Returns a specification to start this module under a supervisor.

See Supervisor.

@spec clear() :: :ok

Clears all setup_attempts from the store (all namespaces).

Serialized write - goes through GenServer.

Useful for test cleanup. Note: This clears ALL data, not just the current namespace. For namespace-specific cleanup, use clear_namespace/1.

@spec clear_namespace(pid() | :global | {pid() | :global, String.t()}) :: :ok

Clears all setup_attempts for a specific namespace.

Used by PaperTiger.Test to clean up after each test.

@spec count() :: non_neg_integer()

Counts total setup_attempts in current namespace.

Direct ETS access - does not go through GenServer.

@spec delete(String.t()) :: :ok

Deletes a setup_attempt from the store.

Serialized write - goes through GenServer. Data is scoped to the current test namespace.

@spec find_by_setup_intent(String.t() | nil) :: [map()]

Finds setup attempts associated with a SetupIntent ID.

Direct ETS access - does not go through GenServer.

@spec get(String.t()) :: {:ok, map()} | {:error, :not_found}

Retrieves a setup_attempt by ID.

Direct ETS access - does not go through GenServer. Data is scoped to the current test namespace.

@spec insert(map()) :: {:ok, map()}

Inserts a setup_attempt into the store.

Serialized write - goes through GenServer to prevent race conditions. Data is scoped to the current test namespace.

@spec list(keyword() | map()) :: PaperTiger.List.t()

Lists all setup_attempts with optional pagination.

Direct ETS access - does not go through GenServer. Data is scoped to the current test namespace.

Options

• :limit - Number of items (default: 10, max: 100)
• :starting_after - Cursor for pagination
• :ending_before - Reverse cursor

@spec list_namespace(pid() | :global | {pid() | :global, String.t()}) :: [map()]

Returns all items in a specific namespace.

Useful for debugging test isolation.

@spec prefix() :: String.t() | nil

Returns the ID prefix for this resource.

@spec start_link(keyword()) :: GenServer.on_start()

Starts the setup_attempt store GenServer.

@spec table_name() :: atom()

Returns the ETS table name for this store.

@spec update(map()) :: {:ok, map()}

Updates a setup_attempt in the store.

Serialized write - goes through GenServer. Data is scoped to the current test namespace.